This article explains “how to import nodes into sing-box.” Whether you have a subscription link, an individual share link, or a JSON configuration file, you can import it into the sing-box client by following the steps below. You can also check your IP, DNS, and browser environment to avoid situations where you’re “connected but can’t open webpages.”
1. First, check what type of link or file you have
sing-box supports several ways to connect. The interface varies slightly between clients, but the basic steps are the same. Nodes commonly come in three forms:
- Subscription link: Usually an http/https address. Ideal for ongoing use, as you can update your nodes with a single click.
- Individual node link: For example, a vless, vmess, trojan, or ss share link. Useful for adding a node temporarily.
- JSON configuration file: Usually generated by the provider. Once imported, it includes outbound, routing, DNS, and other rules.
We also compile information on free nodes that you can test. We recommend using a subscription whenever possible, as it’s easier to maintain.
2. General steps for importing nodes into sing-box
The names of sing-box graphical clients vary across systems. For example, the interfaces of wrapper clients on Android, Windows, and macOS aren’t identical, but you can generally find an option labeled “Configuration,” “Profiles,” “Subscription,” or “Import.”
- Open the sing-box client and go to the “Configuration” or “Profiles” page.
- If you have a subscription link, select “Add Subscription,” paste the link, save it, and then click Update.
- If you have an individual node link, select “Import from Clipboard.” Copy the node link first, then import it.
- If you have a JSON file, select “Import File,” choose the configuration file, and save it.
- Return to the home page, select the configuration you just imported, and tap Start or Connect.
If the list is empty after importing, the link format may be incompatible, the subscription may have expired, your network may be unable to reach the subscription address, or your client version may be outdated. Try updating the client first, then test another working subscription.
3. Why you should check your IP, DNS, and browser environment after connecting
Successfully importing a node doesn’t mean that all your traffic is being routed through the proxy correctly. After connecting, visit an IP lookup website to confirm whether your outbound IP has changed. If it hasn’t, the system proxy may be disabled, the routing mode may not have taken effect, or your browser may not be using the proxy.
Next, check your DNS. A DNS leak can cause slow page loading, make some websites inaccessible, or lead to incorrect location detection. Most users can enable the client’s built-in DNS or use the recommended default configuration. Avoid changing rules at random.
Your browser environment can also affect access. For example, browser cache, cookies, WebRTC, language, and time zone settings may reveal your actual environment to websites. If you encounter account security checks or a location mismatch, try an incognito window, clear site data, or disable WebRTC to reduce the risk of leaks.
4. Quick troubleshooting checklist for connection failures
- Make sure your phone or computer can access the internet before starting sing-box.
- If a subscription won’t update, switch networks and try opening the link in a browser.
- If a node imports but won’t connect, switch to another node to rule out an individual node being down.
- If the connection succeeds but webpages won’t load, check the system proxy, routing mode, and DNS settings.
- Corporate and campus networks may have more restrictions. Try a different protocol or network.
In summary, there are three main ways to import nodes into sing-box: “add a subscription link, import an individual node, or import a JSON file.” After importing, be sure to verify that your IP has changed, DNS is working properly, and your browser is using the proxy. This will help you pinpoint whether the issue lies with the node, the client, or your local environment.