How to Import Nodes into sing-box: A Guide to Subscriptions, Config Files, and Connection Troubleshooting

This article explains how to import nodes into sing-box, why a connection may fail after adding a subscription, and how IP, DNS, and browser settings can affect test results. Sing-box graphical clients vary in their features across platforms, so the steps below cover common workflows. Button names may differ in your client; features in one client should not be assumed to exist in every version.

1. Check what kind of node information you have

Before importing, identify the type of information you have to avoid pasting a link into the wrong field. Support for the sing-box core does not mean support for every subscription format, so check the client documentation and the provider’s stated compatibility.

  • Subscription URL: Usually an HTTPS link that the client uses to fetch a configuration. However, the content returned by the link may not be compatible with sing-box.
  • Single-node share link: For example, vless://, vmess://, or trojan://. The client must support parsing the corresponding link type.
  • Configuration file: Usually a JSON file. Make sure it is a complete sing-box client configuration, not just a fragment for a single node.

If you get free nodes from this site or elsewhere, also check the format and last-updated date. Don’t share subscription URLs containing tokens publicly, and don’t submit sensitive subscriptions to unfamiliar online conversion websites.

2. Import and enable your configuration

  1. Install a graphical client suited to your operating system from the project’s official channels. If you downloaded the sing-box command-line program, it won’t have a universal interface for importing configurations by scanning or pasting. Most users should start with a client that includes configuration management.
  2. To import a subscription, go to “Configuration,” “Profiles,” or a similar page, choose the option to add a remote configuration, enter a name and the subscription URL, then download or update it. If the provider offers a sing-box-specific subscription, use that where possible.
  3. To import a file, choose the local import option and open a compatible JSON configuration. For a single-node link, use the client’s “Import from clipboard” or QR-code scanning option if available. If it doesn’t support these options, ask the provider for a compatible configuration.
  4. Set the new configuration as the active one and start the connection. On first use, grant VPN or network-extension permissions when prompted by the operating system. On desktop, enable the system proxy or TUN mode as described in the client’s documentation. Don’t run other proxy tools at the same time.
  5. If the interface provides node groups, select an available node, then visit a familiar website and check the logs. A successful subscription update only means the information was downloaded; it doesn’t guarantee that a node can connect.

3. Troubleshoot connection failures in order

Check the error logs before changing settings. If the subscription fails to download, check that the URL is complete, the token is still valid, and your current network can reach the subscription server. If you see a configuration parsing error, focus on the format and compatibility with your client version and core. Don’t just keep clicking Connect.

If the configuration loads but the connection times out, try other nodes in the same subscription and check that your device’s clock is correct. If no websites open after you connect, stop the connection first, confirm that your original network works, and then check VPN permissions, proxy routing, and any DNS errors.

4. How IP, DNS, and your browser are related

An unchanged IP address doesn’t necessarily mean the import failed: in rule mode, traffic to an IP-checking site may go directly, or your browser may not be using the system proxy. Check the routing rules and connection logs together. DNS resolves domain names; if resolution fails, websites may not open even when the node is working. Avoid copying unfamiliar DNS settings without checking them.

Browser extensions, custom proxy settings, and secure DNS can also affect the results. Temporarily disable proxy extensions and test again in another browser. Incognito windows can help rule out some effects from cached data and login status, but they don’t guarantee a different exit IP or automatically resolve DNS issues.

Leave a Comment

Your email address will not be published. Required fields are marked *

中文 EN
🚀

RedGate VPN

免费节点太挤太慢?
升级高速稳定专线

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top