How to Import Nodes into sing-box: Subscriptions, Manual Setup, and IP, DNS & Browser Environment Explained

This article explains how to import nodes into sing-box, including importing a subscription link or a single node, checking that the proxy is working after connecting, and understanding how your IP, DNS, and browser environment can affect access. It’s intended for everyday users who have just installed sing-box or are using a free node subscription.

1. What to prepare before importing nodes

sing-box is a proxy core, and many users pair it with a graphical client, such as a sing-box GUI on Windows, Android, or macOS, or another client that supports the sing-box core. Before importing nodes, check the following:

• You’ve installed the client and can open its configuration page.
• You have working node details, usually a subscription link or a share link using a protocol such as vless, vmess, trojan, or ss.
• Your system clock is correct, and you can access websites in your region normally.

This site collects free nodes and subscriptions for testing, but free resources can be unreliable. After importing, test the latency first, then choose a working route.

2. Import nodes using a subscription link

If you have a subscription URL, it usually starts with http or https. This is the easiest method. Follow these steps:

1. Open the sing-box client and go to “Subscriptions,” “Profiles,” or “Configuration Management.”
2. Click “Add Subscription.”
3. Paste the subscription link and enter a name, such as freevpn-x, or add your own note.
4. Save it, then select “Update Subscription” or “Update.”
5. Once the update is complete, return to the node list, choose a node, and enable it.

If the update fails, first check that the link is complete, especially the final characters. Then make sure your current network isn’t blocking the subscription URL. Some clients may require you to enable the system proxy or use a direct connection to update the subscription.

3. Import a single node share link

If you have a link for a single node, such as one starting with vless://, trojan://, or ss://, you can usually copy it and select “Import from Clipboard” in the client. Follow these steps:

1. Copy the entire node share link.
2. Open the client and find “Import” or “Import from Clipboard.”
3. Check that the detected protocol, address, and port are correct.
4. Save the configuration, select the node, and click Connect.

Keep in mind that compatibility varies between sing-box clients. Some share links can be recognized by Clash but may not import directly into a sing-box client. If this happens, try a newer client that supports sing-box, or use a subscription instead.

4. How IP, DNS, and your browser environment are related

Once connected, users often wonder, “Why won’t the webpage open?” or “Why hasn’t my IP changed?” It helps to understand these three layers:

• IP: An IP check website shows your exit IP. If it still shows your local IP, the proxy isn’t handling your browser’s traffic.
• DNS: DNS resolves domain names. DNS issues may prevent websites from resolving even when you’re connected to a node.
• Browser environment: Browser cache, extensions, WebRTC, and existing cookies may affect test results.

After connecting, try testing in a private window and visit an IP check website to confirm that your exit IP has changed. If only your browser isn’t working, try disabling proxy-related extensions, clearing the cache, or checking whether the client has “System Proxy” or “TUN Mode” enabled.

5. Quick troubleshooting for connection failures

For the fastest results, troubleshoot in this order:

1. Try other nodes in the same subscription to rule out a faulty node.
2. Update the subscription to make sure you’re not using an outdated configuration.
3. Check your system clock. A significant time difference can cause TLS-based nodes to fail.
4. Switch between System Proxy and TUN Mode to confirm that traffic is passing through sing-box.
5. Change your DNS settings, preferably to the default DNS recommended by the client.
6. Restart the client and browser, then reconnect.

In short, importing nodes into sing-box is straightforward: use “Add Subscription” for a subscription, or “Import from Clipboard” for a single node. The factors that most often affect your experience are node availability, DNS resolution, and whether your browser is using the proxy. Follow the steps in this article to import nodes, connect, and perform basic troubleshooting.