How to Import Nodes into sing-box: Subscriptions, Manual Setup, and Connection Troubleshooting

This article explains how to import a node into sing-box and how your IP address, DNS, and browser environment relate to the connection. It’s for users who have just installed sing-box and aren’t sure what to do with a free node or subscription link. Follow the steps below to connect and troubleshoot basic issues.

1. First, identify the type of node you have

sing-box is a core program. On different systems, it’s typically used with a graphical client, such as SFA on Android, or sing-box GUI, NekoBox, or Hiddify on Windows and macOS. Before importing, check which of these you have:

  • Subscription link: Usually starts with http or https. Opening it will update multiple nodes automatically.
  • Single share link: Common formats include vless://, vmess://, trojan://, and ss://.
  • JSON configuration: A complete sing-box configuration file. This is suitable for advanced users; most users should avoid overwriting their configuration without a good reason.

Our site collects free nodes and subscription information, but free resources can be unreliable. We recommend learning how to import and troubleshoot them before deciding whether they work for you.

2. General steps for importing a subscription into sing-box

  1. Install a client that supports sing-box and grant it VPN or network permissions.
  2. Copy your subscription link. Make sure you don’t include extra spaces, line breaks, or Chinese punctuation.
  3. Open the client and go to the “Subscription,” “Configuration,” or “Profiles” page.
  4. Click “Add subscription” or “Add profile,” paste the link, and enter a name that’s easy to recognize.
  5. Save it, then click “Update subscription” and wait for the node list to appear.
  6. Select a node, return to the home screen, and tap Connect.

If you have a single vless:// or similar share link, choose an option such as “Import from clipboard,” “Scan QR code,” or “Add node.” After importing, avoid changing advanced settings at first. Use the default settings to test the connection.

3. After importing a node: checking your IP, DNS, and browser environment

A successful connection doesn’t necessarily mean all your browser traffic is going through the proxy. First, visit an IP lookup site and check whether the displayed exit IP matches the node’s location. If your IP hasn’t changed, the client may not have enabled the system proxy, TUN mode may be off, or your browser may be using its own proxy settings.

DNS can also affect your browsing experience. If you can connect but can’t open websites, or some sites redirect unexpectedly, try enabling the client’s built-in DNS, remote DNS, or DNS routing in rule mode. Most users should stick with the client’s recommended defaults. Avoid running multiple third-party DNS tools at the same time, as they may conflict.

For your browser environment, start by testing in a private window and disabling other proxy extensions. If an extension, the system proxy, and sing-box are all running at once, their rules may conflict. Keeping things simple while testing makes it easier to identify the source of any issues.

4. Quick troubleshooting for connection failures

  • Subscription update failed: Check whether the link has expired and whether your network can access the subscription URL. If necessary, switch networks and try updating again.
  • No nodes appear after importing: The client may not support that format. Try a client that supports sing-box or use a converted subscription.
  • Shows as connected, but you can’t access the internet: Try switching to global mode, enabling TUN, or restarting the client.
  • Only some websites won’t open: Switch nodes, or check your DNS settings and browser proxy extensions.
  • Frequent disconnections: This is common when free nodes are under heavy load. Switch nodes or try again later.

In short, the key to importing a node into sing-box is to identify which of the three types you have: a subscription, a single node, or a JSON configuration. Once connected, check your IP, DNS, and browser proxy settings separately. Following these steps should help you pinpoint most issues, including failed imports, connection failures, and connections that work but can’t access the internet.

Leave a Comment

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

中文 EN
🚀

RedGate VPN

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

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top