Mihomo 订阅怎么更新?按刷新、应用、验证三步处理
简答:Mihomo 订阅更新通常分为“重新下载订阅”和“应用到正在运行的配置”两步:先在配置或订阅管理页面刷新远程订阅,再执行应用、激活或重载;如果仍是旧节点,检查当前配置是否已切换、订阅是否下载成功以及客户端是否重新加载。成功判据是更新时间变化、节点列表出现新内容,并且新节点可以正常建立连接。
定义:Mihomo 订阅更新,是重新获取远程配置或节点列表,并在校验通过后将其应用到当前运行配置的过程。
先试这一步:刷新订阅后再应用配置
本文是第三方使用指南,页面名称、按钮和配置入口可能随客户端版本变化。不要把“订阅刷新”和“Mihomo 内核更新”混为一谈:前者重新获取节点或配置,后者更新运行 Mihomo 的程序文件。
| 使用方式 | 最短操作路径 | 成功判据 |
|---|---|---|
| 图形客户端配置管理 | 打开配置或 Profiles,找到远程订阅,点击刷新;如果有“应用”“激活”或“刷新并应用”,继续执行 | 更新时间变化,节点数量或节点名称出现变化,当前运行配置已重新加载 |
| 命令行管理脚本 | 先查看脚本帮助,再使用脚本明确提供的订阅刷新命令;不要把内核更新命令当作订阅刷新 | 终端显示刷新成功,随后查看状态或日志确认配置已加载 |
| 订阅更新后节点不变 | 检查是否只刷新了远程文件但没有激活当前配置 | 重新激活或重载后,运行中的配置和节点列表同步变化 |
MetaCubeX 的配置管理说明将“导入订阅”“激活配置”和通过校验后重启内核区分开;其界面代码也区分了只重新获取远程文件的刷新操作,以及重新组合当前配置并重启内核的“刷新并应用”操作。可参考 MetaCubeX 的配置管理说明 与 配置刷新与应用代码说明。
Mihomo Party 或其他图形客户端怎么更新订阅
- 确认订阅仍在配置列表中。打开客户端的配置、Profiles、订阅管理或远程配置页面,确认目标订阅没有被删除,也不是手动 YAML 配置。
- 执行手动刷新。在目标远程订阅卡片或配置项旁查找刷新按钮。不同版本可能使用“刷新”“更新”“Refresh”等文字,无法确认时优先查看该客户端的帮助或文档。
- 继续执行应用或激活。如果刷新后只显示更新时间变化,但运行中的节点没有变化,查找“应用”“激活”“切换配置”或“刷新并应用”。官方配置管理实现中,单独刷新可能只更新保存的远程文件,刷新并应用才会重新组合运行配置并重启内核。
- 检查结果。查看更新时间、节点列表和当前活动配置;任选一个新节点进行连接测试。不要只看订阅卡片显示成功,还要确认当前运行配置已经变化。
订阅链接通常包含访问凭据。排查时只展示域名或打码后的路径,不要把完整链接、Token、控制面板密钥或配置文件发布到群组和工单中。官方项目的排障说明也要求提交问题时避免包含订阅 URL 和密钥,可参考 MetaCubeX 项目说明。
自动更新:如果客户端提供远程配置的更新间隔,可在对应配置项中设置间隔并保存。需要注意,自动更新是否同时激活运行配置,取决于客户端实现;如果只更新远程文件而没有应用,节点可能仍保持旧内容。当前官方配置管理代码显示,自动更新间隔以分钟保存,活动配置刷新后可重新组合并重启;具体菜单名称仍以你安装的客户端界面为准。
命令行用户:refresh、restart 和 update 不要混用
如果你使用的是带有订阅管理脚本的 Mihomo 部署,先运行脚本自带的帮助命令确认支持的参数。以公开管理脚本文档为例:
./mihomo refresh:强制刷新当前订阅。./mihomo start:启动并刷新当前订阅。./mihomo restart:重启并刷新当前订阅。./mihomo update:更新或重新安装 Mihomo 内核,不等同于刷新订阅。./mihomo status:查看运行状态、版本和端口。./mihomo logs:查看运行日志。
这些命令属于该管理脚本的命令,不是所有 Mihomo 安装方式都通用。执行前先确认当前目录和脚本来源;如果命令不存在,不要自行修改配置文件,改看你所用客户端或部署脚本的帮助。该脚本文档明确把 refresh 定义为刷新当前订阅,把 update 定义为更新内核,且订阅下载默认使用直连,可参考 该管理脚本的中文命令说明。
如果刷新成功但节点仍未变化,建议按“刷新远程文件—激活当前配置—重启或重载—查看日志”的顺序处理。不要先删除整个配置目录,因为这可能同时丢失订阅链接、覆写设置和运行状态。
订阅更新失败或更新后不生效:按现象排查
| 现象或提示 | 先检查什么 | 处理与回滚 |
|---|---|---|
| 401、403 | 订阅凭据、访问权限、套餐状态或请求头 | 重新复制当前订阅链接并重新导入;不要公开完整链接。旧配置仍可用时先保留,不要立即删除。 |
| 404 | 订阅地址是否已失效、路径是否复制完整 | 从服务提供方控制面板重新复制地址,再用客户端重新导入。 |
| 429 | 短时间内重复请求过多 | 停止连续刷新,等待一段时间后再试;同时检查是否启用了过短的自动更新间隔。 |
| Timeout 或连接超时 | 订阅下载是否走直连、系统代理、防火墙和网络连通性 | 先关闭冲突的系统代理或其他代理软件后重试;若部署脚本规定订阅下载走直连,就不要假设当前节点能代理订阅下载。 |
| YAML 或格式错误 | 订阅返回内容是否为空、是否为支持的配置格式 | 重新导入并执行客户端的校验;校验失败时保留上一次可用配置,确认新配置通过后再激活。 |
| 显示更新成功但节点不变 | 是否只刷新保存文件,当前活动配置是否仍未激活 | 执行“刷新并应用”、激活或重新加载;官方配置管理实现将刷新和应用设计为两个不同操作。 |
排查时采用“现象—检查—判断—处理—回滚”顺序:先记录错误原文,再检查订阅链接和网络,判断是下载失败还是应用失败,最后只修改一个变量并复测。若新配置校验失败,回到旧配置;官方配置管理说明显示,激活前会进行配置校验,只有通过后才重启内核。
更新完成后怎么确认真的生效
- 看更新时间:远程订阅的更新时间应发生变化;如果完全不变,先不要判断节点已更新。
- 看当前配置:确认目标订阅带有活动、启用或当前配置标记,而不是只停留在配置列表中。
- 看节点列表:比较更新前后节点名称、数量或分组是否有变化。没有变化不一定代表失败,也可能是订阅内容本身没有变化。
- 看运行状态:确认内核仍处于运行状态,必要时查看日志,区分下载失败、格式校验失败和重启失败。
- 做一次实际连接测试:只测试一个节点和一个目标,不要在多个设置同时变化时判断结果。
如果刷新后所有节点都超时,先回滚到之前可用的配置,再单独检查网络、DNS、系统代理和节点本身。订阅刷新成功只说明远程内容被获取或保存,不等于每个节点都可用。
常见问题
Mihomo 订阅更新和 Mihomo 内核更新有什么区别?
订阅更新是重新获取节点或配置内容;内核更新是替换运行 Mihomo 的程序文件。通常先处理订阅更新,只有确实需要新内核功能或修复时,才按所用客户端或部署脚本的方式更新内核。
为什么订阅显示更新成功,但节点还是旧的?
常见原因是只重新下载了远程文件,没有把它激活到当前运行配置。先查找“应用”“激活”或“刷新并应用”,再确认活动配置和节点列表是否变化。
订阅链接在浏览器能打开,为什么客户端还是更新失败?
浏览器和客户端可能使用不同的请求头、代理路径、权限状态或网络环境。先检查客户端报错原文,再确认链接未过期、客户端是否要求特定格式,以及订阅下载是否固定走直连。
自动更新间隔设置好了,为什么没有自动生效?
自动更新需要客户端或后台进程持续运行,并且不同实现对“刷新文件”和“应用配置”的处理可能不同。检查更新间隔是否保存、目标配置是否为活动配置,并查看日志或状态页面。
可以直接删除配置文件后重新导入吗?
不建议把删除配置作为第一步。先保留旧配置和订阅信息,重新复制订阅地址并导入;确认新配置通过校验后,再清理不再使用的旧配置。