How do you import nodes into sing-box? This guide explains the difference between subscription links, individual node links, and JSON configurations, shows how to import them using the options your client supports, and covers how to troubleshoot websites that won’t load after connecting. First, remember that the sing-box core and graphical clients are not the same thing. Import options and supported formats depend on the app you installed.
1. Before importing, identify what you have
Install a client that works with your operating system from a channel linked to in the project’s official documentation, and check the version requirements. If you’re not sure whether the app supports subscriptions, check its configuration page or user guide. Avoid downloading modified versions from unknown sources.
- Subscription link: Usually an HTTPS address used to retrieve a configuration. You can’t tell the content format just by looking at the URL.
- Individual node link: A string that starts with something like vless://, vmess://, or trojan://.
- Complete configuration: Usually a JSON file that includes routing, DNS, and other settings in addition to nodes.
Using the sing-box core does not mean you can directly import every type of share link. A Clash YAML subscription cannot be used directly as sing-box JSON. You can process it through the appropriate option only if the client explicitly supports parsing or conversion.
2. Import nodes using your client’s options
- Open the client, go to “Configuration,” “Profiles,” or a similar page, and click Add. The option names may vary between apps.
- If you have a subscription URL, choose “Remote configuration” or “Add from URL,” enter a name, and paste the URL. Prefer the sing-box format explicitly specified by the node provider.
- If you have a JSON file, choose “Import from file.” If the app has an editor, you can also paste the complete configuration as instructed. For an individual node link, use the client’s “Import from clipboard” option if supported.
- Save the configuration, then download, update, or validate it. If you see a parsing error, first make sure the format is supported. Don’t keep trying to connect.
- Select the configuration you just added and start the connection. Grant permission for the VPN or network extension if prompted by the system. If the configuration provides a node selector group, choose the node you want to use.
If the remote configuration downloads successfully, you can set it to update regularly if your client supports this. For free nodes from this site, check the supported format and last updated time first. Free resources may stop working, and a successful import does not guarantee a successful connection.
3. Imported successfully but can’t access the internet? How to troubleshoot
A successful import only means that the file was accepted. It doesn’t mean the node is working. Check the logs for authentication failures, connection timeouts, or incompatible configuration fields, then verify the node’s validity period and the client version. If you encounter a field error, first obtain a configuration compatible with your version. Don’t delete fields at random.
Next, check that your system clock is set to sync automatically, and temporarily disable other VPNs or proxies to prevent conflicts. If only some apps can access the internet, check whether system proxy or TUN/VPN mode is enabled and whether the routing rules are sending the target app through a direct connection.
4. How do IP, DNS, and your browser environment relate?
An IP-checking page shows the egress IP for that particular visit. With split tunneling, domestic and international websites may use different egress IPs. DNS resolves domain names. If resolution fails, check the DNS settings in your configuration along with the logs; don’t judge a node based on just one checking page.
Browser proxy extensions, Secure DNS, cache, and cookies can also affect the results. First disable conflicting extensions, retest in a private window, and compare with other apps. Changing your egress IP does not automatically clear your browser’s login state or change all of its identifying characteristics. Also, subscription URLs often contain access credentials. Redact them in screenshots when asking for help, and don’t submit them to untrusted online conversion websites.