This article answers the question “How do I import nodes into sing-box?” It covers importing subscriptions in popular graphical clients, adding a single node manually, and checking your IP, DNS, and browser environment after connecting. Follow the steps below if you’re new to sing-box.
1. What to prepare before importing
sing-box is a proxy core. Many clients provide a graphical interface for it, including clients for Windows, macOS, Android, and iOS, as well as SFI/SFA. Before importing nodes, prepare either a subscription link or a link/configuration for a single node. This site also compiles free nodes for testing. When choosing one, we recommend starting with a node that is geographically close to you and clearly specifies its protocol.
- Subscription link: Usually a long https URL that automatically updates multiple nodes after import.
- Single node: May be a link such as vless://, vmess://, or trojan://.
- Configuration file: Some clients support importing JSON files, but subscriptions are generally easier for new users.
2. How to import subscription nodes into sing-box
The button names vary slightly between clients, but the process is generally the same. Here’s an example using a typical graphical interface:
- Open the sing-box client and go to the “Configuration,” “Profiles,” or “Subscription” page.
- Click “Add,” “Add,” or the plus sign in the top-right corner.
- Select “Import from URL,” “Import from URL,” or “Subscription link.”
- Paste your node subscription URL. You can name it “freevpn-x” or choose a custom name.
- Save it, then click “Update” or “Update subscription” and wait for the nodes to appear.
- Return to the home screen, select a node, and turn on the proxy.
If you have a link for a single node, select “Import from clipboard” or “Add manually.” Some clients automatically recognize vless, trojan, and other links on the clipboard. If yours doesn’t, it may not support converting that format. Try using a subscription link or a client that supports importing share links instead.
3. How to confirm you’re connected after importing
A node showing as connected doesn’t necessarily mean your browser is using the proxy. We recommend checking the following in order:
- Check your IP: Open an IP lookup site and see whether your displayed location has changed. If you still see your local ISP’s IP address, the system or browser proxy may not be working.
- Check DNS: If your IP has changed but you’re still having trouble accessing sites, your DNS may be polluted or leaking. You can enable options such as “Remote DNS” or “Prevent DNS leaks” in the client.
- Check your browser environment: Close and reopen your browser, or test in a private window. Some browser plugins or proxy extensions can override the system proxy.
- Check the mode: Global mode is usually easiest to test. In rule mode, traffic may go direct if no rule matches.
4. Common reasons a connection fails
If a node imported into sing-box won’t work, first check whether the subscription link has expired, the node is no longer available, your device’s clock is correct, UDP is restricted on your network, or your client version is outdated. On phones, make sure the system has granted VPN permission. On computers, check whether the firewall or security software is blocking the client.
Different protocols also have different client requirements. For example, nodes using VLESS Reality or Hysteria2 require a recent sing-box core and the correct import format. If you see errors such as “parse failed” or “unsupported protocol,” the issue is usually client incompatibility or an unrecognized link format, not your network.
5. Tips for getting started
If you’re new to sing-box, start by importing a subscription, then switch to global mode to test your IP. Once you’ve confirmed that it works, switch back to rule mode for everyday use. Don’t run multiple VPN or proxy apps at the same time, as they may conflict over ports. If you keep having trouble, try another node, update the subscription, or switch to a different sing-box graphical client.