This article explains how to import nodes into sing-box, including importing from a subscription link or configuration file, as well as common troubleshooting steps related to IP addresses, DNS, and browser settings. It’s intended for first-time sing-box users—just follow the steps below.
1. What to prepare before importing nodes
sing-box is a proxy core. On most platforms, it’s used with a graphical client, such as a sing-box client for Android, Windows, or macOS, or another tool that supports the sing-box core. Before you begin, make sure you’ve installed a client and have one of the following types of node information ready:
- Subscription link: Usually starts with https:// and provides multiple nodes when opened.
- Single node link: In formats such as VLESS, VMess, Trojan, or Shadowsocks.
- JSON configuration file: Typically config.json or a configuration exported from a client.
This site curates free nodes and subscription information for testing, but the reliability of free nodes depends heavily on your network environment. We recommend testing nodes individually after importing them.
2. How to import subscription nodes into sing-box
- Open your sing-box client and go to the “Configuration,” “Profiles,” or “Subscription” page. The exact name varies by client.
- Select “Add Subscription” or “Add Profile,” then paste your subscription link.
- Enter a name, such as “freevpn-x free nodes,” to make the profile easy to identify later.
- Click Update, Download, or Save, and wait for the client to retrieve the node list.
- Return to the node list and select a node with low latency or one that’s available.
- Turn on the proxy, then open a browser and test access to a website.
If you have a single node link, add it using an option such as “Import from Clipboard,” “Import URI,” or “Scan QR Code.” For a JSON file, select “Import from File,” locate the configuration file, and save it.
3. How to check your IP, DNS, and browser settings after importing
Successfully importing a node doesn’t necessarily mean your browser is using the proxy. First, visit an IP lookup site and check whether your displayed exit IP has changed. If it hasn’t, the system proxy may be off, the browser may be using its own proxy settings, or the client may have started the local core without routing traffic through it.
DNS can also affect your browsing experience. If a website reports that it can’t resolve a domain name, try enabling remote DNS, Fake-IP, or DNS routing under rule mode in the client settings. Most users don’t need to write complex rules; the client’s default template is usually the best place to start. Note that a browser’s DoH Secure DNS may bypass system DNS. If you run into problems, temporarily disable the browser’s built-in DNS and test again.
For browser settings, if you only want your browser to use the proxy, install a proxy extension such as SwitchyOmega and enter the client’s local port. To route all apps through the proxy, enable the client’s system proxy or TUN mode. Don’t enable both methods indiscriminately, as this can create a proxy loop.
4. Quick troubleshooting checklist for connection failures
- Subscription won’t update: Check that the link is complete and whether you need to copy the original subscription URL.
- Nodes import successfully but won’t connect: Try another node. Free nodes may be inactive or congested.
- Shows as connected, but websites won’t load: Check the system proxy, DNS settings, and your browser’s Secure DNS.
- Some websites won’t open: Try switching from rule mode to global mode for testing.
- The client reports an error: Delete the configuration and import it again, or update to the latest version of the client.
In short, importing nodes into sing-box involves getting a valid subscription or node link, importing it through the client, and then confirming that your IP, DNS, and browser are all using the proxy as expected. Following the steps above should help you identify most common issues.