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

This article addresses the question “how to import nodes into sing-box“: including importing from a subscription link, manually adding a single node, and how to verify after import whether your IP, DNS, and browser environment are working properly. It is suitable for ordinary users who have just installed sing-box but do not know how to configure it next.

1. What to prepare before importing

sing-box itself is a proxy core. The names of common clients may vary slightly across platforms—for example, the graphical interfaces on Android, Windows, and iOS are different—but the basic logic is the same: first install the client, then add a configuration or subscription, and finally choose a node to connect. Before importing, prepare the following:

• A working node link, such as vless, vmess, trojan, hysteria2, or similar formats.
• Or a subscription link, usually a full address beginning with https://.
• Make sure your system time is accurate, as an incorrect time may cause TLS certificate verification to fail.
• If you are using this site’s free nodes, copy the complete subscription address first and make sure no characters are missing.

2. Import nodes using a subscription link

For beginners, the most recommended method is to import via subscription, because it makes later node updates more convenient. Button names may differ between clients, but the process is largely the same:

1. Open the sing-box client and go to the “Configuration,” “Profiles,” “Subscription,” or “Profile” page.
2. Tap “Add,” “+,” or “New Profile.”
3. Select “Import from URL,” “Remote Profile,” or “Subscription Link.”
4. Paste the subscription URL into the address bar. For the name, you can enter “freevpn-x” or any custom name.
5. After saving, tap “Update,” “Update,” or “Download.”
6. Return to the home page, select the configuration you just imported, and tap to start the connection.

If the client reports a format error, first check whether the link contains spaces, line breaks, or Chinese punctuation. If it says the download failed, switch networks and try again.

3. Manually import a single node

If you only have one shared node link, you can copy the full link and then choose “Import from Clipboard” in the client. Some clients also support importing by scanning a QR code. After a successful import, you will usually see the node name, protocol type, and region label in the node list. Note that you must not copy only the server address or port. A single node also includes information such as UUID, encryption method, transport layer, and SNI; if any one of these is missing, the connection may fail.

4. Check IP, DNS, and browser environment after importing

A successful node import does not necessarily mean the environment is working properly. After connecting, it is recommended to perform three checks:

• IP check: Open an IP lookup website and confirm that the displayed exit IP generally matches the region of the selected node.
• DNS check: If web pages open but some sites behave abnormally, the issue may be DNS leakage or polluted resolution. You can enable remote DNS, FakeIP, or rule mode in the client.
• Browser check: Browser extensions, cache, WebRTC, or leftover system proxy settings may all affect the results. When testing, you can use an incognito window or temporarily disable other proxy extensions.

If you are using rule mode, it is normal for domestic websites to connect directly while overseas websites go through the proxy. If you want all traffic to pass through the node, you can switch to global mode, but this may affect access to local services.

5. Common troubleshooting for connection failures

If you cannot connect, checking in the following order will save the most time: first update the subscription, then switch to another node; confirm that your local network can access web pages normally; check the system time; close other VPN or proxy software; and review keywords in the client log such as timeout, tls, dns, and handshake. If only one specific node fails, that node is most likely temporarily unavailable. If all nodes fail, the cause is usually related to the local network, DNS, client permissions, or configuration format.

In summary, when importing nodes into sing-box, subscriptions should be your first choice, followed by importing a single node via the clipboard or QR code. After importing, do not rely only on the “connected” status—also check your IP, DNS, and browser environment so you can confirm whether the proxy is actually working.