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

This guide addresses the practical question of how to import nodes into sing-box. It explains the differences between node links, subscription URLs, and configuration files, and walks you through importing, connecting, and basic troubleshooting. It also explains how IP, DNS, and browser settings can affect the results. Menus vary between sing-box graphical clients on different platforms, so refer to the version you’re using.

1. Check the node format before importing

First, obtain a node or subscription from a trusted source, and install a sing-box client compatible with your device’s operating system. Download it from official project channels whenever possible, and avoid modified versions from unknown sources. The sing-box core and its various graphical clients are not the same thing, so don’t assume that import steps for other clients will apply.

  • Single-node link: Often starts with vless://, vmess://, or trojan://. Whether you can paste it directly depends on the client.
  • Subscription URL: Usually an HTTPS link, but its contents may be a node list, a Clash configuration, or a sing-box configuration.
  • JSON file: May be a complete configuration or just an outbound section. The latter usually can’t be run on its own.

A subscription link is not the same as a universal configuration. If you get a format error during import, first ask the provider whether it supports your sing-box client instead of repeatedly trying again.

2. Import using a method supported by your client

  1. Open the client and go to “Configuration,” “Profiles,” or a similar page, then add a new profile.
  2. If you have a compatible remote configuration URL, select “Import from URL,” “Remote Configuration,” or a similar option. Paste the full link, enter a recognizable name, and save.
  3. If you have a complete JSON file, select “Import from File.” If the client supports clipboard import, you can also copy the full contents and import them that way.
  4. If you only have a single-node link, look for “Add Node” or “Import from Clipboard.” If neither option is available, you usually can’t paste the link directly; obtain a compatible configuration instead.
  5. Update or download the configuration, and check that there are no parsing errors. Then select the configuration and start it. When the system first asks for VPN permission, verify the app’s identity before granting access.
  6. If the configuration provides a node selection page, choose an available node and visit a regular website to check the connection.

Don’t submit subscription URLs or links containing credentials to unfamiliar conversion websites. If you need to convert a format, use a compatible subscription from the provider or a trusted local tool whenever possible. Free nodes on this site should also be checked for format compatibility and validity; their availability isn’t guaranteed.

3. Imported successfully, but websites won’t load?

First, turn off the proxy and check that your local network can access the internet. Then check the client logs to distinguish between a configuration parsing error, a connection timeout, and a DNS resolution failure. Parsing errors are often caused by an incompatible format or version. For timeouts, try switching nodes or switching between Wi-Fi and mobile data, and check that your device’s clock is accurate.

If the client says it’s connected but websites still won’t load, check whether another VPN or proxy tool is running. Try to run only one tool that takes over network traffic at a time to avoid conflicts with routing or DNS settings. Back up the configuration before changing it, and change one setting at a time so you can identify the cause.

4. How do IP, DNS, and browser settings affect the results?

Whether your exit IP changes depends on the routing rules. With split routing, it’s normal for some websites to connect directly. DNS determines how domain names are resolved; incompatible settings may prevent certain websites from loading. Whenever possible, use the DNS setup in a trusted configuration, and avoid layering additional settings on top of it without a reason.

A browser’s secure DNS, proxy extensions, cache, and login state can also affect the results. Try temporarily disabling proxy extensions, then compare results in a private window or another browser. Private browsing doesn’t automatically change your IP. A changed IP doesn’t mean you’re completely anonymous, so assess the result using both the client logs and your actual browsing experience.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top