This article addresses the common question, “How do you import nodes into sing-box?”: you’ll learn how to import nodes into sing-box using a subscription link or configuration file, and understand why IP, DNS, and the browser environment can affect access results after importing, making it suitable for first-time sing-box users to follow along.
1. What to prepare before importing
sing-box itself is a core tool, and on different systems it is often used together with a graphical client, such as a sing-box GUI shell or a client that supports the sing-box core on Windows, macOS, and Android. Before getting started, prepare the following:
- A working node subscription link, usually starting with https://;
- Or a sing-box JSON configuration file;
- Make sure the client is installed and allowed to create VPN or proxy permissions;
- If you are using this site’s free nodes, you can first copy the subscription address updated for the day or an individual node link.
Note: interface labels may vary slightly between clients, but the core process is always “add configuration — import — enable — connect.” If the import fails, don’t keep clicking connect repeatedly; first confirm that the link and format are correct.
2. Common ways to import nodes into sing-box
The easiest method is to import via subscription, which is suitable when nodes are updated regularly; if you only have a single configuration file, use local import instead.
- Open the sing-box client and go to the “Configuration,” “Profiles,” or “Subscriptions” page.
- Click “Add,” “+,” or “Import.”
- Select “Import from URL,” paste the subscription link, and name it “freevpn” or anything you like.
- After saving, click “Update Subscription” or “Sync.”
- Return to the main screen, select the configuration you just imported, and click Start or Connect.
- After the connection succeeds, open a browser and visit an IP lookup website to confirm whether the outbound IP has changed.
If what you received is a JSON file, you can choose “Import from File,” locate the local configuration, and save it. If the client reports a JSON parsing error after import, it usually means the file content is incomplete, extra garbled characters were introduced during copying, or the client does not support certain fields.
3. How IP, DNS, and the browser environment are related
Many users assume that once a node is imported successfully, access will definitely work normally. In reality, it also depends on whether the IP, DNS, and browser environment are consistent. IP is the outbound address shown when you visit websites; DNS is responsible for resolving domain names into server addresses; and the browser environment includes cache, language, time zone, cookies, WebRTC, and more.
For example, sing-box may already be connected, but the browser still cannot open certain websites because DNS is still going through the local ISP; or the IP may have changed but the account still triggers risk controls, possibly due to browser cookies, time zone, or previous login history. Ordinary users do not need to over-modify their environment. It is recommended to first do three things: clear the target website’s cache, disable browser WebRTC leak extensions or permissions, and retest using an incognito window.
4. Troubleshoot connection failures in this order
- Subscription cannot be updated: check whether the link has expired and whether it was copied in full, then try again on a different network.
- It imports successfully but won’t connect: switch to another node and confirm that the current node has not expired or failed.
- It shows as connected but web pages won’t open: try switching the DNS mode in the client settings, or restart the browser.
- Only some apps work: check whether system proxy, TUN mode, or per-app proxy is enabled.
- Unstable speed: switch to a node in a nearby region, and avoid running multiple proxy applications at the same time.
If you are using free nodes, stability will be affected by the number of online users and the node status. It is recommended to save multiple working configurations and, when something goes wrong, update the subscription before testing again.
5. Usage recommendations
For daily use of sing-box, it is recommended to prioritize managing nodes through subscriptions for easier future updates; after each import, test the IP first and then test webpage access; when problems arise, troubleshoot in the order of “subscription — node — DNS — browser.” This will resolve most sing-box node import and connection issues.