This article addresses the common question “how to import nodes into sing-box“: including importing via a subscription link, manually importing a single node, and why you still need to pay attention to IP, DNS, and the browser environment after connecting. It is suitable for ordinary users using sing-box for the first time to follow step by step.
1. What you need to prepare before importing
sing-box itself is a proxy core, and on different platforms it is usually used together with a graphical client, such as sing-box GUI, SFA, or third-party panels on Windows, macOS, Android, or iOS. Before importing nodes, first confirm that what you have is one of the following:
- Subscription link: usually a URL starting with https that contains multiple nodes.
- Single node link: such as vless://, vmess://, trojan://, ss://, etc.
- JSON configuration: some clients support directly importing configuration files in sing-box format.
If you are only testing temporarily, you can also use the free nodes compiled by this site, but the stability of free nodes may fluctuate, so it is recommended to prepare several backups.
2. Importing nodes using a subscription link
For most users, the subscription method is recommended because it is more convenient for later updates. Button names may vary slightly between clients, but the process is basically the same:
- Open the sing-box client and go to the “Configuration,” “Profiles,” or “Subscriptions” page.
- Click “Add” or the plus sign in the upper-right corner.
- Select “Import from URL” or “Remote Profile.”
- Paste your subscription link, and you can name it “Free Nodes,” “Backup Subscription,” etc.
- After saving, click “Update Subscription” or “Download” and wait for the node list to appear.
- Select a node and turn on the connection switch.
If the client says the format is incorrect, first confirm that the link is complete and that you did not accidentally copy extra spaces before or after it. You can also open the subscription link in a browser to test whether it is accessible normally. If it opens to a blank page, shows an error, or asks you to log in, it means the subscription source itself is unavailable.
3. How to manually import a single node
If what you have is a single node link, you can choose “Import from Clipboard” in the client. Before doing so, copy the complete node link first, then return to the client to import it. Some sing-box clients will not directly recognize all protocols, in which case you can try using a client that supports conversion, or switch to a subscription format.
After importing, it is recommended to check three items: server address, port, and protocol type. VLESS nodes in particular may also involve parameters such as TLS, Reality, and WebSocket, and missing even one parameter may cause the connection to fail. Ordinary users do not need to understand all the underlying fields, but they do need to make sure the link provided by the source is complete.
4. What do IP, DNS, and the browser environment have to do with things after connecting
Many people still cannot open websites even after importing successfully, and the reason is not necessarily that the node is broken. You can troubleshoot in the following order:
- IP: After connecting, visit an IP lookup website to confirm whether the exit IP has changed; if it has not, the system proxy may not have taken over.
- DNS: If IP-based access works but domain names do not, a common cause is abnormal DNS resolution. You can enable remote DNS or rule mode in the client.
- Browser environment: Browser cache, extensions, and DoH settings may affect access, so it is recommended to test in an incognito window.
- Mode selection: Global mode is suitable for quick testing; rule mode is better for daily use, but if the rules are wrong, some traffic may bypass the proxy.
When troubleshooting, it is recommended to switch to global proxy first, then visit a foreign website and an IP lookup page. If global mode works but rule mode does not, the problem is most likely with the rules or DNS; if global mode also does not work, then switch nodes or check the subscription.
5. Common fixes for connection failures
If you encounter prompts such as “timeout,” “connection refused,” or “handshake failed,” you can try the following in order: update the subscription, switch nodes, restart the client, close other proxy software, and check whether the system time is accurate. On mobile devices, also make sure VPN permission has been granted; on computers, pay attention to whether the firewall or security software is blocking it.
Summary: when importing nodes into sing-box, prioritize using a subscription link, and for a single node you can use clipboard import. After connecting, do not just look at whether the switch turns green; also check whether the IP has changed, whether DNS is working properly, and whether the browser is actually using the proxy. Following this process can solve most beginners’ problems with importing and connection failures.