This guide addresses the practical question, “How do I import nodes into sing-box?” After getting free nodes, a subscription link, or an individual share link, you’ll learn how to import it into a sing-box client and connect. It also explains why the IP address, DNS, and browser environment you see after connecting can affect test results, with step-by-step instructions suitable for first-time users.
1. First, check what type of link or file you have
sing-box is a proxy core, and its interface varies slightly across clients. Common sing-box GUI clients for Android, Windows, and macOS usually support importing subscriptions or configuration files. Before importing, check what type of node information you have:
- Subscription link: Usually a URL starting with https:// that contains multiple nodes.
- Individual node link: Commonly uses protocols such as vless://, vmess://, or trojan://.
- JSON configuration: A complete block of sing-box configuration text, usually imported as a configuration file.
If you’re using the free nodes provided on this site, we recommend copying the subscription link. It’s easier to update the nodes later, so you won’t have to add them again manually each time.
2. General steps for importing nodes into sing-box
Button names may vary between clients, but the process is largely the same. Here are the steps for the most common method: importing a subscription.
- Open the sing-box client and go to the “Configuration,” “Profiles,” or “Subscriptions” page.
- Click “Add,” “New Profile,” or the plus sign in the upper-right corner.
- Select “Import from URL,” “Remote Profile,” or “Subscription Link.”
- Paste your subscription URL. You can name it “freevpn-x nodes” or choose a name of your own.
- Save it, then click “Update Subscription” or “Download” and wait for the client to retrieve the configuration.
- Return to the home screen, select the imported profile, and click Start or Connect.
If you only have an individual node link, choose the corresponding protocol under “Add Node Manually” and paste the link. If the client doesn’t support importing individual links, use a compatible conversion tool to generate a sing-box configuration and then import it. Don’t submit your node details to untrusted websites.
3. Imported successfully, but webpages won’t load?
A successfully imported node doesn’t necessarily mean you can access the internet. Try troubleshooting in this order:
- Check that the subscription updated successfully: If the download failed, your network may be unable to reach the subscription URL. Try another network or try again later.
- Test another node: Free nodes may be temporarily unavailable, so try connecting to a different one in the list.
- Check whether the system proxy or TUN mode is enabled: Whether your browser uses the proxy depends on whether the client is routing system traffic through it.
- Close other VPN or proxy apps: Running multiple proxies at once can cause port conflicts.
- Check that your system clock is correct: A significant time discrepancy can cause TLS handshakes to fail.
On Windows, some apps may bypass the proxy if only “System Proxy” is enabled. TUN mode routes traffic from more apps, but it also depends more on virtual network adapter permissions.
4. How do IP, DNS, and your browser environment affect results?
When you connect through sing-box, websites will usually see the proxy’s exit IP address rather than your local broadband IP. But if DNS queries aren’t routed through the proxy correctly, you may experience a DNS leak: your IP appears to be in another country, while your DNS still shows your local ISP. We recommend enabling the built-in DNS in the client settings or using the DNS settings in the configuration file. Don’t switch to an unknown DNS server without a good reason.
Your browser environment can also affect test results. For example, your browser language, time zone, WebRTC, and cached cookies may reveal information that doesn’t match your IP address. Most users don’t need to make extensive changes, but if a website’s security checks are causing problems, try clearing your browser cache, disabling WebRTC to prevent leaks, using a private window, and setting your system time zone to match the node’s location.
After importing a node, first visit an IP-checking website to confirm your exit IP, then test the websites you normally use. If you can’t connect, start by updating the subscription, switching nodes, and checking your DNS and proxy mode. These steps resolve most issues with using imported nodes in sing-box.