Starway星途VPN - 访问海外网络加速 | 全球网络加速服务

sing-box 怎么导入订阅并连接?

更新于 2026-10-28 · xingtu.buzz

简答:先确认服务商提供的是 sing-box 兼容订阅链接,再在客户端添加 Remote Profile,更新配置、选择节点并启动服务。Android 和 iOS 还要允许 VPN 配置,桌面端则要确认客户端已启动;导入成功不等于已经联网,最后必须用浏览器或应用做实际验证。

定义:sing-box 订阅导入,是把远程配置 URL 添加为 Remote Profile,由客户端下载、更新并读取其中的节点、分组和路由设置。

先做这一步:确认订阅格式和客户端类型

本文是面向客户端操作的使用指南,不是任何品牌或服务的官方页面。sing-box 本身既有核心程序,也有按平台提供的图形客户端;官方文档列出的图形客户端包括 Android、Apple 平台、Windows 和 Linux,第三方客户端的菜单名称可能不同。官方图形客户端列表可用于核对下载对象。

导入前的快速判断
检查项应看到什么不符合时怎么做
订阅类型服务商明确写有 sing-box、JSON 或 Remote Profile 兼容说明先询问服务商是否提供 sing-box 专用链接,不要把未知格式直接导入
链接内容通常是一条完整的 HTTPS URL,可能包含账号识别参数不要公开粘贴到群组、截图或不明转换页面
客户端能够添加 Local、iCloud 或 Remote Profile确认安装的是 sing-box 图形客户端,而不是只有命令行核心
设备权限Android 或 iOS 能弹出 VPN 配置授权先允许系统创建 VPN,拒绝授权时通常无法接管系统流量

官方文档把 Remote Profile 定义为以 URL 作为更新来源的远程配置,并说明图形客户端应支持自动更新;默认更新间隔在文档中写为 60 分钟。Remote Profile 说明因此,导入订阅的核心不是把一串节点文字复制到配置框,而是创建一个远程配置档案。

安全提醒:订阅链接通常带有可识别账户的凭据。任何第三方转换、订阅生成或在线检测页面都可能接触该链接;只有在确认其可信、必要且不会保存链接时才考虑使用。若服务商直接提供 sing-box 格式,就不需要为了“转换”而再次提交。

最短操作流程:添加 Remote、更新配置并连接

  1. 备份现有配置。如果客户端里已经有能工作的 Local Profile,先记录配置名称、节点分组和当前模式,避免新配置覆盖旧配置。
  2. 打开配置或 Profiles 页面。寻找 Add、New Profile、添加配置或类似入口;目标类型选择 Remote,不要误选只用于本地 JSON 文件的 Local。
  3. 粘贴订阅 URL。把服务商提供的完整链接粘贴到 URL 或订阅地址字段,名称可填写便于识别的备注。不要在文章示例中公开真实订阅链接。
  4. 保存并更新。点击 Create、Save、Fetch、Update 或同义按钮。成功的最低表现是配置被保存,且能看到配置更新时间或远程配置内容。
  5. 选择该配置并启动服务。在 Dashboard、Service 或主界面选中刚更新的配置,然后启动 sing-box。Android 和 Apple 平台通常会请求系统 VPN 权限,首次出现时选择允许。
  6. 选择节点或分组。如果配置包含 Selector 或 URLTest 分组,在 Groups、Outbound 或节点选择区域选定一个节点;如果只有单一出站,则按配置默认值运行。官方通用客户端说明了 Dashboard 可展示和切换分组,但实际按钮名称会随客户端版本变化。官方客户端功能说明
  7. 验证实际网络。先打开一个普通网页,再测试目标应用;同时观察客户端的连接数、流量计数或日志。仅显示“Running”、能更新订阅或能看到节点,都不能单独证明业务流量已经成功通过。

如果你只有 Clash 或其他通用订阅,不要默认它一定能被 sing-box 直接识别。优先向订阅提供方索取 sing-box 格式;只有在没有专用格式时,才考虑使用可信的转换方案,并确认转换后的字段、协议和规则与当前客户端版本兼容。转换后的配置如果报 JSON、字段或出站错误,应回到原始订阅格式和服务商支持范围核对。

按设备操作:Android、iOS、Windows 与 macOS

Android

  1. 打开 sing-box Android 客户端的配置或 Profiles 页面。
  2. 新增 Remote Profile,填写订阅名称和完整 URL,然后保存或创建。
  3. 执行更新,确认远程配置已经下载并出现节点或分组。
  4. 回到主界面选择配置和节点,启动服务。
  5. 首次启动时允许 Android 创建 VPN;如果使用按应用代理,再检查应用是否被加入代理或直连列表。

官方 Android 客户端通过 Android VpnService 提供需要 TUN 时的 VPN 能力,也支持按应用选择代理或绕过。Android 客户端功能说明如果状态显示运行但某个应用没有流量,先检查应用分流,而不是立即修改 DNS 或 MTU。

iOS

  1. 在配置管理区域新增 Remote Profile,或使用客户端提供的导入方式添加远程 URL。
  2. 保存后手动更新一次,确认配置内容和节点分组已出现。
  3. 在主界面选中配置和节点,启动服务。
  4. 按系统提示允许添加 VPN 配置;如果之前拒绝过,需要到系统设置中的 VPN 或相关网络权限区域重新允许。
  5. 用 Safari 或其他应用进行实际访问,并观察客户端流量是否变化。

Apple 平台的客户端、应用名称和分发方式可能随版本变化;macOS 还可能区分独立版本和商店版本。官方客户端页面列出的平台范围和下载入口应作为当前版本核对依据。官方客户端列表

Windows

  1. 安装能够管理图形配置的 sing-box for Desktop,而不是只下载命令行核心。
  2. 在配置管理界面新增 Remote Profile,填入订阅 URL 并保存。
  3. 执行更新,检查配置是否出现节点、分组和出站。
  4. 选择配置与节点后启动服务;若要接管系统流量,再按客户端提供的 TUN 或系统代理选项操作。
  5. 用浏览器访问测试页面,并检查日志中是否有 DNS、TLS、超时或认证错误。

官方桌面客户端说明其用途是管理和运行本地或远程 sing-box 配置,并提供包括 TUN 在内的平台功能;其要求页面列出 Windows 10 及以上系统。桌面客户端说明

macOS

  1. 确认使用的客户端版本支持远程配置和当前 macOS 系统。
  2. 新增 Remote Profile,保存订阅地址并执行更新。
  3. 选择配置和节点,启动服务。
  4. 按系统提示允许网络扩展或 VPN 相关权限;未授权时,配置可能已下载但流量仍未接管。
  5. 先验证浏览器,再验证具体应用;若只有部分应用异常,检查规则和应用分流。

导入后不能连接:按现象分流

常见现象与处理顺序
现象先检查下一步
无法保存或更新订阅URL 是否完整、网络是否能访问订阅地址、客户端是否支持 Remote Profile重新复制链接,确认账户未过期,并向提供方索取 sing-box 格式
配置更新成功但没有节点返回内容是否为空、格式是否为 sing-box、是否被错误转换查看日志或配置预览,停止继续修改 TUN、DNS 等无关项目
能看到节点但启动失败日志中的 JSON、字段、协议、认证和 TLS 错误重新更新配置,确认客户端与配置字段适配;不要直接套用别人的配置
显示运行但网页打不开VPN 权限、节点选择、代理模式、系统代理或 TUN 状态先换一个节点,再分别测试浏览器和其他应用,观察是否有连接记录
只有部分应用不能用Rule、Global、Direct 模式以及 Android 按应用分流暂时使用明确的全局或规则模式做对比,完成测试后恢复原模式
更新后突然失效远程配置是否发生变化、客户端是否升级、节点认证是否过期保留旧配置作为回滚,记录更新时间和日志,再向提供方核对

最安全的排查顺序:先确认订阅可下载,再确认配置能解析,再确认节点能启动,之后确认 VPN 或系统代理权限,最后才处理 DNS、MTU、规则和分流。不要把 ping 成功、节点列表出现或客户端显示 Running 当作完整可用性证明。

如果你需要临时关闭 TUN 或切回直连进行对比,只把它当作缩小范围的测试:测试完成后恢复原模式,并确认没有遗留系统代理、VPN 或 DNS 设置。修改管理员权限、系统扩展或网络路由前,应先备份配置并记录原状态。

常见问题

sing-box 订阅链接可以直接粘贴到任意客户端吗?

不一定。订阅链接可能对应 Clash、sing-box、V2Ray 或其他格式。应先确认服务商是否明确提供 sing-box 兼容格式;如果格式不匹配,客户端可能无法解析、分组为空或启动失败。

导入成功但没有连接,问题一定是节点失效吗?

不一定。还可能是没有执行更新、没有选择节点、系统 VPN 权限未允许、规则使用了 Direct、TUN 或系统代理未启用,或者配置字段与客户端版本不匹配。应按“配置—节点—权限—模式—日志”的顺序排查。

Android 和 iOS 为什么都要允许 VPN 配置?

移动系统需要通过 VPN 或网络扩展接口把符合规则的流量交给客户端处理。拒绝授权时,订阅仍可能显示已导入,但应用流量不会按该配置运行。

订阅需要多久更新一次?

Remote Profile 是否自动更新由客户端和配置管理方式决定。官方通用说明给出了默认自动更新间隔,但不同版本可能提供手动更新、定时更新或关闭更新选项。首次导入后建议先手动更新,并在配置页面确认最后更新时间。

只有 Clash 订阅时,是否必须找转换站?

不是必须。优先向订阅提供方索取 sing-box 格式;只有没有专用格式时,才考虑可信转换方案。订阅 URL 可能包含账户凭据,不要随意提交到不明第三方页面。

结论与下一步

sing-box 导入订阅的关键不是“把链接粘进去”,而是确认格式、创建 Remote Profile、更新配置、授权 VPN、选择节点并完成真实网络验证。遇到问题时先看日志和配置状态,再处理 DNS、规则或 TUN,通常比反复更换参数更容易定位原因。

如果仍无法连接,请保留客户端版本、设备系统、配置更新时间、错误日志和测试节点名称,再向订阅提供方核对格式与账户状态。不要公开完整订阅 URL。

常见问题

sing-box 订阅链接可以直接粘贴到任意客户端吗?

不一定。先确认链接是 sing-box 兼容格式;Clash 或其他格式可能需要服务商提供专用链接,不能默认直接导入。

导入成功但没有连接,问题一定是节点失效吗?

不一定。还要检查配置是否更新、节点是否选中、VPN 权限、代理模式、TUN 或系统代理状态,以及日志中的认证和解析错误。

Android 和 iOS 为什么要允许 VPN 配置?

移动系统需要通过 VPN 或网络扩展接口接管符合规则的流量。拒绝授权时,配置可能已导入,但应用流量不会真正经过客户端。

只有 Clash 订阅时,是否必须使用转换站?

不是。优先向订阅提供方索取 sing-box 格式;必须转换时也要注意订阅链接含有账户凭据,不要提交给不明第三方页面。

相关阅读

参考资料

  1. sing-box 官方图形客户端列表
  2. sing-box 官方通用客户端与 Remote Profile 说明
  3. sing-box 官方 Android 客户端功能说明
  4. sing-box 官方桌面客户端说明