This article explains how to import nodes into sing-box and why shared use by a team can easily become unstable. Follow the steps below to import a subscription or an individual node on your phone or computer, then use the same troubleshooting checklist to reduce disconnections, connection failures, and configuration issues.
1. Check the node source and format before importing
sing-box supports multiple proxy protocols, but different client apps do not all support the same import methods. The most common options are subscription links, node links copied to the clipboard, and JSON configuration files. For team use, it’s best to standardize on one method to avoid situations where some people import old nodes while others use a new subscription, making issues much harder to diagnose.
- Subscription link: Ideal for keeping multiple users in sync. The administrator only needs to maintain a single entry point.
- Individual node link: Suitable for temporary testing, but not for long-term team use.
- JSON configuration: Suitable when you already have a complete configuration file. Make sure the source is trustworthy before importing it.
If you use the free nodes provided on this site, we recommend copying the subscription or node link first, then importing it into your sing-box client to test it. Free node stability can vary with network conditions, so these nodes are best used as a backup or for temporary testing.
2. General steps for importing nodes into sing-box
Interface labels may vary slightly by operating system, but the process is generally the same. Here’s an example using a typical sing-box graphical client:
- Open the sing-box client and go to “Configuration,” “Profiles,” or “Subscriptions.”
- Click “Add,” “Import,” or the plus sign in the upper-right corner.
- For a subscription, select “Import from URL” and paste the subscription link. For an individual node, select “Import from Clipboard.”
- After saving, click “Update subscription” or “Sync,” then wait for the node list to appear.
- Select a node, return to the home screen, and turn on the proxy.
- Open a browser and visit a test website to confirm that pages load normally.
If the client reports a format error, first check for spaces at either end of the link and make sure you copied it in full. If no nodes appear after importing, the subscription may be empty, the network may be unable to reach the subscription URL, or the client may not support that format.
3. How team use and account environment stability are related
When multiple team members use sing-box, stability depends not only on the nodes themselves, but also on consistency in the account environment. Common issues include frequently switching regions, signing in to the same account from different networks at the same time, or having some people use global proxy mode while others use rule-based proxy mode. These can trigger platform security checks, cause sign-in issues, or invalidate sessions.
We recommend agreeing on three rules as a team: First, use a shared subscription entry point and don’t switch to unfamiliar nodes without approval. Second, group nodes by purpose—for example, use separate groups for research, overseas tools, and testing. Third, avoid switching exit countries or regions repeatedly within a short period. These steps can reduce the chances of being asked to reverify accounts or being repeatedly signed out of websites.
4. Checklist for troubleshooting connection failures
If the import succeeds but you can’t connect, check the following in order:
- Switch to another node in the same group to determine whether the issue is with a specific node or the client.
- Make sure your system clock is accurate, as an incorrect time can affect some connections.
- Check the mode. Beginners should start with “Rule mode” rather than using a global proxy right away.
- Close other VPN or proxy software to avoid port conflicts.
- Update the subscription, restart the client, and try connecting again.
If only one device on the team can’t connect, check that device’s firewall, system proxy, and DNS settings. If nobody can connect, the subscription has probably expired, the nodes may be unavailable, or the upstream network may be experiencing issues.
5. Practical tips
For team use, the key to using sing-box isn’t just importing nodes once—it’s setting up rules that are easy to maintain. Keep one primary subscription and one backup, and update them regularly. When a team member runs into a problem, ask them to share a screenshot of the error and the name of the selected node instead of simply saying, “It doesn’t work.” For important accounts, try to keep the exit region relatively consistent, and don’t rely on free nodes as your only long-term setup.