本文解决“sing-box 怎么导入节点”的常见问题：拿到订阅链接、VLESS 分享链接或 JSON 文件后，该从哪里导入，以及导入成功却打不开网页时如何检查 IP、DNS 和浏览器设置。不同 sing-box 图形客户端的菜单与支持格式不同，操作时应以实际界面为准。
一、先确认客户端和节点格式
先从项目官方渠道安装适合系统的客户端，并确认版本要求。sing-box 是代理内核，使用该内核的图形客户端不一定具备相同的订阅解析能力；命令行程序也没有扫码、粘贴导入等按钮。普通用户建议选择带配置管理界面的客户端。
- 订阅链接：通常为 HTTPS 地址，可能返回完整配置，也可能是节点列表。
- 分享链接：常以 vless://、vmess://、trojan:// 等开头，需要客户端支持解析。
- 配置文件：通常为 JSON，但必须符合当前 sing-box 版本支持的格式。
Clash YAML、节点分享链接和 sing-box JSON 不能直接视为同一种配置。先查看节点提供方标注的格式；本站免费节点也应按实际提供的格式选择导入方式。
二、通过订阅链接导入
- 打开客户端，在“配置”“Profiles”或类似页面找到新增入口。
- 如果支持远程配置，选择“从 URL 导入”或“添加远程配置”，填写名称并粘贴订阅地址。
- 点击下载或更新，检查是否提示解析成功。若失败，先确认链接完整、未过期，并核对返回格式。
- 选中刚添加的配置，按客户端提示启用连接；首次使用可能需要允许系统 VPN 权限。
- 若界面提供节点选择，选取一个节点测试；更新订阅后，再确认当前选中的配置与节点。
订阅能下载，不代表格式一定兼容。如果客户端仅接受完整 sing-box 配置，应向提供方获取对应配置地址，而不是把任意订阅粘贴进去。
三、分享链接和本地文件怎么导入
只有 vless:// 等分享链接时，先查看客户端是否提供“剪贴板导入”或扫码功能。支持时复制完整链接再导入；没有入口或提示不支持，就需要获取兼容的完整配置，不要只把链接改成 JSON 后缀。
已有 JSON 文件时，在配置页选择“从文件导入”，选中文件并执行配置检查。遇到字段不支持、缺少出站等错误，应核对客户端版本与配置适配说明。不要把含密码、UUID 或订阅令牌的内容提交给不可信的在线转换站。
四、导入后无法上网，按这个顺序排查
先断开其他 VPN、代理工具或加速器，避免接管冲突；再检查所选配置是否启用，以及系统 VPN 权限、系统代理或 TUN 模式是否按客户端说明开启。查看日志中的超时、认证失败和配置错误，分别排查节点可用性、凭据与格式。
随后检查 DNS：若日志提示域名解析失败，优先按配置提供方说明核对 DNS 设置，不要同时随意修改多处。浏览器的安全 DNS、代理扩展也可能影响结果，可暂时关闭相关扩展或换浏览器对照测试。
最后用可信的 IP 查询页面检查出口变化，并测试目标网页。IP 变化不等于 DNS、分流和浏览器环境全部正常。若只有个别网站异常，还应检查 Cookie、登录状态和网站限制，不能仅凭一个页面判断节点失效。