Windows
适合日常桌面使用。下载页列出带图形界面的客户端,并说明安装、配置导入和系统代理接管方式。
前往下载iOS 客户端与中文配置文档
从客户端选择到订阅导入,按真实操作路径整理。你可以在这里找到五大平台入口、中文配置说明与故障排查步骤。
Platform Downloads
不同系统使用不同安装包与权限模型。先选当前设备,再在下载页比较可用客户端、系统要求和安装方式。
适合日常桌面使用。下载页列出带图形界面的客户端,并说明安装、配置导入和系统代理接管方式。
前往下载适合 Intel 与 Apple 芯片 Mac。选择安装包前先确认处理器架构,再按客户端提示授权网络扩展或系统代理。
前往下载适合手机、平板与部分电视设备。下载页区分常见处理器包,并提供图形客户端与订阅配置入口。
前往下载适合 iPhone 与 iPad。客户端通过系统网络扩展工作,可导入订阅、选择策略组并设置按需连接。
前往下载适合桌面 Linux、服务器和路由环境。普通用户可选图形客户端,进阶用户可继续查看 mihomo 内核入口。
前往下载Core Configuration
四个配置面板对应日常最常用的操作。上方索引用于快速定位,面板内容按实际设置顺序展开。
Traffic Mode
规则模式适合长期使用。客户端从配置文件顶部向下检查域名、IP、进程或规则集合,命中后交给指定策略组处理。你可以让常用服务直连,让需要代理的请求进入节点选择组,也可以为局域网地址保留本地访问路径。
全局模式会把大多数流量交给同一个策略,排查节点是否可用时更直接,但不适合作为复杂配置的判断依据。遇到“部分网站能打开、部分网站不能打开”时,先确认当前模式,再检查对应域名命中了哪条规则。
Network Access
允许局域网用于让同一网络中的其他设备连接本机代理端口。只在确实需要共享时开启,并确认监听地址、系统防火墙和端口配置一致。iPhone 上的本地网络权限则影响局域网设备发现与访问,作用和代理连接本身并不完全相同。
DNS 劫持负责把系统解析请求送入客户端的 DNS 模块,避免解析结果与规则判断脱节。配置时要同时核对 enable、监听地址、增强模式、上游服务器与回退条件。单独更换某一个地址,通常无法解决规则、网络或节点导致的问题。
Subscription
订阅地址通常由服务提供方生成,客户端按设定周期重新下载配置。启用自动更新前,先手动更新一次并确认文件可以解析、策略组可以打开、规则引用没有报错。这样能把地址失效、网络阻断和配置语法问题分开判断。
更新订阅会覆盖远端提供的内容,本地临时修改可能随之消失。需要长期保留的 DNS、规则或策略组调整,应使用客户端支持的覆写与合并能力,而不是直接修改订阅原文。更新失败时先检查地址可访问性、系统时间和网络权限。
On Demand
按需连接使用 iOS 的网络条件触发客户端,例如在移动数据、指定 Wi-Fi 或未知网络环境下自动建立连接。配置前应先完成一次手动连接,确认系统已创建对应的 VPN 配置,并允许客户端添加网络扩展。
规则应从具体条件写到通用条件,避免前面的宽泛规则提前命中。家庭网络可以设置为断开或忽略,移动数据可设置为连接。若出现频繁重连,先减少重复条件,再关闭高频健康检查,最后核对低电量模式和系统后台状态。
Quick Start
先完成一条可验证的最短路径,再处理自动更新、覆写与按需连接。这样更容易定位问题出在哪一步。
在下载页进入 iOS 区,选择适用于 iPhone 或 iPad 的客户端。首次连接时,系统会要求添加 VPN 配置;使用设备密码、面容 ID 或触控 ID 完成授权。授权只需要在系统弹窗中确认,不要在尚未导入配置时反复切换连接开关。
复制有效的订阅地址,在客户端的配置或订阅页面选择从 URL 导入。下载完成后打开配置,确认策略组名称、规则列表和 DNS 段能够正常读取。随后进入策略组选择页,根据用途选择节点或自动策略,不要只看到配置名称就直接连接。
启用规则模式后建立连接,分别打开一个应直连的站点和一个应经过代理的站点。若结果不符合预期,查看连接记录中的规则名称和策略组,而不是连续更换多个设置。先确认流量命中路径,再判断是规则、DNS、节点还是本地网络问题。
Open Source Context
客户端、内核和配置格式属于不同层次。理解它们之间的关系,能减少把界面问题、网络问题和内核问题混在一起排查的情况。
Clash 建立了被广泛采用的 YAML 配置结构,常见内容包括代理节点、策略组、规则、DNS 和运行端口。原始项目停止继续维护后,社区仍沿用这套配置思路,并围绕兼容实现、规则数据和图形客户端继续开发。旧教程中的基础概念因此仍有参考价值,但具体字段是否支持,要以当前内核文档为准。
mihomo 是持续维护的 Clash 兼容内核之一,负责解析配置、建立代理连接、执行规则与处理 DNS。Windows、macOS、Android、iOS 和 Linux 上的图形客户端通常在内核之外提供订阅管理、系统代理、网络扩展、日志查看和策略切换。界面名称可以不同,底层概念大体一致。
代码公开使配置字段、行为变化和已知问题能够被社区检查。遇到异常时,应先记录操作系统、客户端名称、所用模式、配置来源和可复现步骤,再决定应该查看客户端项目还是内核项目。只提交“无法使用”通常不足以定位问题,日志中的字段错误、规则名称和网络状态更有判断价值。
客户端更新、内核更新和订阅更新是三条独立路径。更新客户端主要改变界面与系统集成;更新内核可能带来字段支持和网络行为变化;更新订阅则替换服务提供方下发的节点、策略和规则。出现变化时一次只调整一层,并保留上一份可用配置,回退和对比会更清楚。
mihomo source
git clone https://github.com/MetaCubeX/mihomo.git
Common Checks
多数首次使用问题可以在订阅、模式、策略组和系统状态四个位置找到原因。
先在浏览器确认订阅地址仍可访问,再检查系统时间、网络权限和客户端中的更新时间。地址能打开但客户端无法解析时,继续检查返回内容是否为有效配置。
依次检查系统 VPN 状态、当前模式、策略组选择、订阅有效性和 DNS 解析。每次只改变一个条件,并在改变后重新测试,避免多个动作掩盖真正原因。
日常使用优先规则模式,让不同请求按规则选择直连或代理。全局模式适合短时验证所选节点能否处理流量,但不能替代对规则命中的检查。
远端订阅更新后,本地直接修改的内容可能被覆盖。长期需要保留的 DNS、规则或策略组调整,应放入客户端支持的覆写或合并配置中。
Latest Guides
最新文章围绕速度、DNS 与 iPhone 后台运行展开。每篇都按现象、原因和操作顺序组织。