This article answers a common question: how to import nodes into sing-box. After receiving a subscription URL, a node share link, or a JSON configuration, how do you choose the right import method? And if the import succeeds but webpages still won’t load, how do you check your IP, DNS, and browser environment? The available options and supported formats vary between sing-box graphical clients, so first identify the type of link you have.
1. Distinguish node links from configuration files
sing-box is a proxy core; graphical clients are apps that provide an interface for using it. Using the sing-box core does not mean that a client can import every subscription format directly. Common resources fall into three categories:
- Complete JSON configuration: Usually includes outbound, routing, and DNS settings, and can be imported as a configuration by a compatible client.
- Remote configuration URL: Downloads a configuration from a URL. It will load correctly only if its contents are compatible with the client.
- Single share links or generic subscriptions: For example, vless:// or vmess:// links. Whether they can be imported directly depends on whether the client can parse or convert them.
When installing, prioritize the project’s official release channels and choose the version for your operating system. Don’t mistake a third-party app with a similar name for the official client, and avoid installing modified versions from unfamiliar websites.
2. Import sing-box configurations by type
- Open the client and look for an add option on a page labeled “Configuration,” “Profiles,” or something similar. The button name may vary by version.
- If you have a complete JSON file, choose the option to import from a file. If the client supports pasting a configuration, you can also paste the full text and save it.
- If you have a remote configuration URL, choose the remote configuration or URL import option, enter a name and the URL, then download or update it. Make sure the URL returns configuration content, not a webpage or login page.
- If you have a single node link, first check whether the client supports importing share links for that protocol. If it doesn’t, ask the provider for a sing-box-compatible configuration. Simply changing the file extension won’t help.
- After saving, select the configuration and grant VPN permissions if prompted by your system, then connect. If the configuration includes a node selection group, choose an available outbound on the connection page.
A successful import only means that the configuration was saved; it does not guarantee that the node can connect. If you see an unsupported field or parsing error, check which sing-box version the configuration is intended for. If you’re using free nodes from this site, first check their format and last updated date. Don’t paste a subscription intended for another client directly into sing-box.
3. If there’s no connection after import, troubleshoot in order
Start by checking the client logs. If the download fails, make sure the subscription URL is complete and still valid, and check whether your current network can access it. If the configuration fails to parse, check the format and version first. Don’t delete unfamiliar fields without checking them.
Next, check your system time and temporarily disable any other VPN or proxy tools to avoid routing conflicts. If only some apps can’t connect, check whether the client has enabled a system proxy or TUN/VPN mode. These cover different types of traffic, so the connection icon alone doesn’t tell you whether traffic is going through the proxy.
4. How IP, DNS, and your browser are related
Importing a node, your exit IP, and your browser environment are three separate things. Routing rules may send some websites directly, so different sites may show different IP addresses. DNS resolves domain names; if resolution fails, check the DNS settings in your configuration rather than switching nodes at random.
If other apps work but your browser doesn’t, test in a private window and check proxy extensions, secure DNS, and the cache. Private browsing mode does not change your exit IP. Subscription URLs may contain access credentials, so hide the full URL in troubleshooting screenshots and don’t submit it to untrusted online conversion services.