Windows
适用于桌面日常使用。安装前先查看系统版本与处理器架构，已有其他代理工具时先退出，再启用客户端的系统代理。遇到端口占用，应查明监听进程，而不是反复重装。
前往下载 →客户端 / 按系统选择
查看全部客户端 →macOS
按 Apple Silicon 或 Intel 选择安装包。首次启动后完成系统要求的授权，先导入配置并测试系统代理；需要接管更多应用时，再了解服务组件与 TUN 模式的权限要求。
前往下载 →Android
手机和平板需选择移动端客户端，Clash Verge Rev 本身面向桌面。进入下载中心查看可选应用，导入兼容订阅并确认 VPN 授权，后台连接还需留意系统的电池管理设置。
前往下载 →iOS
在 iPhone 或 iPad 上查看 Clash Plus 的商店入口。移动端的界面与桌面端不同，导入前需确认订阅格式受支持；连接时按系统提示添加 VPN 配置，再检查规则与策略组选择。
前往下载 →Linux
按发行版的软件包格式选择桌面安装包，安装前查看依赖要求。图形桌面使用客户端管理配置；服务器、路由器等环境则可查阅下载中心的 Mihomo 内核区，单独配置服务与权限。
前往下载 →客户端、订阅与代理服务是三件不同的事。安装客户端只是准备运行环境，订阅负责提供节点、策略组和规则等配置内容，实际连接还取决于服务是否可用。选择安装包时先看操作系统，再看架构；选择订阅时先看格式，再看配置所需的内核功能。
如果正在从旧客户端迁移，建议先导出原有配置并记下端口、代理模式和本地修改。新客户端首次运行时只启用一份配置，完成一次正常连接后，再迁移覆写与自定义规则。这样出现问题时，能够区分安装环境、订阅内容与本地设置三个范围。
订阅、代理与规则设置
按操作对象浏览界面局部。示意中的开关仅用于说明，实际设置需在客户端内完成。
界面 / 配置 / 订阅管理
订阅导入与配置切换
在配置页粘贴订阅链接并导入，下载成功后选择对应配置，再到代理页查看策略组。相比直接编辑内核文件，图形界面把订阅来源与当前启用状态集中展示，更适合管理日常使用的多份配置。导入成功不等于连接可用，还要确认订阅格式、节点信息与策略组选择。远程订阅更新可能替换原始内容，长期保留的规则应通过本地覆写管理；分享截图时要遮住订阅地址中的个人标识。
查看订阅导入步骤 →界面 / 设置 / 系统代理
系统代理与混合端口
系统代理会把支持系统代理设置的应用指向客户端监听地址。混合端口同时接收 HTTP 与 SOCKS 代理连接，示例端口为 7897，实际值以设置页为准。首次使用先启用系统代理，再用浏览器访问目标网站；终端或单独配置代理的应用可能需要额外设置。与 TUN 模式相比，这条路径接管范围更明确，也更便于入门排查。修改端口后要同步检查应用内的代理地址，退出客户端前也应确认系统代理已恢复。
查看系统代理设置 →界面 / 规则 / 匹配顺序
规则匹配与策略组选择
规则模式按配置中的顺序检查连接，通常由先命中的规则决定处理方式。规则指向的策略组还会继续选择具体节点，二者不能混为一谈。相比把全部流量交给同一出口，规则分流可以为不同域名安排直连或代理。添加规则时先核对目标域名，再确认策略组名称存在，并把具体规则放在兜底规则之前。访问结果不符合预期时，先去连接页查看命中规则与策略链，不要只根据网页能否打开判断配置是否生效。
查看规则与策略组配置 →界面 / 设置 / TUN 模式
虚拟网卡与应用流量接管
TUN 模式通过虚拟网络接口处理流量，适用于不遵循系统代理的应用。它与系统代理的区别在于接管路径，而不是替换订阅或自动提供节点。启用前先确认普通代理连接可用，再按客户端提示准备服务组件和权限。若设备同时运行其他 VPN、虚拟网卡或企业网络工具，需留意路由冲突。出现断网时先关闭 TUN 对比，再检查 DNS、自动路由与接口选择。一次只调整一项，保留能够恢复正常网络的原始设置。
查看 TUN 与 Fake-IP 说明 →配置 / dns / enhanced-mode
域名解析与分流配合
DNS 决定域名如何解析，也影响依赖目标 IP 的规则判断。Mihomo 的 DNS 配置与系统解析设置需要结合实际接管方式理解，不能只替换一组上游地址就认定问题解决。Fake-IP 为域名映射提供虚拟地址，与普通解析返回真实地址的路径不同。调整前记录增强模式、上游服务器和过滤项，再用同一个域名进行对比。若仅部分应用异常，先检查应用自己的加密 DNS 与缓存；复杂参数的用途及相互关系可在进阶配置中逐项查阅。
查看 DNS 配置优化 →界面 / 连接与日志 / 问题定位
连接记录与报错定位
连接页适合核对流量是否进入内核、命中了哪条规则；日志页适合查看配置加载、解析失败与连接异常。相比只重复切换节点，这两处信息能帮助缩小问题范围。排查时先记下发生时间和目标域名，复现一次，再寻找对应记录。需要时短暂提高日志级别，收集完成后恢复日常设置，避免信息过多影响阅读。对外提交问题前，应删去订阅地址、认证内容与私人访问记录，并附上可复现步骤及已尝试的操作。
查看常见日志报错 →首次使用：导入、选择、验证
先完成一条可复现的连接路径。确认基础设置正常后，再增加覆写、规则集与 TUN 配置。
-
导入一份可用订阅
安装并打开客户端，进入配置页，粘贴服务方提供的订阅链接，等待导入完成后选择该配置。链接指向的内容需要与客户端兼容，网页分享地址不一定就是订阅地址。使用本地文件时，先确认它是完整的 Clash YAML 配置，而不是只有节点文本的列表。
首次测试只保留一份明确启用的配置。遇到解析失败，先查看错误指出的字段或行号，检查缩进与格式，不要同时更改端口、DNS 和规则。
-
选择策略组并开启代理
进入代理页，确认订阅中的策略组已经出现，再为需要手动选择的组指定节点。初次使用保留规则模式，并在设置页开启系统代理。策略组名称由配置定义，不同订阅的分组方式可能不同，不能仅凭名称判断实际出口。
此时先用遵循系统代理的浏览器测试。若应用有自己的代理选项，确认它没有指向旧客户端的端口；暂时不启用额外网络接管功能，方便逐层判断。
-
用连接页核对结果
访问目标网站后打开连接页，核对目标域名、命中规则和策略链。网站可以打开，只能说明这次访问完成，不能单独证明请求走了预期出口。若没有看到对应连接，检查应用是否遵循系统代理，以及客户端是否正在使用刚导入的配置。
连接存在但访问失败时，再查看日志中的解析或连接错误。把测试对象固定为同一个域名，每次只改一项设置，才能判断问题来自规则、节点还是本地环境。
开始配置前的三个区别
- 订阅链接与配置文件
- 订阅链接是获取远程配置的入口，配置文件是客户端实际读取的内容。远程更新会重新获取内容，本地文件则需要自行维护。转换格式前先确认服务方是否已有适配客户端的订阅，避免把完整配置转换成仅含节点的列表。
- 规则模式与全局模式
- 规则模式依据规则列表选择处理方式，全局模式通常把流量交给全局策略组。两种模式都依赖可用的节点与配置。切换模式可以作为对照测试，但不应代替检查规则顺序、策略组选择和目标连接记录。
- 系统代理与 TUN 模式
- 系统代理依赖应用支持对应设置，TUN 通过虚拟网络接口接管流量。浏览器正常而其他应用异常时，应先区分应用的接入方式。TUN 涉及权限、路由和 DNS，建议在普通代理已经可用的前提下继续配置。
项目来源 / 代码与内核
Clash Verge Rev 开源项目
项目延续与桌面界面
Clash Verge Rev 延续 Clash Verge 的桌面客户端路线，以图形界面管理订阅、代理策略、连接和设置。理解这个项目时，需要把客户端界面与代理内核分开：配置页负责管理配置来源，设置页负责桌面集成，网络请求的规则匹配与协议处理主要由内核完成。旧教程中的按钮位置可能与当前界面不同，查找功能时优先按操作对象定位，而不是照着截图中的坐标点击。
Mihomo 内核与配置兼容
Mihomo 属于 Clash 配置生态，提供代理协议、策略组、规则和 DNS 等能力。客户端把这些能力接到桌面操作流程中，但不是每个配置字段都对应一个独立开关。部分设置来自订阅原文，部分来自客户端生成的运行配置，还有部分可能被本地覆写改变。遇到配置与界面表现不一致时，先确认当前启用的配置，再检查合并后的结果。查阅 Clash Meta 教程时，也应留意内核演进与字段支持情况，不能把不同客户端的界面步骤直接互换。
GPL-3.0 协议与源码查阅
项目以 GPL-3.0 协议开放源码。需要了解某项功能如何实现时，可以从仓库的说明、源码与议题记录入手；涉及修改和再分发时，应阅读许可证中的具体义务。开源提供的是可查阅、可讨论、可参与改进的代码基础，不等于所有网络环境都具有相同表现。实际使用仍需核对操作系统、服务组件、配置来源与网络条件。向项目反馈问题时，清晰的复现步骤和经过脱敏的日志，比只描述“连接失败”更有帮助。
客户端、内核与订阅分别更新
客户端更新、内核更新与远程订阅更新属于不同层次。客户端更新可能改变界面或系统集成，内核更新可能影响协议与配置字段，订阅更新则会改变节点、规则或策略组内容。升级前保留当前可用配置，阅读发布说明，再记录本地覆写、端口和服务设置。更新后先验证原来的使用路径，确认规则命中和应用连接正常，再尝试新功能。如果只有某一份订阅异常，应先检查配置内容，而不是立即回退所有组件。
查看项目源码与发布说明 →源码仓库 / git clone
git clone https://github.com/clash-verge-rev/clash-verge-rev.git普通使用与源码构建
日常使用直接进入下载中心选择安装包即可。克隆仓库适合阅读实现、提交修改或自行构建，不会自动完成安装。源码构建还需要按项目说明准备工具链、依赖与系统环境，构建步骤应以仓库当前文档为准。
订阅内容与本地修改
订阅通常包含节点、策略组和规则，更新时可能覆盖原文。需要长期保留的自定义分流，应先了解客户端的覆写机制，避免每次更新后重新手工修改。规则引用的策略组名称必须存在，多订阅合并还要考虑同名组、重复节点与规则顺序。配置修改后先检查是否成功加载，再通过连接页验证实际命中结果。
故障记录与隐私处理
排查时可记录操作系统、网络接入方式、启用的代理模式和错误发生时间。配置文件与日志可能包含订阅链接、服务器地址、认证信息和访问域名，公开提交前需要逐项脱敏。用于说明问题的最小配置只保留必要字段；不要把完整私人订阅直接贴到公共讨论区，也不要把临时调试设置长期留在日常配置中。
进入进阶配置手册 →配置文件与故障排查文章
按问题选择阅读路径：格式不清楚先看订阅，配置加载失败先看 YAML，启动异常先查端口。
Clash 配置文件 YAML 逐段拆解：从 mixed-port 到 rules
按顺序解析通用端口、dns、proxies、proxy-groups、rule-providers 与 rules 各段字段含义，附常见缩进错误示例。
适合已经完成订阅导入、准备阅读原始配置的用户。先辨认顶层字段与列表层级，再判断需要修改的是监听端口、解析方式还是规则引用，避免只复制片段却遗漏关联配置。
阅读文章 →7897 混合端口被占用：查找占用进程并修改监听端口
介绍在 Windows、macOS、Linux 上用命令查出占用端口的进程，并在客户端设置里修改混合端口、同步系统代理。
适合遇到监听失败或切换客户端后无法连接的情况。处理顺序是确认占用者、判断是否需要退出旧进程，再修改端口；最后核对浏览器、终端与其他应用是否仍在使用原来的代理地址。
阅读文章 →订阅链接导入客户端的三种方式与 YAML、Base64 格式区别
说明粘贴 URL、导入本地文件、扫码三种导入路径，对比 Clash YAML 与 Base64 节点列表两类订阅内容，以及更新间隔设置。
不同客户端提供的导入入口并不完全相同。阅读时先确认当前应用支持的方式，再检查订阅实际返回的内容；如果链接打开后是网页或报错信息，应先修正来源，而不是反复更换文件扩展名。
阅读文章 →