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

This article explains how to import nodes into sing-box. It distinguishes node links, subscription URLs, and configuration files, shows how to import them using features supported by your client, and covers troubleshooting cases where your IP doesn’t change after connecting, DNS behaves unexpectedly, or webpages won’t load in your browser. Menu names may vary by system and client, so refer to the interface you’re using.

1. Check what you have before importing

sing-box is a proxy core, and clients that use it don’t necessarily support the same import formats. When installing a client, use an official project release channel where possible, confirm that it supports your system, and read its configuration guide. Don’t assume that “uses the sing-box core” means “can directly import every subscription.”

  • Single-node link: Commonly starts with vless://, vmess://, trojan://, or ss:// and requires a client with the corresponding parsing feature.
  • Subscription URL: Usually an HTTPS link. The response may contain a node list, a Clash configuration, or a sing-box configuration, so you can’t determine the format from the URL alone.
  • Configuration file: Usually in JSON format. A correct file extension doesn’t guarantee compatible contents; the file must also match the sing-box version used by the client.

Checking the format before importing is more important than repeatedly clicking Update. If your nodes come from this site’s free nodes page, first check the format notes, last updated time, and compatible clients.

2. Import using a method supported by your client

  1. Install and open the client, go to “Configuration,” “Config Files,” or a similar page, and find the option to add a configuration.
  2. If the client supports “Add from URL,” paste a configuration URL explicitly marked as compatible with sing-box. If it supports other subscription formats, follow the instructions for importing those. Give the configuration a recognizable name, save it, and update it once manually.
  3. If you have a JSON file, select “Import from File” and open it using the system file picker. If validation fails, check the error message first; don’t immediately delete fields you don’t recognize.
  4. If you only have a single-node link, check whether the client has an “Import from Clipboard” or “Add Node” option. If not, ask the provider for a compatible configuration rather than entering the node link as the configuration download URL.
  5. Select the imported configuration and connect. If your system asks for VPN permission for the first time, allow it after confirming that the prompt is from the client you just installed. On desktop, enable the system proxy or TUN as instructed; for initial testing, choose one method at a time.

A subscription URL may contain a personal token. Don’t post it in public comments. Avoid submitting it to online conversion sites of unknown origin, too. If conversion is necessary, use a trusted local tool where possible and confirm that the output format is compatible.

3. After importing, check your IP, DNS, and browser

Open a regular webpage first, then check your public IP. With split routing, domestic sites may connect directly while international sites use the proxy, which can be normal. So checking a single IP lookup page doesn’t prove that all traffic is being proxied. To verify, you can temporarily switch the client to global proxy mode for testing, then restore your previous settings.

If the client reports a successful connection but webpages show a domain name resolution error, first restore the DNS settings recommended by the configuration and check whether your browser has Secure DNS enabled separately. Don’t change DNS, routing, and browser proxy settings all at once—change only one setting at a time to make it easier to identify the problem.

Browser proxy extensions, outdated system proxy settings, and other VPNs may also interfere with the connection. First disable similar tools and proxy extensions, then restart the browser and test again. An incognito window can help rule out some cache or extension issues, but it won’t automatically change your public IP or make you anonymous.

4. What to check if it still doesn’t work

Check in this order: whether the configuration can be updated, whether it passes validation, whether the connection log shows errors, and whether other nodes work. If the download fails, check the URL and network. If fields are incompatible, obtain a configuration for the matching version. If the connection times out, try another node to verify. When asking for help, include your system, client version, and a redacted error message. Hide subscription tokens, passwords, and UUIDs. Free nodes may not always be available, and a successful import doesn’t guarantee a reliable connection.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top