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

This article explains how to import nodes into sing-box, what to do when a subscription link isn’t recognized, and how to troubleshoot websites that still won’t load after import. It also covers how your exit IP, DNS, and browser environment can affect connection results. Import options and button names vary between clients, so first check whether you have a single-node link, a subscription URL, or a complete configuration file.

1. Identify the client and node format

sing-box is a proxy core that most users access through a client with a graphical interface. Download and install the client from the project’s official website or release page, and check the format requirements for your version. Don’t assume that instructions for another client will apply.

  • Single-node link: Often starts with vless://, vmess://, or trojan:// and requires a client that can parse that format.
  • Subscription URL: Usually an HTTPS link, but the content it returns may be a list of nodes, a Clash configuration, or a sing-box configuration.
  • Complete configuration: Usually a JSON file that may include routing, DNS, and inbound settings in addition to nodes.

Using the sing-box core doesn’t mean your client can import every format.If you only have a single-node link and your client accepts only complete configurations, ask the node provider for a compatible configuration. Simply changing the file extension won’t help.

2. Import nodes based on their source

  1. Open the client and go to “Configuration,” “Profiles,” or a similar page. Select Add and check whether it offers import from a remote configuration, local file, or clipboard.
  2. For a subscription, choose the remote configuration option, paste the full URL, and save it. Then download or update the configuration. If you get a format error, check that the subscription explicitly supports your client.
  3. For a configuration file, choose the local import option and select the downloaded JSON file. If the client asks you to paste the configuration, copy the entire text—not just the node name or address.
  4. Use clipboard import for a single-node link only if the client explicitly supports parsing it. After importing, check the server address, port, and protocol to make sure no parameters were lost when copying.
  5. Select the newly imported configuration and start the connection. If your system asks for VPN permission, allow it. On desktop, enable the system proxy or TUN as instructed by the client.
  6. If the configuration lets you choose a node, select one manually and test it before opening a webpage to confirm that access works.

A successful subscription update only means the configuration was downloaded; it doesn’t mean the nodes are working. Import free nodes from this site using the format specified for them, and verify availability by testing the connection. Subscription URLs may contain access credentials, so don’t post them in public groups or paste them into unfamiliar conversion websites.

3. If nothing works after import, check your IP, DNS, and browser

Start by checking the client logs. If configuration parsing fails, check the format and version compatibility. If the connection times out, try another node or network, and make sure your device’s clock is correct. Reimporting the same configuration repeatedly won’t help.

Your exit IP can help you check whether traffic is going through the proxy. If your IP hasn’t changed after connecting, the system proxy may not be active, or the site you’re checking may be using a direct-connection rule. This alone doesn’t prove the connection has failed.

If the logs repeatedly show domain name resolution errors, check your DNS settings. The browser’s Secure DNS setting, another VPN, or a proxy extension may affect DNS resolution and traffic routing. Temporarily disable conflicting features to compare results, and avoid changing several settings at once.

Your browser environment doesn’t change the node import format, but it can affect how websites behave. An incognito window can help you rule out issues with cookies and login status, but it won’t necessarily bypass extensions or proxy settings. If needed, try a browser without proxy extensions installed. If only one website is having problems, the site itself may be down or restricting access.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top