This article explains how to import nodes into sing-box and why you should also check your IP, DNS, and browser environment after importing them. It’s for everyday users who have just installed sing-box and aren’t sure what to do with a free node or subscription link.
1. Before you start: Check whether you have a node or a subscription
sing-box supports multiple proxy protocols, but the import process varies slightly between client apps. There are two common types: a single node link, such as vless://, vmess://, or trojan://; and a subscription link, usually an HTTPS URL containing multiple nodes. This site collects information about available free nodes. You can copy a node or subscription as instructed on the page, but free nodes can be unreliable, so try another node if your connection fails.
- Single link: Best for temporary testing. Copy it and import it into the client.
- Subscription URL: Best for updating multiple nodes in one go; generally the recommended option.
- JSON configuration: Import the complete configuration file, and avoid changing its format.
2. General steps for importing nodes into sing-box
Common clients for different platforms include SFI, SFA, NekoBox, and sing-box GUI panels. Menu names may vary, but the process is generally the same.
- Open the client and go to “Configuration,” “Profiles,” “Subscriptions,” or “Nodes.”
- Tap the plus button in the upper-right corner, then choose “Import from clipboard,” “Add subscription,” or “Import configuration.”
- Paste the node link or subscription URL. For subscriptions, give it a recognizable name.
- Save it, then update the subscription and wait for the node list to load.
- Select a node, return to the home screen, and start the proxy or VPN mode.
- Visit an IP-checking website in your browser to confirm that your exit IP has changed.
If no nodes appear after importing, first check that you copied the entire link, including any parameters at the end. If you get a format error, the link may not be supported by your current version of the sing-box client. Try another client or use a subscription converter, but don’t upload private subscriptions containing sensitive information to untrusted websites.
3. How your IP, DNS, and browser environment are connected
Successfully importing a node doesn’t necessarily mean your browser environment is “clean.” A proxy mainly changes your exit IP—the apparent source of your connection to a website. DNS translates domain names into IP addresses. If DNS requests go through your local ISP, you may experience DNS leaks or resolution issues. Your browser environment also includes information such as your language, time zone, cache, cookies, and WebRTC settings.
Here’s what everyday users can do: After enabling sing-box’s system proxy or VPN mode, make sure the client is handling your DNS settings. Disable unnecessary browser extensions to avoid running multiple proxy extensions at once. When testing a new node, use a private window to minimize interference from old cookies. If your IP has changed but a website still says your region doesn’t match, check your DNS, browser cache, and account’s previous environment—the node itself may be working fine.
4. Quick troubleshooting for connection failures
- Try another node from the same subscription to check whether only one node is down.
- Check that your phone or computer has the correct time. An incorrect time can cause TLS handshake failures.
- Turn off other VPNs, accelerators, and proxy extensions to avoid port conflicts.
- Switch networks—for example, from Wi-Fi to a mobile hotspot—to rule out local network restrictions.
- Update the subscription or copy the node link again in case the configuration has expired.
If the app reports a permissions issue when you start it, allow VPN access on mobile devices. On computers, check whether your firewall or antivirus software is blocking it. If you connect successfully but can’t open any web pages, check the routing mode and DNS first. If some websites work but others don’t, try global mode. Following these steps should help you troubleshoot most sing-box node import and basic connection issues.