This article addresses the common question, “How do you import nodes into sing-box?”: you can import them via a subscription link, a node link from the clipboard, or a local configuration file. After importing, check your IP, DNS, and browser environment to avoid issues such as being able to connect but not open web pages, inconsistent IPs, or DNS leaks.
1. Preparation Before Importing
sing-box itself is a proxy core. Regular users usually use clients with a graphical interface, such as sing-box for Android, SFI, NekoBox, sing-box GUI on Windows/macOS, or clients that support the sing-box core. Button names may vary slightly between clients, but the overall process is basically the same.
- Prepare available nodes: common formats include VLESS, VMess, Trojan, Shadowsocks, and more.
- Prepare a subscription link: if you get free nodes from this site, you can copy the subscription address or a single node link.
- Make sure the network is accessible: when importing for the first time, it is recommended to close other proxy software to avoid port conflicts.
2. Importing Nodes via a Subscription Link
- Open the sing-box client and go to the “Configuration,” “Profiles,” or “Subscription” page.
- Click buttons such as “Add,” “Import,” or “Import from URL.”
- Paste the subscription link. For the name, you can enter “freevpn-x node” or any custom name.
- After saving, click “Update Subscription” and wait for the client to fetch the node list.
- Return to the homepage, select a node or policy group, and click to start the connection.
If the list is empty after importing, it is usually because the subscription address was not copied completely, the network cannot access the subscription source, or the client does not support that subscription format. You can try using “Import from Clipboard” instead or copy a single node for testing.
3. Importing a Single Node or a Local Configuration File
If what you have is a single link such as vless://, trojan://, or ss://, you can first copy the entire link, then choose “Import from Clipboard” in the client. Some clients will automatically recognize the protocol and generate a node. If what you have is a JSON configuration file, choose “Import from File,” then locate the configuration file and save it.
Note that sing-box JSON configurations are fairly strict. A missing comma or an incorrect field may cause startup to fail. Regular users are not advised to manually modify the underlying configuration and should prioritize using the client’s import function.
4. What Do IP, DNS, and the Browser Environment Have to Do with It?
Successfully importing a node does not necessarily mean the environment is configured correctly. After connecting, it is recommended to open an IP lookup website and check whether the displayed exit IP has changed to the node’s region. If the IP has not changed, the system proxy may not be enabled, the browser may be using a direct connection, or the rule mode may not cover the current website.
DNS is responsible for resolving domain names into IP addresses. If DNS is still going through your local ISP, web pages may fail to load, region detection may be incorrect, or even DNS leaks may occur. In the client, you can usually choose “Global Mode” for testing, then switch back to rule mode after confirming everything works properly.
The browser environment can also affect the result. For example, if Chrome has other proxy extensions installed, or Clash/V2RayN is running at the same time on the system, traffic may not actually go through sing-box. When troubleshooting, it is recommended to keep only one proxy tool running and disable browser proxy extensions.
5. Quick Troubleshooting for Connection Failures
- Node timeout: switch to another node for testing; free nodes may become invalid or congested.
- Startup failure: check whether the configuration is complete, then delete it and re-import the subscription.
- Can connect but cannot open web pages: switch to global mode and check the DNS settings.
- IP does not change: make sure system proxy, VPN mode, or TUN mode is enabled.
- Some websites cannot be opened: try changing the node region or switching the browser to Incognito mode.
Summary: the core ways to import nodes into sing-box are the three methods of “subscription URL, clipboard, and file import.” After importing, do not just rely on the client showing that it is connected; you should also check the exit IP, DNS resolution, and browser proxy environment so you can more accurately determine whether the internet access configuration has truly been completed.