This article explains how to import nodes into sing-box. It helps you distinguish between node links, subscription URLs, and configuration files, then walks you through importing and testing a connection. It also explains why your IP, DNS, and browser environment can affect the results. Button names may vary across systems and graphical clients, so refer to the interface you’re using.
1. First, identify what you’ve received
Before installing, download a version compatible with your system from the official sing-box project or a trusted client release page. The sing-box core and graphical clients that use it are different: the core primarily reads configuration files, while graphical clients may offer features such as QR code scanning, clipboard import, and subscription management.
- Node link: Usually starts with vless://, vmess://, trojan://, or a similar scheme, and contains information for a single node.
- Subscription URL: Usually an HTTPS link used to retrieve and update nodes or a complete configuration.
- Configuration file: sing-box uses JSON, but whether a file works depends on its fields, configuration version, and client compatibility.
Not all sing-box clients can directly import share links or Clash subscriptions. Check which formats your client supports before importing. Changing a file’s extension alone does not convert its format.
2. Import according to the format
- Open the client, go to “Configuration,” “Config Files,” or a similar page, and click Add. If you already have a working configuration, back it up first to avoid overwriting it.
- If you have a complete sing-box JSON file, choose the option to import from a file. If the content is on your clipboard and the client supports text import, you can paste it and save it instead.
- If you have a subscription URL, choose Remote Configuration or Import Subscription, paste the link, and download it. If the format isn’t supported, go back to the source page and look for a sing-box-specific option.
- If you only have a node link, use the client’s share-link import feature, if available. If there’s no such option, ask the provider for a compatible configuration. Don’t paste the link directly into a JSON editor.
- After saving, select the configuration and run a validation check or try to start it. If VPN permissions are required, grant them when prompted by your system, then select a node from the available outbound options.
Subscription URLs may contain access credentials. Don’t share screenshots of them or submit them to unfamiliar conversion websites. Import our free nodes using the format specified on the page. Availability depends on whether the connection works in practice.
3. Check your IP, DNS, and browser after connecting
First, open a regular webpage, then visit a trusted IP lookup site and check whether your exit IP is as expected. In split-tunneling mode, some websites may connect directly, so seeing your local IP on one page doesn’t necessarily mean the connection failed. Confirm that the test traffic matches your proxy rules before checking the node status.
DNS translates domain names into addresses. If the client says it’s connected but webpages won’t load, first check whether the DNS servers in your configuration are reachable. Secure DNS in your browser and Private DNS in your system settings may also change the resolution path. We recommend changing only one setting at a time and testing again to avoid switching multiple options at once.
Browser cache, extensions, and existing login sessions can also affect how pages behave. You can cross-check using a private browsing window, but private browsing won’t automatically change your exit IP or guarantee that all network information is hidden.
4. Troubleshoot import and connection failures
If a download fails, first check that the subscription URL is complete and hasn’t expired, and that your current network can access it. If configuration validation fails, check the client version and configuration format. If you still can’t access the internet after starting the client, temporarily disable other VPN or proxy apps, make sure your system clock is correct, and check the logs for messages about connection timeouts, authentication failures, or DNS resolution failures. Remove subscription tokens, passwords, and other sensitive information before sharing logs. After updating a remote subscription, check the configuration again to make sure your custom rules haven’t been overwritten.