ClashMac 升级后仍无法按公司 Wi-Fi 自动暂停代理,先检查位置权限和当前网络名称。27.1.4 专门修复了新版 macOS 的 Wi-Fi 识别问题;短命令 cm 则要通过重装 CLI 激活,覆盖应用不等于旧命令入口已经更新。
27.1.4 Release 发布于 2026 年 9 月 4 日。以下按官方手册整理,针对已经安装并有可用配置的 Mac;未进行客户端运行测试,也不据此次权限修复推定最低系统版本。首次安装可参考 ClashMac 下载与安装说明 的应用放置和授权步骤;该页介绍 27.1.2,本文升级应使用上面的 27.1.4 Release,不要沿用旧安装包与校验值。
为什么后台已授权,Wi-Fi 名称还是空的?
两项授权管不同的事。系统权限说明 中的后台辅助服务负责网络路由和增强模式,需要在 macOS「系统设置 → 通用 → 登录项与延伸功能」允许运行。界面显示已授权,只能证明这项服务获准运行。
本次 Release 另提到位置权限引导与 Wi-Fi 读取修复。按应用智能旁路的引导处理许可,再打开「系统设置 → 隐私与安全性 → 定位服务」,检查 ClashMac 的开关。这个系统入口可见 Apple 定位服务说明。不要为了识别网络名去重装辅助服务,也无需把所有应用的位置权限一起打开。
SSID 已经填好,怎样判断旁路触发?
在「偏好设置 → 通用设置」启用无线网络智能旁路。受信任列表填的是 SSID,即 Wi-Fi 名称,不是路由器地址或节点名。通用设置手册 支持用逗号分隔多个名称,也提供添加当前网络的按钮。
下面只是输入格式示例,实际要换成自己准备暂停代理的网络:
Office_5G,Home_Mesh
连接该网络后,菜单顶部应显示旁路提示与对应名称,代理和增强模式会暂停。再切到一个不在列表里的网络,观察代理是否恢复。两次切换都看状态,比只打开一个网页更能判断自动化是否工作。
只把确实不需要本机代理的网络加入列表。输入名字不会认证无线网络的归属,同名热点也不能因此视为安全。误加时删掉对应 SSID,或关闭智能旁路,再检查原先使用的代理开关。
菜单栏月亮图标意味着连接故障吗?
状态栏手册 将月亮图标用于代理暂停或服务休眠。它不是节点延迟的判据。回到办公室时看到它,先展开菜单读提示,不要立刻切节点。
可按下面的表现找到对应入口:
| 表现 | 更可能的原因 | 检查位置 |
|---|---|---|
| 无法添加当前 Wi-Fi 名称 | 读取权限未就绪 | 智能旁路引导、定位服务 |
| 菜单显示旁路与网络名 | 当前 SSID 命中列表 | 通用设置的受信任列表 |
| 服务未授权,增强模式启动不了 | 后台辅助服务受阻 | 登录项与延伸功能 |
| 长命令可用,cm 找不到 | 短命令入口尚未激活 | 高级设置重装 CLI |
日常换节点可展开菜单中的策略组,点「测试延迟」后选择节点。系统代理、增强模式也各有菜单开关;详细入口见 快捷操作手册。遇到旁路暂停,要改的是受信任网络设置,切到另一个节点并不会移除该 SSID。
激活 cm,保留原来的长命令用法
从 ClashMac 菜单选择「设置…」,进入「高级设置」,点击「安装 CLI 工具」并完成管理员验证。这里打开的是应用自己的设置,不是 macOS 系统设置。Release 明确说可通过设置面板重装激活 cm,也列出了 cm install。如果终端已经找不到 cm,选择界面入口即可,不要继续重复那个无法执行的安装命令。
CLI 手册 仍使用 clashmac 长命令,介绍了状态和应用配置查询。激活短别名后,可用下面的只读示例检查两类状态:
cm status
cm app-status
前者读取运行状态和路由模式,后者查看主程序聚合信息,包括当前配置。输出采用 JSON,适合以后接入脚本;现在只需看返回的状态和配置名是否符合预期。旧脚本可以继续沿用长命令,不必为了两个字符批量改动。
手册中的 JSON 是返回格式示例,配置名和版本以本机输出为准。路由模式显示规则模式,也不能单靠这一字段断言系统代理已开启;旁路提示、系统代理与增强模式开关还要在菜单中分别查看。
若短命令失败,比较同一操作的长命令结果:
clashmac status
长命令能返回而短命令不存在,继续处理 CLI 安装入口;两者都连接失败,再查应用和辅助服务。不要把命令查找失败归因于订阅。涉及配置格式时,可另看 Clash YAML 配置检查。
控制台关掉后,怎样查看后台情况?
27.1.4 修复了大量连接历史下长期开面板引起的 CPU、内存异常,也减少概览和后台常驻的磁盘读写。官方没有给出降幅;菜单卡片、后台运行和 CLI 都不是这一版才出现。
普通状态查询无需一直开控制台。要捕获错误,可在终端运行官方日志命令,结束观察时按 Ctrl+C:
clashmac logs error
停止日志观察不等于停止代理。不要把 restart 当成查看状态的命令,它会重启服务并中断活跃连接。若退出旁路后仍是增强模式网络异常,再看 macOS TUN 权限与 DNS 排查,从那一层继续,而不是反复增删 Wi-Fi 名称。