This guide answers the question “How do I import nodes into sing-box?” It covers importing subscription links, manually importing a single node, checking whether the import worked, and why your IP, DNS, and browser setup can affect access. It’s intended for everyday users who have just installed sing-box or use a graphical client such as SFA or sing-box for Windows.
1. What to prepare before importing nodes
sing-box is the core engine. Many users actually use a graphical client, such as SFA on Android, or sing-box GUI or a third-party panel on Windows/macOS. Before importing, check three things: the client is installed, the node or subscription link works, and your system clock is correct. This site collects some free nodes for temporary testing, but free nodes aren’t consistently reliable, so try several after importing.
- Subscription link: Usually a URL starting with https, suitable for importing multiple nodes.
- Single node: May be a link starting with vless://, vmess://, trojan://, or a similar scheme.
- JSON configuration: Some clients support directly importing sing-box configuration files.
2. How to import nodes from a sing-box subscription
- Open your sing-box graphical client and go to “Configuration,” “Profiles,” or “Subscriptions.”
- Click “Add,” “Import,” or “New Profile,” then choose “Import from URL.”
- Paste your subscription link. You can enter a name such as “freevpn-test” to make it easy to identify.
- Save it, then click “Update subscription” or “Update” and wait for the node list to load.
- Return to the home screen, select a node or policy group, then click Start/Connect.
If your client doesn’t have a subscription option, try importing from the clipboard. Copy the node link, then choose Import from Clipboard in the client. If you get a format error, the client may not support that format, or the link may be missing characters.
3. How to manually import a single node
Manual import is useful if you only have one vless, trojan, or vmess link. Copy the full node link, then choose “Import link” or “Import from clipboard” in the client. After importing, check that fields such as the address, port, UUID/password, transport, and TLS settings aren’t empty. If you’re a casual user, avoid changing these parameters without a reason—especially TLS, Reality, and the WebSocket path. Incorrect settings will cause the connection to fail.
Some sing-box clients require a JSON configuration. If you have a standard node link, you’ll first need to convert it to a sing-box configuration using a compatible tool or client. If you’re not familiar with the process, it’s easiest to use a client that supports subscription imports.
4. How your IP, DNS, and browser setup can affect access
Successfully importing a node doesn’t guarantee that every website will open properly. After connecting, visit an IP lookup site to see whether your exit IP has changed. If it’s still your local ISP’s IP, the proxy may not be handling your traffic, or you may have selected the wrong mode. Common modes include Global, Rule, and Direct. When troubleshooting, beginners can switch to Global mode first.
DNS can also affect access. If DNS requests are still being resolved by your local network, you may find that sites won’t open, redirect unexpectedly, or show the wrong region. If your client has options such as “Remote DNS” or “Prevent DNS leaks,” enable them and test again. In your browser, try disabling other proxy extensions, clearing the target site’s cookies, or testing in a private window. This helps rule out interference from old login sessions, cached data, and extensions.
5. Quick troubleshooting for connection failures
- Subscription update fails: Check whether the link has expired or was truncated by a space, then try again on another network.
- Connected but webpages won’t open: Switch to Global mode and check that the system proxy is enabled.
- Very high latency or timeouts: Try other nodes in the same subscription instead of testing just one.
- Websites won’t open in the browser, but apps work: Disable browser proxy extensions and restart the browser.
- Your IP hasn’t changed: Confirm that the client is running and that it has VPN/proxy permissions.
In short, the easiest way to import nodes into sing-box is with a subscription URL, followed by clipboard import for a single link. After importing, check five things—whether the nodes loaded, whether the connection succeeded, whether your IP changed, whether DNS is leaking, and whether browser extensions are interfering. This should help you pinpoint most common issues.