Skip to content

sing-box: Understand the Core Before Choosing a Client ​

sing-box is primarily a proxy platform and core, not one single graphical app. It handles inbound and outbound connections, protocol settings and routing rules. Several graphical clients use it underneath, so the controls you see depend on the app built around the core.

Official resources ​

If you want an app with buttons and profile management, start from the official client list. If you plan to use sing-box directly, read the documentation for the configuration format and the version you install.

The terms that matter ​

  • Inbound: how traffic enters sing-box, such as from a local listener or a TUN interface.
  • Outbound: where the traffic goes next, such as a direct connection or a proxy endpoint.
  • Route rules: conditions used to decide which outbound handles a request.
  • DNS configuration: how names are resolved and how DNS requests follow the routing policy.

These parts affect each other. A valid outbound does not guarantee that a route selects it, and a route can look correct while DNS is handled somewhere else.

A safe starting point ​

Begin with a known-good example for your installed version. Validate the configuration before using it, keep a copy of the last working file and change one section at a time. Avoid copying a configuration written for a much older release without checking the current documentation.

Troubleshooting the layers ​

If no traffic is accepted, check the inbound. If traffic enters but cannot reach its destination, examine the outbound and its credentials. If only certain domains take the wrong path, inspect routing rules and DNS. This order is usually quicker than changing every section at once.

Is this the right choice? ​

Direct configuration gives experienced users control, but it also asks them to understand more networking concepts. A graphical client based on sing-box may be easier for everyday subscription use. See the client center, DNS guide and routing guide.

VPN Finder · VPN, proxy and network tool guides