月神云 - 全终端加速服务

sing-box 怎么更新订阅？按平台刷新 Remote 配置并排查失败

更新于 2026-11-03 · moontoday.store

简答：如果你已经把订阅保存为 sing-box 的 Remote 配置，先进入客户端的 Profiles/配置文件页面，选中该 Remote 配置，点击 Update、更新或刷新；完成后查看最后更新时间和节点数量，再重新选择节点并启动连接。不同客户端的菜单名称可能不同，Windows、Android、iOS、macOS 的具体入口以当前客户端界面为准。

定义：sing-box 更新订阅，是重新请求已保存的远程配置 URL，并用返回内容更新本地 Remote Profile；它不同于升级 sing-box 客户端软件本身。

先试这一步：找到 Remote 配置并手动刷新

本文讨论的是已经添加过远程订阅、现在想刷新节点或配置的情况，不是安装 sing-box 软件，也不是修改本地 JSON 文件。官方图形客户端把远程配置称为 Remote Profile：它以 URL 作为更新来源，并支持自动更新；官方统一客户端文档给出的默认自动更新间隔是 60 分钟，但实际按钮、默认值和页面位置可能随客户端及版本变化。sing-box 图形客户端通用文档

  1. 打开 sing-box 客户端，进入名为 Profiles、配置文件、Configurations 或类似名称的页面。
  2. 找到类型为 Remote 的配置，不要误选 Local、本地文件或 iCloud 配置。
  3. 打开该配置的详情或更多操作菜单，寻找 Update、更新、Refresh、重新获取 等按钮。
  4. 等待请求完成，查看最后更新时间、配置预览或节点/出站列表是否重新加载。
  5. 重新选择一个节点或出站组，再启动连接；不要只看到“更新完成”就直接判断网络已经恢复。

如果页面只有“编辑”而没有“更新”，先确认保存的是远程 URL，而不是把订阅内容复制成了本地配置。官方规范要求图形客户端支持 Remote Profile，并建议提供配置内容查看器；但不同客户端的界面路径并未统一规定。Remote Profile 的官方定义

四个平台怎么找更新入口

平台优先查找位置更新后的判断点适用边界
WindowsProfiles/配置文件 → Remote 配置 → Update/更新最后更新时间变化，配置预览或出站列表重新载入官方 Windows 桌面客户端仍应以当前项目页面和实际界面为准；官方仓库将其描述为实验性 Windows 客户端。
AndroidProfiles/配置文件 → 远程配置 → 更新或刷新配置更新时间、节点数量或出站名称变化官方 Android 客户端可管理本地或远程 sing-box 配置；若开启 VPN/TUN，不代表订阅请求本身一定成功。
iOSProfiles/配置文件 → Remote 配置 → 更新；部分版本也可能在配置详情页操作远程配置重新载入，再启动 Network ExtensionApple 客户端存在 iOS 与 macOS 差异，菜单名称需按当前应用显示。
macOSProfiles/配置文件 → Remote 配置 → Update/更新更新时间变化，启动后状态从停止变为运行macOS 独立客户端的数据迁移和应用来源可能影响原有配置是否保留，升级后应先确认 Remote URL 仍存在。

这些平台都应围绕同一个判断逻辑操作：先确认配置类型是 Remote，再执行更新，最后验证返回内容是否被加载。官方资料显示，Android 客户端支持管理本地或远程配置；Apple 客户端的代码也包含 Remote URL、自动更新开关、更新间隔和配置校验字段。Android 客户端文档 Apple 客户端 Remote 配置实现

手动更新和自动更新有什么区别

手动更新适合刚更换订阅、刚修复链接、节点列表突然为空，或需要立即确认服务端配置是否变化的情况。点击更新后，重点看请求是否成功以及返回内容是否被解析。

自动更新适合订阅地址长期不变、希望客户端定期检查配置的情况。进入 Remote 配置的编辑页面，寻找 Auto Update、自动更新 或更新间隔设置；开启后保存，再观察下一次更新时间。官方通用文档要求图形客户端支持自动更新，并把默认间隔写为 60 分钟，但不要把这个默认值当成所有发行版或当前版本的固定界面设置。官方图形客户端通用说明

自动更新不等于自动连接。更新动作只是重新获取配置；更新后是否启动、是否获得系统 VPN 权限、是否选择了可用出站，仍要单独检查。Android 客户端的 TUN 功能依赖系统 VpnService，Apple 客户端则使用 NetworkExtension，因此系统授权和运行状态应在连接失败时另行确认。Android TUN 与服务说明 Apple 客户端网络扩展说明

更新前后怎么验收：不要只看“成功”提示

  1. 更新前记录：记下当前配置的最后更新时间、节点或出站名称，以及当前正在使用的节点。
  2. 执行更新：在 Remote 配置详情中点击 Update/更新，等待结果提示结束。
  3. 检查返回内容：确认没有出现 401、403、404、超时、JSON 解析失败或配置校验失败。
  4. 检查配置变化：查看更新时间、配置预览、节点数量或出站名称。若服务端没有变化，节点列表不变并不一定代表更新失败。
  5. 重新选择并启动：选择一个节点或出站组，启动客户端并观察运行状态。
  6. 复测连接：先访问一个普通网页或执行应用内连接测试；若更新成功但无法联网，再进入连接、DNS、TUN 或系统代理方向排查。

一个简单的记录表可以帮助区分问题：

观察结果优先判断下一步
最后更新时间不变没有发起更新、链接请求失败或后台更新未执行重新打开 Remote 详情，手动点击更新并查看日志或错误提示
更新时间变化但节点仍旧服务端配置本次没有变化，或客户端缓存/解析结果未刷新对比配置预览、重新进入页面，必要时停止后再启动
更新成功但无法联网订阅获取成功，问题转移到节点、DNS、路由、TUN 或权限换一个出站复测，再检查系统 VPN/TUN 授权和连接日志
节点列表为空格式不匹配、返回内容为空或配置解析失败在服务商后台重新复制适用于 sing-box 的链接，并核对返回格式

订阅更新失败：按错误现象分流

1. 链接失效、401、403 或 404

这类结果通常说明远程 URL 不再可访问、需要认证、路径已改变，或订阅凭据已失效。不要直接反复删除客户端；先在提供订阅的管理页面重新复制链接，再回到 Remote 配置中编辑 URL。若链接包含 Token，不要把完整地址发到群聊、工单截图或公开仓库；怀疑泄露时，应在提供方后台重置或重新生成。

2. 超时、网络错误或 DNS 解析失败

先确认设备本身能打开其他网页，再临时切换网络复测。若客户端正在运行 TUN 或 VPN，可能需要先停止连接，再更新 Remote 配置；更新成功后再启动。不要把一次超时直接判断为订阅失效，因为请求路径还可能受到当前网络、DNS、系统权限或本地分流影响。

3. 格式错误或配置校验失败

原生 sing-box Remote 配置应返回客户端能够识别的 sing-box 配置内容。Clash YAML、Base64 文本或其他客户端专用格式不能直接假定可用；如果提供方同时给出多种链接，应选择明确标注为 sing-box 的格式。Apple 客户端的公开实现会在创建 Remote Profile 时获取远程内容并执行配置检查，这说明“能打开 URL”与“能被客户端解析”是两个不同步骤。Apple 客户端配置校验实现

4. 更新完成但配置字段报错

这通常需要结合客户端版本、配置写法和错误日志判断。先保留原配置或复制 Remote URL，停止客户端并回滚到上一次可用配置；不要为了绕过报错随意删除 DNS、路由或 TUN 字段。若是升级客户端后出现兼容性问题，应查看对应版本的迁移说明，官方迁移文档会列出部分版本的配置变化和客户端数据迁移事项。sing-box 官方迁移说明

更新成功但还是连不上：不要继续刷新订阅

如果最后更新时间已经变化、配置也能正常加载，说明“订阅请求”这一阶段大概率已经完成。此时继续刷新通常不能解决连接问题，建议按下面顺序排查：

  1. 换一个节点或出站，排除单个节点不可用。
  2. 确认客户端是否真的处于运行状态，而不是只完成了配置更新。
  3. 检查 Android 的 VPN 权限或 Apple 的网络扩展授权；Windows/macOS 则检查系统代理、TUN 或防火墙状态，具体能力以当前客户端为准。
  4. 查看连接日志，区分 DNS 解析失败、握手超时、路由未命中和权限拒绝。
  5. 如果只有部分应用打不开，再检查应用是否使用系统代理、是否被分流规则直连，或是否需要 TUN。

官方客户端资料把配置管理、服务运行和 TUN/网络扩展分成不同功能，因此“订阅更新成功”与“流量已通过代理”不能视为同一结果。官方图形客户端功能划分

安全提醒与回滚方法

订阅 URL 往往同时承担身份识别和配置获取作用，实际权限取决于提供方的设计。把它当作敏感凭据处理：不要公开完整链接，不要在截图中暴露 Token，也不要把远程配置原文提交到公开仓库。

更新前可以复制当前 Remote URL，并记录当前配置名称；更新后如果出现解析错误或连接异常，先停止服务，再恢复原配置或重新添加之前保存的 Remote URL。不要在无法确认来源的页面粘贴订阅链接，也不要为了测试把链接改成不明短链。客户端版本、菜单名称和应用分发渠道截至 2026-11-03 可能继续变化，无法从本文来源核实的具体按钮位置，应以当前客户端显示和项目页面为准。

常见问题

sing-box 更新订阅和更新客户端软件是一回事吗？

不是。更新订阅是重新请求 Remote Profile 的 URL，更新节点或远程配置内容；更新客户端软件则是安装新的应用或核心版本。两者入口、风险和排查方法不同。

sing-box 订阅保存后，为什么没有自动更新？

先确认配置类型确实是 Remote，并检查 Auto Update/自动更新是否开启。随后查看最后更新时间和客户端后台运行权限。官方文档规定图形客户端应支持自动更新，但不同平台的后台限制和界面行为可能不同，不能只看配置名称判断。

更新订阅时提示格式错误怎么办？

先确认链接返回的是 sing-box 可识别的配置内容，而不是 Clash YAML、Base64 或其他客户端格式。若提供方有多个订阅选项，重新选择明确标注为 sing-box 的链接；仍失败时查看客户端日志和配置校验错误。

订阅更新成功但节点还是不能用，是否要重新导入？

通常不必立即重新导入。先确认更新时间确实变化，再换节点或出站复测，随后检查 VPN/TUN 权限、DNS、路由和连接日志。更新成功只代表远程配置已获取，不代表每个节点都能建立连接。

Windows、Android、iOS、macOS 的更新按钮一样吗？

不一定。官方统一概念是 Remote Profile，但实际界面可能使用 Profiles、配置文件、Update、更新或刷新等名称。本文给出的是按功能查找的路径，具体菜单以当前客户端版本显示为准。

相关阅读

参考资料

  1. sing-box 图形客户端通用文档：Remote Profile 与自动更新
  2. sing-box for Android 官方客户端文档
  3. sing-box for Android 官方功能说明
  4. sing-box for Apple 官方功能说明
  5. sing-box for Apple Remote 配置创建与校验实现
  6. sing-box 官方迁移说明
  7. sing-box for Desktop 官方仓库说明