How to Import Nodes in sing-box: Subscriptions, Configuration Files, and Connection Troubleshooting Guide

This article addresses the practical question of how to import nodes into sing-box: once you have a subscription URL, JSON configuration, or VLESS link, where should you import it, and what should you check if the connection fails? It also explains the differences between your exit IP, DNS, and browser environment, so you don’t blame every website that won’t open on the node. Menu names may vary across operating systems and client versions, so follow the options shown in your client.

1. First, identify what you have

sing-box is a proxy core, and official graphical clients and third-party clients do not all offer the same import options. Being able to use the sing-box core does not mean a client can import every type of node link directly. When installing, use the project’s official website or release page to find the download for your platform, and avoid modified versions from unknown sources.

  • Full JSON configuration: This usually includes inbounds, outbounds, routing, and other settings. You can try importing it as a local configuration.
  • Subscription URL: Check whether it returns a full sing-box configuration or a format intended for another client.
  • Single node link: Links such as vless://, vmess://, and trojan:// can be imported directly only by clients that support parsing the relevant format.

2. Import a subscription or local file

  1. Open the client, find “Configuration,” “Profiles,” or a similar option, and choose to add a configuration.
  2. If your provider gave you a remote sing-box configuration URL, choose the remote configuration option, paste the full URL, and save it. If the interface has an update button, update the configuration once.
  3. If you have a full JSON file, save it to your device first, then select it using “Import file” or the local configuration option. Do not simply change a node link’s file extension to .json.
  4. Select the new configuration and start the connection. When prompted, grant the system’s VPN or network access permission. Disconnect other VPNs before testing to avoid conflicts.
  5. If the configuration provides a node selection group, choose a route from the client’s node or proxy page, then open a webpage to test it. If there’s no selection option, that doesn’t mean the import failed; the configuration may have a fixed outbound route.

Do not assume that a Clash subscription can be used as a sing-box configuration. If you get a format error, first ask the provider for a compatible format. If conversion is needed, use a trusted tool and check which protocols it supports. Subscription URLs may contain access credentials, so don’t submit them to unfamiliar conversion websites. If you’re using this site’s free nodes, check their format and validity first.

3. What if you only have a single link?

First check whether the client offers “Import from clipboard” or “Scan QR code.” If it doesn’t, don’t keep pasting the link into the remote configuration URL field. Instead, get a full configuration or use a client that explicitly supports that link format. A QR code is only a way to encode content; it does not guarantee that the current client supports that content.

4. Check your IP, DNS, and browser after connecting

A successful import does not mean all your traffic is going through the proxy. First check the logs for errors, then use an IP lookup page to verify your exit IP. In split-routing mode, different websites may use different exit routes. If the logs show a timeout, check your network connection, node validity, and device time. If they report an invalid configuration field, check the client version and configuration compatibility.

If some domains won’t open, look for DNS resolution failures in the logs. Don’t copy DNS settings from an unfamiliar source without checking them. A browser’s Secure DNS setting or proxy extensions can also change the route your traffic takes. Try temporarily disabling relevant extensions and testing in another browser. An incognito window can help rule out some cookie-related issues, but it does not automatically change your exit IP and cannot replace DNS and routing checks.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top