This article explains how to import nodes into sing-box. It’s for users who have just installed sing-box and received a free node or subscription link, but aren’t sure how to use it. You’ll learn how to import a subscription, check whether your IP has changed, and understand how DNS and your browser environment can affect access.
1. Before you import
sing-box is the core program. Most users access it through a graphical client, such as SFI, sing-box GUI, NekoBox, or another tool that supports the sing-box core. Button names vary slightly between clients, but the general process is the same: add a configuration, import a subscription, select a node, and start the proxy.
- Get a working node link or subscription link. Common formats include vless, vmess, trojan, and hysteria2.
- Make sure your client supports the protocol. Some older versions may not recognize newer protocols.
- If you’re using a free node from this site, we recommend copying the “subscription link” first. It’s easier than copying nodes one at a time.
2. Common ways to import nodes into sing-box
- Open your sing-box client and go to “Configuration,” “Profiles,” “Subscriptions,” or a similar section.
- Click “Add,” “Import,” or “Import from URL,” then paste in the subscription link.
- Save it, then click “Update subscription” and wait for the client to retrieve the node list.
- Return to the main screen, select a node from the list, and click “Connect” or “Start.”
- Open a browser and visit an IP lookup site to check whether your outbound IP has changed.
If you have a link for a single node, choose “Import from clipboard” or “Add manually.” If no node appears after importing, the link may be incomplete, the client may not support the protocol, or the prefix may have been omitted when you copied it.
3. How IP, DNS, and your browser environment are related
Many people assume that once they’re connected, every website should be accessible. In reality, the result also depends on whether your IP, DNS, and browser environment are consistent. Your IP is the outbound address a website sees. DNS resolves domain names to server addresses. Your browser environment includes details such as language, time zone, cache, cookies, and WebRTC.
If your IP has changed to an overseas address but a website still reports a location mismatch, your DNS may still be using your local ISP’s resolver. In that case, enable “Remote DNS” or “Prevent DNS leaks” in your client, or configure DNS in rule mode. Old cookies may also cause a website to continue identifying you as being in your original region. Try clearing the site’s data or testing in a private window.
4. Troubleshooting connection failures
- Subscription won’t update: Check whether the link has expired and make sure you copied the complete https address.
- Connected, but web pages won’t load: Switch nodes, or change from “Rule mode” to “Global mode” to test.
- Some websites won’t open: A rule may not be matching. Try updating the rule set or temporarily using a global proxy.
- Your IP hasn’t changed: Make sure system proxy or VPN mode is enabled, and check that your browser isn’t using a separate proxy extension.
- DNS leak: Enable the client’s built-in DNS to prevent the browser from using local DNS directly.
When troubleshooting, change just one setting at a time so you can tell what made a difference. First confirm that the node works, then address any DNS or browser cache issues.
5. Tips for using sing-box
For everyday use, importing a subscription is usually the best option, since you can sync node updates later with a single click on “Update subscription.” Free nodes may be unstable due to high usage or network conditions. If a connection fails, don’t keep reinstalling the client—check the troubleshooting list above first. Once you know how to import and switch nodes, check your IP, and troubleshoot DNS, you’ll have the basics of everyday sing-box use covered.