This article addresses the question of “how to import nodes into sing-box“: including importing with a subscription link, manually adding nodes, what to do if updated nodes do not take effect, and why you should still check your IP, DNS, and browser environment after connecting successfully. It is suitable for ordinary users who are just starting to use sing-box and want to follow the steps directly.
1. Confirm what you have before importing
sing-box itself is a proxy core, and the interface may vary across different client shells. There are two common situations: one is a subscription link provided by an airport service or node provider, and the other is a single VLESS, VMess, Trojan, Shadowsocks, or similar node link. This site also compiles free node information. It is recommended to prioritize subscriptions that support sing-box or Clash Meta format, as they are easier to import.
- Subscription link: usually starts with https:// and can import multiple nodes at once.
- Single node link: usually starts with vless://, vmess://, trojan://, or ss://.
- Configuration file: may be a json file that needs to be imported as a local configuration in the client.
2. Import sing-box nodes with a subscription link
Client names differ across systems, but the logic is basically the same. Using a common graphical client as an example, you can follow these steps:
- Open the sing-box client and go to the “Configuration,” “Profiles,” “Subscriptions,” or “Configuration Files” page.
- Click “Add,” “New,” or “+” and choose URL, Remote Profile, or Subscription as the type.
- Paste the copied subscription link. For the name, you can use “Free Nodes” or “Backup Subscription.”
- After saving, click “Update Subscription” or “Download Configuration.”
- Return to the home page, select the configuration you just imported, and start the proxy.
- In the node list, choose a node with lower latency that can connect, then open a browser to test it.
If the client reports a format error, the subscription format may be incompatible. Check whether the provider offers a subscription specifically for sing-box, or try a Clash Meta subscription and convert it through the client. Do not paste a webpage URL or article URL as a subscription link.
3. How to manually import a single node
If you only have one node link, first copy the complete link and do not miss any parameters at the end. Then go to “Import,” “Import from Clipboard,” or a similar option in the client. It will usually recognize the protocol, server address, port, and encryption parameters automatically. After importing, it is recommended to rename the node to something easy to recognize, such as “HK-vless-backup.”
If the client does not support clipboard import, you will need to create a new outbound or fill in the fields manually. Ordinary users are not advised to change too many advanced options. Just make sure the address, port, UUID/password, transport method, and security layer match the original node.
4. Why check IP, DNS, and browser environment after connecting
Successfully importing a node does not mean the environment is completely normal. After starting the proxy, first open an IP lookup website to confirm that the displayed exit region roughly matches the selected node; then run a DNS leak test to make sure DNS is not still going through your local ISP. If some websites still behave abnormally, check whether WebRTC is enabled in the browser, whether you have installed extensions that modify the proxy, and whether old system proxy settings still exist.
Common troubleshooting order: first update the subscription, then switch nodes; if it still fails, restart the client; then check system time, network permissions, firewall, and DNS settings. On mobile, also confirm that VPN permission has been granted. On desktop, make sure only one of system proxy or TUN mode is enabled to avoid conflicts.
5. Quick fixes for import failures
- Download failed: switch networks, turn off the proxy and try again, or check whether the subscription link has expired.
- Nodes appear but cannot connect: switch nodes and confirm that the protocol is supported by the client.
- Can connect but webpages will not open: check the rule mode and switch to global mode for testing first.
- Unstable speed: update the subscription, choose a lower-latency node, and avoid peak hours.
Summary: the key to importing nodes into sing-box is to first distinguish between subscriptions, single nodes, and configuration files, then use the corresponding import entry in the client. After importing, do not just look at “Connected”; also check your IP, DNS, and browser environment so you can determine whether the proxy is actually working properly.