How to Import Nodes in sing-box: Subscription Setup, Config Files, and Connection Troubleshooting

How do you import a node into sing-box? This guide explains the differences between subscription URLs, single-node share links, and JSON configuration files, shows how to import each using the methods supported by your client, and covers how to troubleshoot “connected, but webpages won’t load.” Buttons and import options vary across sing-box graphical clients, so the steps below describe common workflows rather than treating any one interface as the standard.

1. Check your client and link type first

Go to the download page via the project’s official website or code repository, then install the client for your device’s operating system. Note that the sing-box core and a graphical client are not the same thing: the core usually has no interface for scanning QR codes or pasting subscription links. If you’re a typical user, choose a graphical client with clear documentation that is actively maintained.

  • Subscription URL: Usually an HTTPS link, but the content it returns may be a sing-box configuration or a format intended for another client.
  • Single-node link: Common formats include vless://, vmess://, and trojan://. The client must be able to parse the relevant format.
  • Configuration file: Usually JSON. It may include nodes, routing, DNS, and other settings—not just a server address.

A link that imports into another app isn’t necessarily supported by a sing-box client. When getting free nodes, check which formats the provider supports. The free node information on this site can be used as a starting point for testing, but availability depends on the actual connection results.

2. Import nodes based on what you have

  1. Open the client and go to “Configuration,” “Profiles,” or a similar page, then choose to add a configuration. If there’s no graphical interface at all, check whether you downloaded the core program instead.
  2. If you have a subscription URL, choose “Import from URL,” “Remote Configuration,” or a similar option. Paste the full link and save it. If the provider offers a format option, choose a sing-box format compatible with your client.
  3. If you have a JSON file, choose “Import from File.” Some clients also let you paste configuration text. Don’t paste the entire JSON into the subscription URL field.
  4. If you only have a single-node share link, look for “Import from Clipboard” or a QR code scanner. If the client doesn’t support it, ask the provider for a compatible configuration. Don’t assume you can make the link work just by changing its file extension.
  5. After importing, select the configuration and check whether nodes or outbound policies are available, then start the connection. The first time you connect, you may need to approve the system VPN permission request.

A subscription URL may contain a personal token. Don’t post it in public group chats or submit it to unfamiliar conversion websites. Remote configuration updates may also overwrite local changes, so make a backup before editing.

3. Troubleshoot import and connection failures

If you see messages such as “invalid format” or “unknown field,” first check for extra spaces or an expired link, then confirm that the response contains configuration data rather than a login page. A configuration may also fail to load if it’s incompatible with the client’s bundled core version. Check the provider’s requirements and the client’s release notes.

If the configuration loads but you can’t connect, first make sure your device has internet access and the system time is correct, then try updating the subscription or switching to another available node. Avoid running multiple VPN or proxy tools at the same time. When checking logs, look for specific errors such as timeouts, authentication failures, or configuration parsing failures.

4. How IP, DNS, and your browser each affect the result

Whether your IP changes depends on whether the requests actually go through the proxy. In rule mode, some websites may connect directly, so a single IP lookup can’t confirm that all your traffic is being routed through the proxy. DNS resolves domain names. If you can access a site by IP address but not by its domain name, check the client’s DNS settings and logs rather than blindly switching among public DNS servers.

Your browser’s secure DNS, proxy extensions, cache, and cookies can also affect the results. You can temporarily disable conflicting extensions, compare results in a private window, and confirm that the system proxy or VPN is active. A successful import only means the configuration was accepted; it doesn’t mean the node is available or that your browser environment is completely anonymous.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top