This guide answers 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 importing. 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, check what type of node you have
sing-box supports multiple proxy protocols, though the interface varies between clients. There are generally two common ways to import nodes: a single node link, such as vless://, vmess://, or trojan://; or a subscription link, usually an https URL that contains multiple nodes. This site provides free node information for testing. You can start with a few nodes to check that your client is working properly.
- Single node: Best for temporary testing. Copy the link and import it.
- Subscription link: Best for updating multiple nodes at once. You can refresh them with a single click later.
- Configuration file: Usually in JSON format and suitable for sing-box configurations that have already been prepared.
2. Basic steps for importing nodes into sing-box
The names of options may vary between sing-box graphical clients on different platforms, but the basic process is the same: install the client, import nodes, select a node, enable the proxy, and test the connection.
- Install a client that supports the sing-box core, such as a sing-box graphical client for Windows, Android, or macOS.
- Open the client and look for an option such as “Subscription,” “Configuration,” “Profiles,” or “Import.”
- For a subscription link, select “Import from URL,” paste the subscription URL, and save it. For a single node, select “Import from Clipboard.”
- After importing, open the node list and select a node as your current outbound route.
- Enable system proxy or VPN mode, then open a website in your browser to test the connection.
If the client reports a configuration error, first check that you copied the entire link, especially the protocol at the beginning, the parameters at the end, and any special characters in between. Some chat apps automatically truncate links, so try copying them through a browser or text editor instead.
3. How IP, DNS, and your browser environment relate to imported nodes
Many people assume that importing a node means everything is ready to go, but the connection also depends on your IP, DNS, and browser environment. When the proxy is enabled, websites will generally see the proxy node’s exit IP rather than your local broadband IP. You can visit an IP lookup site to check whether your exit IP has changed.
DNS translates domain names into IP addresses. If DNS traffic doesn’t go through the proxy, you may be able to connect to the node but find that some websites won’t load, or you may experience a DNS leak. We recommend enabling remote DNS, FakeIP, or rule-based DNS in the client. If you’re an everyday user, avoid mixing multiple DNS tools without a good reason.
Your browser environment can also affect the results. For example, browser cache, cookies, language, time zone, and WebRTC can all make a website flag your environment as unusual. To troubleshoot, try an incognito window, disable unnecessary extensions, and make sure your system clock is correct.
4. Follow these steps if the connection fails
- Refresh the subscription first to check whether the nodes have expired or the configuration is corrupted.
- Try two or three different nodes to determine whether the issue is with a particular node or the client.
- Make sure system proxy/VPN mode is enabled; importing nodes alone isn’t enough.
- Check that your local network is working by visiting a domestic website first.
- Close other proxy software to avoid port conflicts or overlapping rules.
- Check the client logs, paying particular attention to messages such as DNS failed, timeout, or handshake failed.
If only your browser can’t access websites while other apps work normally, check your browser’s proxy settings and extensions first. If no apps can connect, focus on node availability, DNS, and the client’s status. Once you know these steps, importing nodes into sing-box and troubleshooting common issues will be much easier.