确认芯片与系统要求
打开苹果菜单中的“关于本机”，查看芯片或处理器名称。Apple Silicon 与 Intel 使用不同架构安装包；随后到下载页核对客户端的最低系统要求，把应用移入“应用程序”后再启动，避免长期从磁盘映像内运行。
macOS 系统代理 · YAML 配置参考
Clash Mac版
Clash Mac版
macOS 客户端
从系统代理接管到规则分流，按 Mac 芯片选择客户端，查阅 YAML 配置与 TUN 使用步骤。
- 开源生态
- 中文文档
- 本地配置
代理接管与配置控制
功能取决于客户端实现与所用内核，设置名称以实际界面为准。
系统代理把当前网络服务的 HTTP、HTTPS 与 SOCKS 入口指向本机监听端口，适合先让浏览器接入 Clash。导入配置并启动内核后，再打开客户端的系统代理开关；端口必须与运行配置一致。Safari 通常读取系统设置，终端工具却可能需要单独指定代理。它与 TUN 的区别在于接管入口：系统代理依赖应用遵循代理设置，不会自动覆盖每个进程，也不会替应用决定最终出口。
config.yaml · 监听入口
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infomacOS 网络设置
网页代理（HTTP）启用
安全网页代理（HTTPS）启用
SOCKS 代理按需启用
TUN 通过虚拟网络接口接收流量，可用于不读取系统代理设置的应用。基于 mihomo 的客户端通常需要先安装或授权服务，再开启 TUN，并配合路由与 DNS 设置工作。与系统代理相比，它的接管范围更广，也更容易与其他 VPN、虚拟机网络或企业网络策略产生冲突。初次配置应先确认普通代理可用，再单独测试 TUN；遇到断网先关闭该模式，保留日志后检查路由，不要同时更改多项设置。
config.yaml · 虚拟接口
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53mihomo TUN 字段
enable开启接口
auto-route自动路由
dns-hijackDNS 接管
规则分流把请求特征映射到直连、拒绝或指定策略组。配置采用规则模式后，内核按列表顺序检查域名、目标 IP 等条件，命中后使用对应出口，末尾再放兜底规则。与全局模式相比，规则模式可以让本地服务与需要代理的请求分别处理。策略组负责选择出口，规则负责决定哪些请求进入这个组，两者不能互相替代。修改后应查看连接记录里的命中规则，确认结果，而不是仅凭网页能否打开判断配置正确。
config.yaml · 最小规则示意
mode: rule
rules:
- DOMAIN-SUFFIX,local,DIRECT
- IP-CIDR,127.0.0.0/8,DIRECT
- MATCH,DIRECT运行模式名称
Rule规则匹配
Global全局策略
Direct直接连接
配置覆写用于把本机差异与远程订阅分开保存，例如固定监听端口、追加局域网直连规则，或调整日志级别。直接修改下载的订阅文件，下一次更新可能覆盖改动；支持覆写的客户端可在生成运行配置时再合并本地内容。它不是统一的 Clash 内核开关，各客户端对对象、数组和脚本的处理方式不同。启用前先备份原配置，确认合并顺序，再查看最终运行配置，尤其要检查规则追加位置与同名策略组是否被替换。
本地覆写片段示意
mixed-port: 7890
allow-lan: false
log-level: info核对最终字段
mixed-port本机端口
rules数组顺序
proxy-groups同名组处理
Clash Mac版快速上手
先完成普通系统代理连接，再按应用需求增加 TUN 与覆写，便于定位每一步的变化。
导入配置与选择出口
使用可信来源提供的订阅地址或本地 YAML 文件。导入后确认配置已被选中，再检查策略组中的出口选择。客户端与配置来源是两件事，安装应用不会自动生成可用的远程节点，也不代表已有网络服务。
开启系统代理并检查连接
内核运行后开启系统代理，打开浏览器测试所需站点，再查看连接记录中的目标、命中规则与策略组。浏览器可用而终端失败时，先检查终端是否指定代理；不要直接把问题归因于节点，或立即重装客户端。
首次连接建议只启用一套接管方式。若同时运行另一个 VPN 或代理工具，先记录其用途并暂停测试，避免两个程序交替修改路由与 DNS。测试结束后正常退出客户端，并确认系统代理状态已恢复；详细授权路径与异常恢复步骤见教程。
Clash 多平台下载入口
按操作系统进入客户端清单，安装包、架构与系统要求集中在下载页查看。
跨设备使用时，配置语法相似不代表所有能力完全一致。先确认客户端采用的内核，再检查协议、规则集格式与 DNS 字段是否受支持。Mac 上的系统代理开关、移动设备的 VPN 授权与桌面端的服务安装属于各平台的接入方式，不能把一台设备上的界面操作原样套到另一台。订阅可共用时，也应把本机监听端口、文件路径与界面偏好保留在本地。
macOS
先按 Apple Silicon 或 Intel 选包，再比较 Clash Plus、Clash Verge Rev 与 FlClash 的配置管理方式。需要菜单栏操作或 TUN 时，分别核对界面实现与服务权限，不把某个客户端的选项当作全部 Mac 客户端的共同功能。
前往下载 macOS 客户端Windows
查看 Clash Plus、Clash Verge Rev 等图形客户端，核对系统与架构要求。寻找 Clash for Windows 替代方案时，先备份订阅和本地规则，再迁移配置；使用商店应用遇到回环访问问题，可查教程中的 Windows 平台补充。
前往下载 Windows 客户端Android
按设备处理器架构选择客户端安装包，首次建立连接时阅读系统 VPN 授权提示。移动系统的后台限制可能影响持续连接；切换网络后应重新检查解析与连接状态，不能直接沿用桌面端的系统代理排查路径。
前往下载 Android 客户端iOS
下载页提供 Clash Plus 的 App Store 入口，并列出官网 clashplus.io。导入配置后按系统提示添加 VPN 配置，再验证需要使用的应用。与 Mac 共享订阅前，先确认移动端支持其中的协议和字段，保留各设备自己的本地设置。
前往下载 iOS 客户端Linux
桌面环境可选择 Clash Verge Rev 或 FlClash，并按发行版核对软件包格式。服务器与路由器用户可转到内核区查看 mihomo；仅运行内核时，需要自行处理配置目录、进程管理与网络权限，不能依赖桌面菜单完成接管。
前往下载 Linux 客户端下载前的配置检查
端口与接管方式。本页浮窗展示的是本机代理入口，不是远程节点地址。若客户端使用其他端口，系统网络设置与命令行参数也要一起调整。仅修改 YAML 中的端口而没有重新加载配置，运行进程可能仍在使用旧值；先核对日志与当前监听，再测试请求。
订阅与本地修改。订阅地址可能包含访问凭据，应按敏感信息保存，不要贴进公开截图或仓库。更换客户端时，优先导出本地规则和覆写，再重新导入订阅；直接复制整个应用数据目录可能把旧路径、缓存和不兼容的界面设置一起带过去。
开源项目与本地配置
查阅 YAML 手册 →
Clash、mihomo 与图形客户端
Clash 生态不是一个名称对应一套界面的单体软件。负责解析配置、执行规则和建立连接的是内核；负责订阅管理、系统代理开关、菜单栏与更新界面的是图形客户端。理解这层分工，可以把“界面上没有选项”“配置字段不被支持”和“网络接管没有生效”分成不同问题处理，减少重复安装与盲目改配置。
项目历史与兼容边界
原版 Clash 项目停止更新后，社区围绕衍生内核与图形客户端继续发展。mihomo 延续了 Clash Meta 分支的技术路线，配置中保留了许多熟悉的字段，也增加了自己的能力。旧配置能被读取，不代表所有新协议、新规则集格式或 DNS 选项都能在旧内核上工作。遇到解析错误，应先确认实际运行的内核名称，再查对应文档，而不是只看应用图标或安装包名称。
旧教程还可能使用已经变化的菜单名称或权限流程。参考时应提取操作目标，例如“打开当前网络服务的代理设置”或“检查最终运行配置”，再在所用客户端中寻找对应入口。归档客户端可以用于理解历史配置，但选型时仍需结合当前系统兼容性与项目说明，不能把旧截图当成现行界面的保证。
内核能力与界面功能
同样基于 mihomo 的客户端，可能提供不同的覆写机制、订阅更新方式和系统服务管理流程。内核支持某项字段，并不意味着界面一定有对应按钮；界面出现 TUN 开关，也不意味着服务权限已经完成。排查时先看配置是否生成成功，再看内核是否启动，最后检查操作系统是否把流量送到正确入口，按层验证比同时调整多个开关更容易复现结果。
本页的 YAML 片段用于说明字段位置，不构成可直接连接的完整订阅。实际配置还需要节点、策略组与适合使用场景的规则。把示例合并到现有文件前，应核对缩进与字段层级，避免重复顶层键；修改后优先使用客户端的配置检查功能，再重载运行配置，并保留修改前的备份以便回退。
源代码与文档查阅
mihomo 的源代码与文档可用于核对配置字段的含义、平台限制和变更记录。查阅时应区分内核仓库与图形客户端仓库：代理协议、规则匹配或 DNS 行为通常从内核文档入手；订阅列表、菜单栏与服务安装则应查看对应客户端说明。代码公开便于追踪实现，但不替代对配置来源和本机权限的判断。
向项目反馈问题时，保留必要的系统信息、内核类型与最小复现配置。日志中可能包含访问域名、订阅地址或节点信息，公开提交前应做脱敏处理。尽量描述“进行了什么操作、预期什么结果、实际出现什么”，不要上传整份日常配置，这样既便于维护者定位，也能减少不相关信息。
更新与配置回退
客户端更新、内核更新与订阅更新是三个独立过程。客户端更新可能改变配置管理与权限流程，内核更新可能调整字段行为，订阅更新则可能替换节点和规则。更新前记录当前接管方式与本地覆写，完成后分别验证浏览器、命令行和局域网服务，不要把“应用能启动”当作全部网络路径都已正常。
若更新后出现异常，先比较最终运行配置与日志，再决定回退哪个层次。远程订阅被覆盖时，恢复本地规则比重装应用更直接；系统代理残留时，应检查网络服务设置；TUN 无法启动时，则检查服务授权与冲突程序。把变更范围缩小到一次一项，可以保留清晰的故障线索。
获取 mihomo 源代码
用于阅读实现与变更记录；普通安装无需克隆仓库，也无需自行编译内核。
git clone https://github.com/MetaCubeX/mihomo.gitClash 配置与排查文章
从本机连接问题到策略组选型，按具体问题继续查阅。
Clash 在 Mac 上网速慢：节点、线路、本地设置三层定位
按节点质量、出口线路、本机设置三层逐级排查，覆盖 DNS 模式、TUN 栈选择与 Wi-Fi 省电干扰，快速锁定 macOS 上的瓶颈。
阅读全文 →Clash 策略组 url-test、fallback、load-balance 区别与选用
逐个拆解三种自动策略组的测速逻辑、切换时机与 interval、tolerance 等字段，附 YAML 示例与各自适合的使用场景。
阅读全文 →Clash 开源生态梳理：mihomo 内核与各 Mac 客户端的关系
从原版内核停更讲到 mihomo 接力，理清内核、图形客户端与规则集项目之间的分工，帮助选择 macOS 上合适的客户端组合。
阅读全文 →