Mihomo CPU 占用高怎么排查?按负载、TUN与回环定位
简答:Mihomo CPU 占用高,先暂停下载并确认高占用进程,再对照关闭TUN;若低流量仍持续异常,按日志验证ICMP、DNS与嗅探回环,每次只改一项。
定义:Mihomo CPU占用高是指核心进程在特定观察条件下持续消耗较多处理器资源的现象,需要结合流量、连接数和触发条件判断原因,而非仅凭一个百分比定性。
先用分诊表判断:下载负载,还是空闲仍异常
最快的第一步是暂停下载、测速和游戏,观察核心CPU与连接数是否一起回落。假如你已经看到风扇持续转动,日志还反复出现read ICMPv4 echo reply,先记录触发条件,再进入对应分支。这段日志在Mihomo问题讨论#2382中出现过,但单独出现一次不能证明回环。本站为第三方使用指南站,不代表客户端或核心开发方。
| 你看到的现象 | 立即验证 | 进入哪个分支 | 结束测试与恢复条件 |
|---|---|---|---|
| 下载时高,暂停后下降 | 记录暂停前后的CPU、速率和连接数 | 先检查下载负载及失败重试 | 恢复同一任务;只有同等吞吐下的结果才可比较 |
| 业务已暂停,低流量仍高 | 确认是核心进程,并保存异常期间日志 | 检查TUN关联,再验证DNS与嗅探 | 找到可重复触发的单一变化后结束扩散修改 |
| 只有开启TUN才高 | 同一应用、同一任务,对照TUN开关 | 进入TUN分支 | 网络功能缺失时立即恢复原开关 |
| 游戏、唤醒或切换网卡后高 | 记录事件顺序,查重复ICMP与异常流量 | 进入ICMP及出口接口分支 | 保存证据后可重启核心恢复使用,再复测触发条件 |
这是建议的排查顺序,不是故障发生率排名。下载连接失败的线索见问题讨论#1586;TUN开关关联的历史报告见问题讨论#1159。
第1步:确认进程,分别记录客户端与核心版本
先确认消耗CPU的是核心,还是客户端界面;两者的版本也要分开记录。Windows任务管理器支持查看进程资源和详细信息,操作依据见微软任务管理器排查说明;macOS可通过活动监视器CPU视图检查。
- Windows:打开任务管理器,进入进程列表并按CPU排序,再到详细信息核对进程名称及PID。正常结果是明确记录某个进程,而不是只截整个应用组的占用。
- macOS:打开活动监视器,选择CPU视图,定位高占用进程并记录名称、PID和CPU变化。入口位置以当前版本界面为准。
- 客户端版本:在所用客户端的版本信息区域记录应用版本;不同客户端界面位置不统一,以当前版本界面为准。
- 核心版本:优先记录核心启动日志中的版本;若已有本机控制面板,可通过其核心信息或已配置的控制API核对。Mihomo的
/version返回核心版本,见API文档,不能拿客户端版本替代。
| 记录项 | 应写什么 |
|---|---|
| 运行环境 | 操作系统、CPU型号、客户端版本、核心版本 |
| 代理状态 | 系统代理与TUN分别是否开启,当前规则模式与选中节点 |
| 触发过程 | 空闲、开始下载、启动游戏、睡眠唤醒或切换网卡的先后顺序 |
| 对照指标 | 同一工具显示的CPU、下载速率、活动连接数和持续时间 |
如果高占用的是界面进程,应先收起连接列表、暂停实时日志显示并比较界面占用;核心占用未变时,结束这条界面分支,转查核心证据。
第2步:暂停下载,区分业务负载与失败重试
CPU下降只有结合吞吐量一起看,才能判断是改善,还是单纯少处理了流量。Steam下载高占用报告#1586包含密集连接失败及socket地址使用错误,因此下载场景应同时检查失败重试,而非直接判定内核缺陷。
- 保持当前配置和节点,记录下载进行时的CPU、下载速率、活动连接数与日志。
- 暂停下载及其他测速任务,使用相同观察时长记录一组空闲数据。建议每组观察约一分钟;这是测试安排,不是故障阈值。
- 打开当前面板的连接列表与日志功能,检查是否仍持续新增相同目标的失败连接。功能位置以当前版本界面为准;相关数据接口见Mihomo流量、连接与日志API说明。
- 恢复原下载任务,再观察CPU是否随流量恢复。若重复出现同一种连接错误,保存错误前后日志并暂停该任务,先处理连接失败。
可检索的错误原文为Only one usage of each socket address。这只是该报告日志中的一段错误,不等于所有Steam下载高CPU都由socket耗尽引起。没有失败重试、暂停后占用稳定回落时,可先归入负载相关,继续比较同等吞吐下的表现。
第3步:对照TUN开关,保留网络功能差异
关闭TUN后CPU下降,只能证明与TUN路径有关,还要确认原业务是否仍经过核心。TUN可通过自动路由接管流量,出口接口也会影响路径,字段含义见Mihomo TUN配置文档。
- 先复制当前配置及覆写内容到本机持久目录,记录TUN原开关、系统代理状态与出口网卡。
- 在当前客户端的网络接管设置中找到TUN功能并关闭;纯核心环境则在测试副本中将现有
tun对象的enable改为false,按原启动方式重新加载。入口与应用方式以当前版本界面为准。 - 重复原任务,记录CPU、吞吐与连接数,同时确认网页、下载或游戏是否还能正常工作。
- 恢复TUN原状态再重复一次。只有异常能随开关稳定出现和消失,才继续沿此分支查路由、DNS或ICMP。
| 对照结果 | 判断与下一步 |
|---|---|
| 关闭后CPU下降,但任务也断网 | 属于不同负载条件,不能认定优化成功;恢复原状态再取证 |
| 关闭后任务正常,但连接记录消失 | 任务可能已绕过核心;记录接管范围变化,不能直接比较性能 |
| 只有切换有线与无线后异常 | 核对实际出口接口;多出口设备的接口选择依据见TUN文档 |
| 开关不影响异常 | 恢复原设置,转到DNS、嗅探及CPU采样 |
如需手动指定出口,先依据全局配置中的出站接口说明核对真实网卡名称;本轮只测试接口选择,保留原值以便恢复。
第4步:游戏或唤醒后异常,先验证重复ICMP
只有重复ICMP日志与高CPU同步出现时,才值得测试禁用ICMP转发。问题讨论#2382涉及游戏、网络切换及重复ICMP记录,维护者说明disable-icmp-forwarding应放在tun下面;讨论中的规避反馈并不一致。
- 验证动作:短时启用调试日志,重复原触发动作,观察相同来源、目标及序列特征的ICMP记录是否密集重复,同时记录CPU与流量。
- 临时测试:仅在已有ICMP证据、且当前核心支持该字段时,在现有
tun对象内将disable-icmp-forwarding设为true,保持原有其他字段。 - 预期结果:重复记录与异常占用同步减少,并且原业务功能仍可用;随后恢复原值,检查异常是否再次出现。
- 结束条件:没有改善、字段不被当前版本接受,或业务功能发生变化时,恢复原配置并转做CPU采样。
Mihomo仓库配置示例明确说明该选项会禁用ICMP转发,并影响ping呈现的真实延迟,因此它是有功能代价的临时验证措施,不是通用降CPU开关。当前安装版本是否支持,仍应以该版本配置校验与运行结果为准。
第5步:空闲仍高时,用单变量定位DNS与嗅探
先测试嗅探开关,再核对DNS解析链,不能仅凭IP规则相关标题就删除全部规则。问题讨论#2764的作者后续反馈明确表示移除IP规则不足以解决,其个人环境最终指向DNS与嗅探回环。这是个案线索,不是所有高CPU的统一原因。
- 在配置测试副本中保留原节点、DNS及规则,仅把现有
sniffer对象中的enable改为false。功能定义见域名嗅探文档。 - 重现同一低流量或空闲场景,检查CPU、DNS相关失败和重复连接是否同步改变;随后恢复原值复测。
- 只有确认嗅探与异常相关后,再列出自己实际使用的DNS上游域名,检查它们的连接与解析是否反复出现。
- 若证据集中到具体DNS域名,在恢复嗅探后,仅将这些已确认域名加入现有
sniffer.skip-domain列表。该字段用于跳过指定域名嗅探,语法以嗅探配置说明为准。 - 逐项移除非必要覆写、脚本或附加规则,每次只移除一项并记录差异,逐步缩小为仍可复现的最小配置。
如果关闭嗅探没有改善,就恢复原值,结束这条分支;如果改善但规则命中或访问结果改变,只能先记为临时绕过。修改时编辑已有对象与列表,避免追加重复的顶层配置项。
第6步:异常期间采集CPU证据,再验证升级或恢复
CPU采样必须发生在异常仍持续的时候;重启后恢复空闲的文件不能解释之前的高占用。问题讨论#1159明确区分了CPU的profile与内存的heap,并要求在复现时生成资料。
- 先保存配置、覆写、当前可用核心及版本信息到本机持久目录,并确认原启动入口和恢复方式。
- 如需性能采样,把核心日志级别临时设为
debug后重启核心,再触发异常。Mihomo调试API文档要求内核启动时采用该日志级别。 - 使用已有本机控制API地址及鉴权访问
/debug/pprof/,再通过/debug/pprof/profile?seconds=30保存CPU采样。这里的30秒是采样时长;CPU端点及参数依据见Go pprof文档。 - 正常结果是采样结束后获得性能文件;如果返回未授权、未找到或连接失败,先核对当前控制地址、鉴权与启动日志级别,结束无效采样,不反复修改网络配置。
- 采样完成后恢复原日志级别和临时调试设置。控制接口保持本机访问;监听地址与密钥定义见外部控制配置说明。
| 阶段 | 判断步骤 | 停止或恢复条件 |
|---|---|---|
| 更换核心前 | 确认架构、客户端兼容性及旧文件能否恢复,保留备份 | 恢复路径不明确时,先补齐备份和证据 |
| 更换后验证 | 保持配置、节点、任务和观察时长一致,再重复触发动作 | 只有同等任务下稳定改善,才能记录为有效变化 |
| 出现新问题 | 通过原客户端的核心管理或原部署方式恢复旧核心与配置 | 确认正常联网后,保留新旧版本差异资料供反馈 |
客户端的核心管理入口并不统一,以当前版本界面为准。最新稳定版本及这些历史问题在当前安装版本中的适用性需核实,不能直接照搬讨论里的测试构建。
怎样提交能复现、又不暴露凭据的反馈
有效反馈要把触发步骤、异常日志和CPU采样对应起来,而不是只提交占用截图。核心问题讨论中的采样要求强调日志与异常期间生成的资料应一起提供。
- 环境:系统、CPU、客户端版本、核心版本、代理模式与TUN状态。
- 步骤:从正常启动到异常出现的操作顺序,以及暂停任务或关闭TUN后的结果。
- 对照:修改前后的CPU、速率、连接数、观察时长,以及是否损失网络功能。
- 附件:仍可复现的最小配置、异常前后连续日志、异常期间的CPU profile。
- 脱敏:检查订阅地址及其参数、节点密码、控制密钥、账户信息、真实地址和访问目标;保留字段结构、错误类型与复现所需关系。
原始配置和采样文件只在可信渠道按需提供,公开前逐项检查;上传完成后删除不再需要的临时凭据副本。历史Issue标题、关闭状态和单人反馈仅用于寻找线索,不能替代自己的复现结果。
相关阅读与核验说明
先完成高CPU分诊,再沿已确认的分支继续查,通常比同时修改DNS、规则和节点更容易保留证据。
- 关闭TUN后业务断网:继续阅读Mihomo TUN模式断网排查,先确认接管与恢复路径。
- 需要切换测试副本:参考Mihomo配置文件切换步骤,避免覆盖正在使用的配置。
- CPU恢复但连接仍异常:阅读Mihomo连接成功但打不开网页排查,继续核对连接与DNS。
核验说明:以下资料访问日期统一为2026-11-17。文中历史报告仅说明特定环境中出现过相应现象;本文未提供统一CPU故障阈值、测速结论或版本修复保证。
参考资料
- Mihomo Issue #2382:[Bug] CPU占用过高,疑似ICMP回环;URL:https://github.com/MetaCubeX/mihomo/issues/2382;访问日期:2026-11-17。
- Mihomo Issue #1586:[Bug] Steam下载时CPU占用非常高;URL:https://github.com/MetaCubeX/mihomo/issues/1586;访问日期:2026-11-17。
- Mihomo Issue #1159:[Bug] 打开TUN模式之后,CPU占用较高;URL:https://github.com/MetaCubeX/mihomo/issues/1159;访问日期:2026-11-17。
- Mihomo Issue #2764:Random, permanent high CPU usage triggered by IP-based rules (IP-CIDR/GEOIP);URL:https://github.com/MetaCubeX/mihomo/issues/2764;访问日期:2026-11-17。
- Mihomo文档:TUN;URL:https://wiki.metacubex.one/config/inbound/tun/;访问日期:2026-11-17。
- Mihomo文档:域名嗅探;URL:https://wiki.metacubex.one/config/sniff/;访问日期:2026-11-17。
- Mihomo文档:全局配置;URL:https://wiki.metacubex.one/config/general/;访问日期:2026-11-17。
- Mihomo文档:APIs;URL:https://wiki.metacubex.one/api/;访问日期:2026-11-17。
- Mihomo仓库:docs/config.yaml配置示例;URL:https://raw.githubusercontent.com/MetaCubeX/mihomo/Meta/docs/config.yaml;访问日期:2026-11-17。
- Go标准库:net/http/pprof;URL:https://pkg.go.dev/net/http/pprof;访问日期:2026-11-17。
- Microsoft Learn:Troubleshoot processes by using Task Manager;URL:https://learn.microsoft.com/en-us/troubleshoot/windows-server/support-tools/support-tools-task-manager;访问日期:2026-11-17。
- Apple支持:在Mac上的活动监视器中查看CPU活动;URL:https://support.apple.com/zh-cn/guide/activity-monitor/actmntr43452/10.14/mac/15.0;访问日期:2026-11-17。
常见问题
Mihomo CPU占用达到多少才算异常?
不能用一个固定百分比覆盖所有设备和系统。先在同一设备、同一监控工具下比较空闲与相同任务,并同时记录吞吐量和连接数。低流量仍持续高占用、伴随重复错误且可复现时,更值得继续定位。
关闭TUN后CPU下降,是否说明TUN有缺陷?
不能直接下结论。关闭TUN也可能让应用绕过核心或停止联网。先确认原业务仍正常、流量仍经过预期路径,再通过开启和关闭的重复对照判断关联。
disable-icmp-forwarding应该放在哪里?
应放在现有tun对象内,当前安装版本是否支持需核实。它适合有重复ICMP证据时做临时对照,会影响ICMP转发及ping延迟表现;没有改善就恢复原值,不作为通用优化项。
删除GEOIP和IP-CIDR规则能降低CPU吗?
不能作为通用结论。相关历史报告的作者后来表示,删除IP规则不足以解决其问题,并把个人环境的原因指向DNS与嗅探回环。应先做单变量对照,再逐项缩小配置。
CPU问题应该提交profile还是heap?
CPU分析应采集profile,并在异常持续期间生成;heap主要用于内存分析。Mihomo调试接口要求以debug日志级别启动核心,采样后恢复原调试设置。
升级或回退后CPU正常了,就算修复了吗?
还需要用相同配置、任务和触发条件重复验证。仅重启后的短暂正常不足以证明修复;如果出现新问题,应通过原部署方式恢复已备份的核心与配置。
相关阅读
参考资料
- Mihomo Issue #2382:[Bug] CPU占用过高,疑似ICMP回环
- Mihomo Issue #1586:[Bug] Steam下载时CPU占用非常高
- Mihomo Issue #1159:[Bug] 打开TUN模式之后,CPU占用较高
- Mihomo Issue #2764:Random, permanent high CPU usage triggered by IP-based rules (IP-CIDR/GEOIP)
- Mihomo文档:TUN
- Mihomo文档:域名嗅探
- Mihomo文档:全局配置
- Mihomo文档:APIs
- Mihomo仓库:docs/config.yaml配置示例
- Go标准库:net/http/pprof(pkg.go.dev)
- Microsoft Learn:Troubleshoot processes by using Task Manager
- Apple支持:在Mac上的活动监视器中查看CPU活动