This article addresses the practical question of “how to import nodes into sing-box“: after obtaining free nodes, a subscription link, or a single share link, how do you import them into a sing-box client, and when access fails, how do you quickly troubleshoot from three angles: IP, DNS, and browser environment.
1. First, confirm what you have before importing
sing-box itself is the core program. Client interfaces on different platforms may vary slightly—for example, graphical clients on Android, Windows, and macOS may use different names—but the import logic is basically the same. You first need to determine which type of content you have:
- Subscription link: usually starts with https:// and can automatically update multiple nodes after import.
- Single node link: commonly vless://, vmess://, trojan://, ss://, etc.
- JSON configuration: a complete sing-box configuration file, suitable for experienced users.
The free nodes provided on this site will generally include subscription or node links that can be copied directly. Ordinary users should prioritize the subscription method, since it makes later updates easier.
2. General steps for importing nodes into sing-box
- Install a client that supports sing-box, then open the app.
- Find an entry such as “Configuration,” “Profile,” “Subscription,” or “Import.” The name may differ depending on the client.
- If it is a subscription link, choose “Import from URL” or “Add Subscription,” paste the link, and save it.
- If it is a single node link, choose “Import from Clipboard” or “Manual Import,” then paste the vless:// or similar link.
- After the import is complete, go to the node list and select one node as the current exit.
- Turn on the VPN/proxy switch and wait until the status shows connected, connected in Chinese, or a similar message.
- Open a browser and visit a test website to confirm that pages load normally.
If the client reports a format error, first check whether the link was copied in full. In particular, do not miss the parameters at the end, and do not copy explanatory text together with the link.
3. Why check IP, DNS, and the browser environment after importing
Successfully importing a node does not necessarily mean it will work properly. After connecting, it is recommended to first check whether the exit IP has changed. If the IP is still your local ISP address, it means the proxy may not be handling the traffic. In that case, confirm system VPN permissions, routing mode, or the client switch.
DNS also affects the experience. If some webpages will not open, or ping works but the browser cannot access them, DNS resolution may be abnormal. You can enable the built-in DNS in the client or switch to a common public DNS. Be careful not to run multiple proxy tools at the same time, to avoid conflicts in DNS and routing rules.
The browser environment is equally important. If only one browser cannot open pages, try disabling browser proxy plugins, clearing the cache, or testing in an incognito window. Many users have proxy extensions installed at the same time, and the proxy rules from those extensions end up overriding sing-box, causing the “client shows connected but webpages do not go through the proxy” problem.
4. Quick troubleshooting checklist for connection failures
- Switch nodes first: free nodes may be temporarily unavailable, so test other nodes under the same subscription first.
- Update the subscription: go to the subscription page and click refresh to avoid using an expired link.
- Check the time: incorrect system time may cause TLS certificate verification to fail.
- Close conflicting software: quit other VPNs, accelerators, and proxy plugins, then try again.
- Check the logs: search for keywords such as timeout, TLS, DNS, and permission to determine the direction of troubleshooting.
In short, importing nodes into sing-box is not complicated: use URL import for subscriptions, use clipboard import for single nodes, and after connecting, check whether the IP has changed, whether DNS is working properly, and whether the browser is being affected by plugins. Troubleshooting in this order will usually help pinpoint most cases where “it was imported but does not work.”