This article answers the question, “How do I import nodes into sing-box?” It covers importing via subscription link, manually importing a single node, and checking your IP, DNS, and browser environment after import. It’s intended for users who have just installed a sing-box client and aren’t sure what to do next.
1. What to prepare before importing
sing-box is a proxy core. Most users use a client with a graphical interface, such as a sing-box GUI client on Android, Windows, macOS, or iOS. The interface labels vary slightly between clients, but the general steps are the same: add a configuration, import a subscription, and enable the proxy.
- Prepare a working node link or subscription link. Common formats include VLESS, VMess, Trojan, and Shadowsocks.
- Make sure the client supports the protocol. Some older versions may not support newer Reality features or specific transport methods.
- If you’re using the free nodes page on this site, copy the subscription address or an individual node link, then import it into the client to test.
2. Import sing-box nodes using a subscription link
Subscriptions are ideal for beginners because they make it easier to keep nodes up to date. Follow these steps:
- Open the sing-box client and go to the “Configuration,” “Profiles,” or “Subscription” page.
- Tap “Add,” “Import,” “Import from URL,” or a similar button.
- Paste in the subscription link and enter a name, such as “Free Nodes,” or choose your own.
- Save it, then tap “Update Subscription” and wait for the client to retrieve the node list.
- Select a node, return to the home screen, and turn on the connection toggle.
If the list is empty after importing, first check that you copied the entire link. Make sure it starts with https:// and that you didn’t include any extra spaces. Some clients also require you to set the configuration type to Remote Profile or “Remote Subscription.”
3. Manually import a single node
If you only have one node link, you can import it manually. Copy the entire link, then select “Import from Clipboard” in the client. Once imported, the client will usually generate a configuration automatically. If parsing fails, common causes include an unsupported protocol, missing link parameters, or an outdated client. Try updating the client first.
Beginners should avoid editing JSON configuration files directly. sing-box has many configuration fields, and a missing comma or bracket can prevent it from starting. Using the import feature in a GUI client is a safer option.
4. How IP, DNS, and your browser environment are related
Successfully importing a node doesn’t guarantee that your browser environment is working properly. After connecting, visit an IP lookup website to check whether your outgoing IP matches the node’s region. If your IP hasn’t changed, the proxy may not be routing system traffic. Check whether system proxy, TUN mode, or VPN mode is enabled.
DNS can also affect your browsing experience. If webpages won’t load or your location is detected incorrectly, you may have a DNS leak or DNS poisoning. In the client settings, try enabling options such as “Remote DNS” or “Prevent DNS Leaks.” Browser proxy extensions, privacy extensions, or built-in secure DNS can also conflict with sing-box, so try disabling them while troubleshooting.
5. Quick troubleshooting for connection failures
- Subscription update fails: Check your network and whether the subscription link has expired, or try updating on a different network.
- Connected, but webpages won’t open: Switch nodes, check your DNS settings, and try disabling the browser’s secure DNS.
- Only some apps use the proxy: Check whether TUN/VPN mode is enabled or if the proxy is configured only in your browser.
- Frequent disconnections: Free nodes can be unstable. Update the subscription or try a different node.
In summary, the easiest way to import nodes into sing-box is with a subscription link, followed by importing an individual node from the clipboard. After importing, check your IP, DNS, and browser environment to confirm that everything is configured correctly.