This article addresses the common question, “How do I import nodes into sing-box?” It also explains why you should pay attention to your IP, DNS, and browser environment after connecting. It’s intended for everyday users who have just installed sing-box and aren’t sure what to do with a free node or subscription link.
1. First, identify the type of node you have
There are two common ways to import nodes into sing-box: using a subscription link or using an individual node link or configuration file. This site collects free node resources. Once you have one, check its format: a full URL is usually a subscription link; a link starting with vless://, vmess://, trojan://, or a similar prefix is usually for a single node; and JSON content may be a sing-box configuration file.
- Subscription links: Best for importing multiple nodes and refreshing them later.
- Individual node links: Suitable for temporary testing; they need to be added or converted manually.
- JSON configurations: Can be imported directly, but make sure the source is trustworthy.
2. Basic steps for importing nodes into sing-box
The names of options in graphical clients may differ between platforms, but the process is the same. In a typical sing-box client, follow these steps:
- Install a client that supports the sing-box core. Open it and go to “Configuration,” “Profiles,” or “Subscriptions.”
- Click Add and choose “Import from URL” or “Add subscription.”
- Paste your subscription link. Enter a name, such as “freevpn-x nodes,” or add your own note.
- Save it, then update the subscription and wait for the client to retrieve the node list.
- Return to the home screen, select a node, and enable proxy or VPN mode.
- Open a browser and visit an IP lookup site to confirm that your exit IP has changed.
If you only have a single vless:// or similar link, look for an option such as “Import from clipboard” or “Import share link.” If your client doesn’t support importing individual nodes directly, you may need a converter that supports the sing-box format. Don’t upload personal subscription links that contain private information.
3. What your IP, DNS, and browser environment affect
Many people assume that connecting to a node is all they need to do, but three other things matter. Your IP determines the apparent location you use to access websites. DNS translates domain names into addresses; if your DNS leaks, a website or test page may see that you’re still using your local carrier’s DNS. Your browser environment includes settings and data such as language, time zone, WebRTC, cache, and account sign-in status.
For example, you might connect to an overseas node while your browser remains set to Chinese, your time zone stays local, and WebRTC exposes information about your local network. Some websites may consider this inconsistent. Most users don’t need to overcomplicate things, but it’s a good idea to do at least three checks: verify your IP after connecting, run a DNS leak test, and disable WebRTC in your browser or test in private browsing mode.
4. Troubleshooting connection problems after importing
If you can import a subscription but can’t connect to a node, start by checking the basics:
- Make sure your system clock is accurate. A large time difference can cause the handshake to fail.
- Try other nodes in the same subscription to determine whether the problem is limited to one node or is on your end.
- Check the client’s mode. On mobile, VPN mode is generally used; on desktop, you can use system proxy or TUN mode.
- Close other proxies, accelerators, and older VPNs to avoid port or routing conflicts.
- Update the subscription link. Free nodes may change, so an old configuration might no longer work.
If webpages won’t load but messaging apps work, check your DNS settings first. If the problem only affects your browser, remove proxy extensions, clear the cache, or try another browser. If you see “Subscription parsing failed,” the link may have expired, the subscription URL may be unreachable from your network, or the client may not support that subscription format.
5. Recommendations
sing-box supports a wide range of protocols and offers flexible rules, but beginners should first learn how to import and update subscriptions, switch nodes, and troubleshoot connection issues. When using free nodes, avoid signing in to sensitive accounts or transmitting important private information. If you use them regularly, keep multiple subscription sources as backups. If your target websites load reliably and your IP and DNS checks look normal, the import and connection process is probably working as expected.