This article addresses the common question “how to import nodes into sing-box“: covering everything from downloading and installing to importing subscriptions, manually adding nodes, connection testing, and how IP, DNS, and the browser environment affect the final access results. It is suitable for ordinary users who are new to sing-box and just want to quickly get free nodes or provider subscriptions working.
1. Prepare the client and node information first
sing-box is a core program, and ordinary users will usually use a GUI client, such as a proxy tool on Windows, Android, or iOS that supports the sing-box core. Before installing, make sure the download source is reliable to avoid installing modified versions from unknown sources.
Before importing nodes, you need to prepare any one of the following:
- Subscription link: usually a URL starting with https://, suitable for updating nodes in batches.
- Single node link: such as vless://, vmess://, trojan://, and other formats.
- JSON configuration file: some clients support directly importing a complete sing-box configuration.
This site provides some testable free nodes. When using them, it is recommended to prioritize the subscription method for easier future updates; if a node becomes invalid, switch to another route.
2. Common ways to import nodes into sing-box
Different clients have slightly different interfaces, but the process is basically similar. Using a common GUI client as an example, you can follow these steps:
- Open the client and go to the “Configuration,” “Subscription,” or “Profiles” page.
- Click “Add,” “Import,” or the plus sign in the upper-right corner.
- If you have a subscription link, choose “Import from URL,” paste the link, and save it.
- If it is a single node link, choose “Import from Clipboard” or “Add Manually.”
- After updating the subscription, return to the node list and select a node with lower latency or one that is available.
- Click Start, Connect, or Set as System Proxy, then open your browser to test access.
If the client reports a format error, it is usually not a problem with sing-box itself, but rather an incomplete link, incompatible subscription content, or extra spaces added during copying. It is recommended to copy it again and confirm that the subscription link can be opened in a browser.
3. How are IP, DNS, and the browser environment related?
Many users find that after importing nodes, web pages still will not open, or IP checks still show no change. This usually relates to three things. The first is the IP exit: after a successful connection, the target website sees the proxy node’s exit IP rather than your local broadband IP. You can confirm whether it has changed through an IP lookup website.
The second is DNS resolution: DNS is responsible for resolving domain names into IP addresses. If DNS does not go through the proxy, issues such as pollution, resolution failure, or abnormal region detection may occur. In this case, you can enable remote DNS, rule-based DNS, or use the client’s default recommended configuration.
The third is the browser environment: browser cache, cookies, WebRTC, language, and time zone can all affect how a website identifies you. For example, you may switch nodes, but if the browser still keeps the old login state, the website may continue displaying content based on the original region. You can try an incognito window, clear site data, or disable WebRTC if it may leak your local IP.
4. Troubleshoot connection failures in this order
- Confirm that the network itself is working: first turn off the proxy and test whether ordinary websites can be opened.
- Update the subscription: free nodes often become invalid, so refresh the subscription and switch nodes first.
- Check the system time: if the time difference is too large, it may cause TLS handshake failure.
- Switch modes: global mode is better for testing; after confirming it works, switch back to rule mode.
- Check the logs: pay special attention to messages such as timeout, tls, dns, and connection refused.
If the IP has changed in global mode but some websites still will not open, it is most likely a rules, DNS, or browser cache issue; if no websites open at all, first check whether the node is available, whether the port is blocked, and whether the client has obtained VPN or proxy permissions.
5. Usage recommendations
Beginners are advised to import via subscription first and not start by modifying complex JSON. After importing, first use one node to test the IP, then test commonly used websites, and finally adjust the rule mode as needed. For free nodes, expect outages and congestion; keeping multiple backup subscriptions is more reliable. Once you understand the process above, you should basically be able to independently import nodes into sing-box and troubleshoot connection issues.