How to Import Nodes in sing-box: Subscription, Manual Setup, and IP/DNS/Browser Environment Explained

This article addresses the common question of “how to import nodes into sing-box“: including importing via a subscription link, manually importing a single node, how to test the connection after importing, and why the same node can behave differently under different IP, DNS, and browser environments. It is suitable for ordinary users who are new to sing-box to follow step by step.

1. What you need to prepare before importing

sing-box itself is a proxy core, and many users use it through clients with graphical interfaces, such as sing-box clients on Android, Windows, macOS, or iOS. Before importing nodes, please prepare the following:

• A working node link, such as VLESS, VMess, Trojan, Shadowsocks, or similar formats.
• Or a subscription link, usually beginning with https://, which returns a set of node configurations when opened.
• An installed sing-box client, with permission to create VPN or proxy connections.

This site compiles some free nodes and subscription information. When using them, it is recommended to test availability first and not assume that all nodes will remain stable long term.

2. Importing nodes using a subscription link

If what you have is a subscription address, the easiest way is to add the subscription directly. Button names may vary slightly between clients, but the process is basically the same:

1. Open the sing-box client and go to “Configuration,” “Profiles,” “Subscriptions,” or a similar page.
2. Click “Add,” “+,” or “Import from URL.”
3. Paste the subscription link. For the name, you can enter “freevpn-x” or any custom name.
4. After saving, click “Update Subscription” or “Sync.”
5. Return to the node list, select a node, and then click to start the connection.

If the update fails, first check whether the subscription link is complete, especially making sure no trailing parameters are missing. Next, confirm that your current network can access the subscription address. Some clients also support importing by scanning a QR code, which is convenient for mobile users.

3. Manually importing a single node

If you only have a single node URI, such as one beginning with vless://, trojan://, or ss://, you can choose “Import from clipboard.” Before doing so, copy the complete node link, then return to the client and tap import. After a successful import, the client will usually automatically parse information such as the server address, port, UUID, encryption method, and transport protocol.

Note that sing-box is fairly strict about configuration formats. If it reports a parsing failure after import, common reasons include line breaks inserted into the link, Chinese punctuation mixed in, missing parameters, or the client version not supporting the protocol. It is recommended to update the client first, then copy the full link again.

4. Why IP, DNS, and browser environment can affect the results

Many people find that after importing a node, the client shows as connected, but web pages will not open, or IP check results are inconsistent. This is usually related to the IP, DNS, and browser environment.

• IP: After connecting, visit an IP lookup website. It should show the proxy exit IP. If it still shows your local IP, the system proxy may not be enabled or the routing mode may be incorrect.
• DNS: If DNS resolution goes through the local network, websites may fail to open, become polluted, or show abnormal region detection. You can enable remote DNS in the client or use the recommended secure DNS settings.
• Browser environment: Browser cache, extensions, WebRTC, and account login status can all affect how websites identify you. When testing, you can use an incognito window and disable unnecessary extensions.

A simple way to check is: first connect to the node, then open an IP lookup page to confirm the exit IP; next, visit commonly used websites to test; finally, clear the browser cache or switch browsers and test again.

5. Checklist for troubleshooting connection failures

If a node imported into sing-box does not work, you can troubleshoot in the following order:

1. Confirm that the node or subscription has not expired, then update the subscription again.
2. Switch to other nodes within the same subscription to rule out a single unusable node.
3. Check whether the time on your phone or computer is accurate, as incorrect time may cause TLS failure.
4. Turn off other VPNs, accelerators, or proxy software to avoid port or routing conflicts.
5. Try switching networks, for example by testing between Wi-Fi and mobile data.
6. Check the client logs, paying special attention to errors such as timeout, TLS, DNS, and handshake.

Overall, importing nodes into sing-box is not complicated: use URL import for subscriptions, and clipboard import for single nodes. If the connection behaves abnormally, do not just switch nodes; also check DNS, the system proxy, and the browser environment. By following the steps above, you can identify most beginner issues.