This guide answers the question “How do I import nodes into sing-box?” It’s for users who already have free nodes, a subscription URL, or an individual share link. Follow the steps to import and enable them, check connectivity, and understand how your IP, DNS, and browser environment interact after connecting. It also covers common reasons why an imported node may not work.
1. What to prepare before importing
sing-box is the core program. Most users will use a client with a graphical interface, such as an Android, Windows, macOS, or iOS client that supports the sing-box core. Button names vary slightly between clients, but the basic process is the same: add a configuration, import a subscription, select a node, and enable the proxy.
- Prepare your node information: a subscription URL, a share link such as vless/vmess/trojan/hysteria2, or a JSON configuration file.
- Make sure your client is up to date. Older versions may not support newer protocols or fields.
- If you’re using free nodes from this site, copy the latest subscription URL first to avoid importing outdated information.
- Turn off any other VPN or proxy software to prevent port or routing conflicts.
2. Common ways to import nodes into sing-box
Importing a subscription URL is the easiest option and works well for users who update their nodes regularly. If you only have a link for a single node, you can paste it in manually. Here’s how it works in a typical client:
- Open the client and go to “Configuration,” “Profiles,” or “Subscriptions.”
- Tap “Add,” “+,” or “New Profile.”
- Select “Import from URL” and paste in the subscription URL.
- Give the configuration a name, such as “freevpn-x nodes.”
- Save it, then tap “Update Subscription” or “Refresh” and wait for the node list to appear.
- Return to the main screen, select a node, and turn on the connection switch.
If you have a single share link, select “Import from Clipboard.” If the client reports that the format isn’t supported, it may not support that protocol, or the link may have been altered by line breaks or spaces. Copy it again and try once more.
3. How to confirm the import worked
A successful connection doesn’t necessarily mean all your traffic is going through the proxy. Check these three things in order: IP, DNS, and browser environment.
First, check your IP. Visit an IP lookup site. If the reported location matches your selected node, the proxy is basically working. If you still see your local ISP’s IP, common causes include the system proxy not being enabled, VPN mode being off, or your browser connecting directly.
Second, check DNS. DNS translates domain names into IP addresses. If your DNS is leaking, your local ISP may still be able to see which domains you visit. In the client, you can start with preset options such as “Remote DNS,” “fake-ip,” or “DoH/DoT.” Most users don’t need to write complicated rules, but should avoid enabling DNS features in multiple apps at the same time.
Third, check your browser environment. Your browser’s language, time zone, WebRTC settings, and cached cookies may not match your proxy IP. For example, if your node uses an overseas IP but your browser is still set to China time, some websites may ask you to verify your identity. Try using a private window, disabling WebRTC leak extensions, or clearing the site’s cache.
4. Quick troubleshooting for connection failures
- Subscription is empty: Check that the URL is complete, see if you need to open it in a browser to verify it, or confirm that the nodes haven’t expired.
- Imported successfully but can’t connect: Try another node and make sure your local network isn’t restricted. On a phone, switch between Wi-Fi and mobile data.
- Connection times out: The node may be unavailable, the route may be congested, or your system clock may be inaccurate. Start by correcting the time.
- Only your browser can’t access sites: Check the browser’s proxy settings or whether the client is in global or VPN mode.
- Some sites won’t open: Switch between rule mode and global mode to determine whether the rules aren’t matching or the problem is with the node.
In short, importing nodes into sing-box comes down to “import a subscription or link—update—select a node—enable the proxy—check your IP, DNS, and browser environment.” If something goes wrong, don’t keep reinstalling the app. First check whether the subscription is valid, then try another node and check your DNS and browser settings. This will usually help you find the cause.