Sing-box is a powerful and highly customizable proxy tool that supports multiple protocols (such as Shadowsocks, VMess, and Trojan) for secure and efficient internet traffic routing. To enhance usability, many users integrate it with sing-box使用http://yacd.haishan.me a web-based dashboard originally designed for Clash but adaptable to Sing-box. This dashboard provides a visual interface for managing proxy nodes, monitoring traffic, and analyzing connection logs. In this article, we will explore how to configure Sing-box to work with YACD, discuss its key features, and provide troubleshooting tips for common issues.
1. What is YACD (http://yacd.haishan.me)?
YACD (Yet Another Clash Dashboard) is a lightweight web-based control panel primarily used for managing Clash-based proxy clients. Despite being designed for Clash, it can also work with Sing-box due to their similar API structures. The public instance at http://yacd.haishan.me allows users to connect to their Sing-box API without needing to self-host the dashboard. It offers an intuitive interface for switching proxy nodes, checking real-time traffic, and reviewing connection logs, making it a convenient tool for both beginners and advanced users.
2. Configuring Sing-box for YACD Compatibility
To enable YACD to interact with Sing-box, you must configure Sing-box to expose its API. This involves modifying the configuration file to include an external controller setting. Follow these steps:
-
Edit the Sing-box Configuration File: Open your
config.json
file and ensure theexperimental
section includes theexternal_controller
parameter. For example:{ "experimental": { "external_controller": "127.0.0.1:9090" } }
Here,
9090
is the default port, but you can customize it if needed. -
Restart Sing-box: After saving the changes, restart Sing-box to apply the new settings.
-
Connect YACD to Sing-box: Open http://yacd.haishan.me in your browser, enter
http://127.0.0.1:9090
(or your custom API address) in the dashboard’s connection field, and click “Connect.” If successful, YACD will display your proxy nodes and traffic data. -
Security Considerations: If Sing-box runs on a remote server, restrict API access via a firewall or authentication to prevent unauthorized usage.
3. Key Features of YACD for Sing-box Management
YACD provides several useful functionalities for managing Sing-box:
-
Node Selection & Latency Testing: Under the “Proxies” tab, you can manually switch between proxy nodes and test their response times using TCP ping.
-
Real-Time Traffic Monitoring: The dashboard displays upload and download speeds, helping you track bandwidth consumption.
-
Connection Logs: The “Connections” section lists active connections, including their destinations, which is useful for debugging.
-
Rule Management: Users can inspect and temporarily modify routing rules (e.g., direct, proxy, or block) for troubleshooting.
For advanced users, Sing-box’s API allows further customization, such as adjusting logging levels or enabling traffic shaping.
4. Troubleshooting Common Issues
While YACD generally works well with Sing-box, you might encounter the following problems:
-
Connection Failures: Ensure the
external_controller
address is correct and Sing-box is running. Check firewall rules if using a remote server. -
Missing Proxy Nodes: Verify that your Sing-box config contains valid proxy definitions and that the API is accessible.
-
No Traffic Updates: Some Sing-box versions require enabling traffic statistics explicitly in the configuration.
If issues persist, consult Sing-box’s official documentation or community forums for updates.
5. Alternatives to Public YACD Instances
If http://yacd.haishan.me is unavailable or you prefer a private solution, consider these alternatives:
-
Self-Hosting YACD: Deploy your own instance using the YACD GitHub repository and a static web hosting service.
-
Sing-box-Specific Dashboards: Projects like sing-box-webui offer dedicated interfaces for Sing-box with deeper integration.
-
Command-Line Tools: Advanced users can rely on Sing-box’s built-in CLI and logs for monitoring (
log-level: debug
).
Conclusion
Integrating http://yacd.haishan.me with Sing-box provides a user-friendly way to manage proxy connections without complex commands. By configuring the external_controller
API and ensuring proper network access, users can leverage YACD’s features for node switching, traffic analysis, and debugging. For enhanced privacy or reliability, self-hosting YACD or exploring Sing-box-specific dashboards are viable options. As Sing-box evolves, expect more tailored management tools to emerge, further simplifying proxy administration.