How to Add Nodes to sing-box: Subscription Links, Config Files, and Connection Troubleshooting

This guide explains how to import nodes into sing-box: first identify whether you have a node link, subscription URL, or configuration file; then import it using a method supported by your client; and finally check whether the IP, DNS, and browser proxy are working. Button names and import capabilities vary between sing-box graphical clients, so don’t assume that steps for another client will apply.

1. Check what you have before importing

Install the version for your device from the client project’s official website or release page. Note that the sing-box core and graphical clients built on it are not the same thing. Most users should choose a client that provides a configuration management interface.

  • Starts with vless://, vmess://, trojan://, etc.: usually a share link for a single node.
  • Starts with https://: may be a subscription URL or simply a webpage. Check the provider’s instructions.
  • Ends with .json: may be a sing-box configuration, but you still need to verify its contents and version compatibility.

sing-box does not natively support every subscription format. Clash YAML, Base64 node collections, and sing-box JSON are different formats. Whether you can import them directly depends on the client.

2. Import nodes using a supported method

  1. Open the client, go to “Configuration,” “Profiles,” or a similar page, and find the option to add a profile.
  2. If your provider supplied a compatible remote sing-box configuration, select “Import from URL” or “Remote Configuration,” paste the address, enter a name, and save.
  3. If you have a local JSON file, select “Import from File,” grant any required file access permissions, and choose the file.
  4. If you only have a single node link, first check whether the client supports importing from the clipboard or a share link. If it doesn’t, ask your provider for a compatible configuration instead of pasting the link into a JSON editor.
  5. Select the new configuration and update or validate it. If you see a syntax error or an unknown field, first check the version required by the configuration. Don’t delete or edit fields at random.
  6. Enable the connection, allow the client to add a VPN configuration or enable the relevant proxy feature when prompted, and then test web access.

A successful import doesn’t mean the connection is working. When obtaining free nodes from this site or other sources, check their format and validity as well; public nodes may be unavailable or congested. Subscription URLs may contain personal credentials, so don’t post them in public comments or submit them to online conversion websites without careful consideration.

3. How to check your IP, DNS, and browser setup

After connecting, first use your browser to visit a website that normally works, then check your exit IP. Whether the exit IP changes depends on the routing rules. In rule mode, some websites may connect directly as expected, so don’t assume the connection has failed based on a single page.

If apps can connect to the internet but your browser can’t, check whether a browser proxy extension is overriding the system proxy. If necessary, temporarily disable the extension and try again. The browser’s secure DNS may use a separate resolution path, but it does not replace the proxy. Incognito mode can help rule out some cache and extension issues, but it won’t automatically change your exit IP.

4. Troubleshoot connection failures in order

First turn off the proxy to confirm that your local network is working. Then update the subscription, check the system time, and review the logs. If a connection times out, try another node; if authentication fails, check your credentials; if the configuration fails to parse, check its format and version. If only some apps bypass the proxy, check whether the client is using the system proxy or TUN/VPN mode, and whether it has the required permissions. Change only one setting at a time and record the result after testing. This makes problems easier to pinpoint than changing DNS, routing, and browser settings all at once.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top