How to Import Nodes into sing-box: Subscription Setup, Config Files, and Connection Troubleshooting

This guide addresses the practical question of how to import nodes into sing-box. It covers importing subscription links, configuration files, and individual nodes, and explains how to check your IP, DNS, and browser environment after connecting. Menu names may vary across platforms and graphical clients, so first confirm that your client is based on sing-box and check which import formats it supports.

1. Check the node format before importing

The sing-box core primarily reads configuration files and may not provide a graphical interface. If you’re an everyday user, choose a graphical client from a trusted source that is still maintained. After installation, check the “Configuration,” “Subscriptions,” or “Profiles” page, along with the client’s format documentation.

  • Subscription link: These usually start with https://, but the returned content may be a Clash configuration, a node list, or sing-box JSON. You can’t tell which just by looking at the URL.
  • Configuration file: This is generally JSON and needs to contain a complete configuration that the client can recognize. A server address and password alone are usually not enough.
  • Individual share link: Links such as vless://, vmess://, and trojan:// can be pasted directly only if the client has a built-in parser.

Not every sing-box client can directly import Clash subscriptions or individual share links. If the provider lets you choose a format, get a configuration compatible with sing-box and your current client version.

2. Import using a subscription link

  1. Copy the subscription URL from a trusted source. Avoid copying extra spaces, line breaks, or explanatory text.
  2. Open the client’s configuration management page and choose “Add Configuration,” “Remote Configuration,” or a similar option.
  3. Enter a recognizable name, paste the URL into the URL field, save it, and download or update the configuration.
  4. Confirm that the configuration downloaded successfully and select it from the configuration list. If there’s a separate node selection page, choose an available node.
  5. Click Start, allow the VPN connection when prompted by your system, and then open a webpage to verify the connection.

Updating a subscription does not automatically enable it. After the download succeeds, make sure the new configuration is the one currently in use. If parsing fails, first check the format and version instead of repeatedly trying to connect.

3. Importing a file or an individual node

If you have a complete JSON file, select “Import from File” on the configuration page, choose the file, then save and enable it. If the client offers a validation feature, check the configuration first. Simply changing the file extension to .json won’t change its actual format.

If you have an individual share link, try the “Import from Clipboard” or QR code option. If neither is available, the client likely doesn’t support direct parsing; ask the provider for a compatible configuration. Avoid submitting links containing passwords to unfamiliar online conversion sites.

4. Check your IP, DNS, and browser after connecting

First, check for a VPN indicator and confirm that the client started without errors. Then visit an IP lookup page. In global proxy mode, the page should generally show the proxy’s exit IP. In rule-based routing mode, some websites may still show your local IP; this doesn’t necessarily mean something is wrong.

If your IP has changed but domain names won’t load, check the logs for DNS timeouts or resolution failures, and see whether your browser’s “Secure DNS” setting conflicts with the configuration. It may change the DNS resolution path, but enabling or disabling it cannot be assumed to be safer in every case.

If only one browser is behaving abnormally, temporarily disable proxy extensions, check its independent proxy settings, or compare results in a private window. Cookies, sign-in status, and location permissions can also affect the region a website displays, so page language alone doesn’t indicate your exit location.

A recommended troubleshooting order is: import format, configuration status, node availability, DNS, and browser settings. When asking for help, include the client version and redacted logs. Don’t share your subscription URL, password, or complete node link.

Leave a Comment

Your email address will not be published. Required fields are marked *

中文 EN
🚀

RedGate VPN

免费节点太挤太慢?
升级高速稳定专线

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top