BerryHub

BerryHub客户端怎么更新订阅？各平台操作与失败排查

更新于 2026-10-30 · berryhub.shop

简答：BerryHub客户端更新订阅，先确认你使用的是订阅链接而不是登录网址，再按平台刷新：Windows和macOS重新粘贴订阅并导入后选中新配置；Android在配置中设置自动更新时间；iOS在“更新—订阅”中开启打开时更新和后台自动更新。更新后要确认新配置出现、已被选中且客户端重新启动或开启代理。

定义：订阅更新，是让客户端重新从订阅链接获取配置、节点或规则；它不同于升级客户端软件，也不等同于重新注册账号。

先看平台：BerryHub订阅更新入口对照表

截至2026年10月30日，BerryHub公开支持页给出的平台和客户端操作如下。页面没有为所有平台统一设置一个名称完全相同的“更新订阅”按钮，因此应按当前客户端界面完成刷新或重新导入。

平台页面写明的客户端更新方式成功判断
Windows页面分别出现“Clash Verge”和“ClashVarge”两种写法进入订阅页面，重新粘贴订阅链接并点击导入，再选中新配置新订阅条目出现，且当前选中的是刚导入的配置
macOSClash Verge进入订阅页面，按住 command + v 粘贴订阅链接并导入，再选中新配置新配置出现并被选中，随后开启系统代理
AndroidClashMeta配置→右上角添加→从 URL 导入；自动更新时间填写 1440配置列表出现新订阅，选中后回到首页启动客户端
iOSShadowrocket设置→更新—订阅，开启“打开时更新”和“后台自动更新”；首次导入可从仪表盘导入到 Shadowrocket订阅能够导入，首页可开启，且可进行连通性测试

Windows和macOS的页面重点是“重新导入”，未明确说明存在统一的单独刷新按钮；如果你的客户端已有更新按钮，可以优先使用该按钮，但按钮名称和位置应以当前界面为准。

来源：BerryHub技术支持页、Windows客户端使用指南、macOS客户端使用指南、Android客户端使用指南、iOS客户端使用指南。

最短操作流程：先更新订阅，再判断是否需要升级客户端

  1. 确认你要更新的是订阅。订阅更新只处理配置、节点或规则；如果是客户端打不开、版本过旧或安装包损坏，那是软件升级或重装问题，不要把两者混为一谈。
  2. 重新获取订阅链接。登录仪表盘后，按页面提供的“一键订阅”或“复制订阅”入口复制。不要复制浏览器地址栏中的登录网址。BerryHub的Windows、Android和macOS指南均把“登录仪表盘—复制订阅”列为前置步骤，见Windows指南和Android指南。
  3. 按客户端执行刷新。Windows或macOS重新粘贴并导入；Android使用“从 URL 导入”并填写自动更新时间；iOS开启订阅自动更新，必要时从仪表盘重新导入。
  4. 选中新配置。导入成功不代表客户端已经使用新配置。需要在配置列表中选中刚出现的订阅，再回到首页启动客户端或开启系统代理。
  5. 做一次低风险验证。先确认配置状态和客户端开关，再用一个普通网页或应用测试连接。若更新后连接异常，先恢复到更新前的配置，不要同时修改规则、DNS、TUN或其他网络设置。

订阅链接属于敏感信息。它可能包含访问凭证，不要发到公开评论区、群聊或截图中；提交工单时只提供脱敏后的错误提示和日志。

按平台操作：哪里重新导入，哪里设置自动更新

Windows：重新导入并选中新配置

打开客户端左侧的订阅入口，按住 CTRL + V 粘贴刚复制的订阅链接，点击导入，随后选中刚导入的订阅。BerryHub公开Windows指南明确给出的流程是“复制订阅—订阅页面粘贴—导入—选中配置”；如果没有成功导入，页面建议重新执行该步骤。客户端名称在支持总页和Windows指南中存在“ClashVarge”与“Clash Verge”的写法差异，具体入口、文件名和版本以当前页面和客户端实际显示为准。

macOS：使用Command键粘贴并重新导入

打开客户端左侧订阅入口，按住 command + v 粘贴订阅链接，点击导入，再选中新订阅，最后从首页开启系统代理。若导入失败，先重新从仪表盘复制一次链接，避免继续使用可能已过期或复制不完整的旧链接。

Android：设置1440分钟自动更新时间

打开 ClashMeta，进入配置，点击右上角添加，选择“从 URL 导入”，在 URL 栏粘贴订阅链接，并在“自动更新时间”中填入 1440，保存后选中刚导入的配置，再回到首页启动客户端。该数值是BerryHub Android指南给出的页面设置，不应当理解为所有客户端的统一标准。

iOS：开启打开时更新和后台自动更新

在 Shadowrocket 中进入设置，找到“更新—订阅”，开启“打开时更新”和“后台自动更新”。首次配置时，BerryHub iOS指南写明可在 Safari 中登录仪表盘，点击一键订阅，再选择导入到 Shadowrocket；导入后回到首页开启，并进行连通性测试。若只是想手动刷新，可先关闭再重新打开客户端，观察订阅是否重新获取；具体按钮名称以当前版本界面为准。

更新成功怎么判断：四项检查比“节点数量”更可靠

节点数量、名称或排序可能随订阅内容变化，不能单独作为“更新成功”的唯一标准。更稳妥的判断是“配置已刷新并被选中，客户端状态正常，实际应用能够完成连接”。

订阅更新失败：按链接、网络、鉴权、客户端顺序排查

  1. 先查链接：确认复制的是订阅链接，不是登录网址；重新从仪表盘复制，避免手动删改字符。
  2. 再查网络：如果客户端无法访问订阅地址，先切换到当前可用的网络环境测试；不要在同一时间修改DNS、MTU、规则和代理模式。
  3. 再查账号和订阅状态：如果链接反复返回错误、配置不再更新或客户端提示鉴权失败，应登录仪表盘查看当前账号和订阅状态；无法确认时，通过页面中的“遇到问题”或“新建工单”反馈。
  4. 最后查格式兼容：不同客户端支持的订阅格式和解析能力可能不同。BerryHub支持页说明用户可以选择其他客户端，但非推荐客户端不一定能获得对应技术指导；如果推荐客户端能导入、其他客户端不能导入，优先回到推荐客户端复现。
  5. 保留回退路径：更新后无法连接时，先选回更新前仍可用的配置，或者关闭客户端后重新启动，再一次只改一个设置。

提交工单时建议提供：设备平台、客户端页面显示的名称、问题发生在导入还是更新阶段、错误提示原文、发生时间，以及脱敏后的必要日志。不要提供完整订阅链接、Token、密码或未遮挡的账号信息。BerryHub Windows指南也建议通过仪表盘新建工单并详细描述问题，见Windows客户端使用指南。

什么时候需要重新复制链接，什么时候只需刷新

现象优先动作不要先做什么
客户端已有订阅，但内容长时间未变化先使用客户端刷新；没有明确刷新按钮时，按平台指南重新导入不要立即重装客户端
导入提示失败或列表没有新配置从仪表盘重新复制完整订阅链接，再导入不要公开粘贴完整链接求助
订阅导入成功但无法连接确认新配置已选中，再检查客户端开关和本地网络不要同时开启多个代理软件
客户端无法启动或界面异常先判断是否为软件安装或版本问题，再考虑重新安装不要把客户端升级误当作订阅更新

推荐使用顺序：先完成订阅更新，再处理连接问题

如果你的目标只是让节点或配置变新，最短路径是：重新复制订阅链接→按平台导入或刷新→选中新配置→开启客户端→做一次实际连接测试。只有当客户端本身打不开、无法保存配置或持续解析失败时，才进入客户端版本、格式兼容或本地网络排查。

本文只整理BerryHub公开支持页当前可核验的操作信息，不声称本站是其官网或官方下载站；客户端名称、菜单和入口可能随页面或软件版本变化，请以当前页面与客户端实际显示为准。

常见问题

BerryHub更新订阅需要重新安装客户端吗？

通常不需要。订阅更新和客户端软件升级是两件事：Windows、macOS主要是重新导入订阅，Android设置自动更新时间，iOS开启订阅自动更新。只有客户端打不开、无法保存配置或版本本身出现异常时，才考虑软件升级或重装。

BerryHub订阅更新时要重新复制链接吗？

如果客户端已有可用订阅且提供刷新功能，可以先刷新；如果没有明确刷新入口、导入失败或配置没有变化，建议重新登录仪表盘复制一次完整订阅链接。不要把登录网址当作订阅链接。

Android客户端的自动更新时间应该填多少？

BerryHub Android公开指南给出的填写值是1440，表示按该页面设置自动更新时间。这个数值是该指南的操作口径，不代表所有Android客户端都使用相同设置。

iOS怎么手动更新BerryHub订阅？

先在Shadowrocket的设置中找到“更新—订阅”，确认“打开时更新”和“后台自动更新”已开启；如果仍未更新，可从Safari进入仪表盘，重新执行导入到Shadowrocket的流程，再回到首页开启并测试连通性。

订阅更新成功但节点不能用怎么办？

先确认刚导入的配置已经被选中，再检查客户端是否真正启动、系统代理是否开启，以及是否同时运行了其他代理软件。若仍失败，切换网络复现并记录错误提示；提交工单时遮盖订阅链接、Token、账号和个人信息。

相关阅读

参考资料

  1. 技术支持 - BerryHub
  2. Windows 10/11 客户端使用指南 - BerryHub
  3. Android 客户端使用指南 - BerryHub
  4. iOS - BerryHub
  5. macOS 客户端使用指南 - BerryHub