官方标准教程 · 装配到校准 · 一次装对

Clash 新版安装
初始化配置

装完不等于装对。这一页按 Clash 新版部署规范把安装拆成四道工序: 规格核对、组件装配、参数预设、启动校准。 每道工序都有验收标准,走完就能得到一个稳定、完整、可直接使用的客户端。

Init Pipeline · 四道工序 逐站验收
01 规格核对 系统版本 · CPU 架构 · 包型选择 必做
02 组件装配 内核 · TUN 驱动 · 自启 · 系统代理 必做
03 参数预设 端口 · 模式 · DNS · 订阅导入 必做
04 启动校准 内核拉起 · 端口监听 · 出口验证 验收
四站全绿即为部署完成 READY

Station 01 · 规格核对

安装前先对规格:同一个客户端,五个系统装法不同

规格核对只需要两分钟,但能挡掉九成的安装失败。对三件事:系统版本够不够CPU 架构是哪一种该拿安装版还是便携版。下面按系统分开列,对号入座即可。

Windows
  • 在「系统信息」里确认系统类型:x64 还是 ARM64,两者安装包不通用。
  • 安装版写注册表、支持自动更新;便携版解压即用,适合放在 U 盘或绿色目录。
  • 安装程序需要管理员授权,否则 TUN 虚拟网卡驱动装不上。
装前提醒:先把旧版本完全卸载并重启,避免内核文件残留冲突。
macOS
  • 在「关于本机」里看芯片:IntelApple Silicon 分包提供,不要装反。
  • 首次启动需要在「隐私与安全性」中允许网络扩展,否则 TUN 无法启用。
  • 把应用拖进应用程序文件夹再运行,留在下载目录会触发隔离属性限制。
装前提醒:若提示「已损坏」,是隔离属性所致,移除属性即可,不必重下。
Android
  • APK 直装,安装前需在系统设置里允许「安装未知来源应用」。
  • 首次连接会弹出 VpnService 授权请求,必须点允许,隧道才会建立。
  • 部分机型需要在电池设置里把客户端加入白名单,防止后台被杀。
装前提醒:确认处理器架构是 arm64-v8a 还是 armeabi-v7a,装错会闪退。
iOS
  • App Store 上架版本,商店内直接安装,无需自签描述文件
  • 首次启动会请求本地网络权限与 VPN 配置描述文件,两项都要允许。
  • 安装完成后,配置由订阅导入,客户端本身不预设节点。
装前提醒:系统版本过低会限制部分协议支持,升级系统后再装更稳。

Station 02 · 组件装配

安装时的勾选项:哪些必须留,哪些可以去掉

安装向导里的复选框不是摆设。勾多了拖慢启动,勾少了功能残缺。下面把常见组件按必留可选分成两组,对照着勾就不会错。

内核组件 必留

图形客户端只是外壳,真正干活的是 mihomo 内核。安装时若提供「使用内置内核」与「使用外部内核」两个选项,日常选内置即可——版本匹配、随客户端一起更新,省去手动替换的麻烦。

TUN 虚拟网卡驱动 必留

这是启动设置里 TUN 模式的前提。命令行工具、游戏客户端、部分桌面软件不读系统代理设置,只有虚拟网卡能把它们兜住。驱动不装,后面开 TUN 时会直接失败,回头补装更麻烦。

?

开机自启 按需

常驻使用建议勾上,开机后自动拉起内核,不用每次手动点开。若只是偶尔用,或者机器上还装了其他代理工具,就取消勾选,避免两个客户端抢同一组端口。

?

系统代理自动接管 按需

勾上后客户端启动即写入系统代理设置,浏览器与多数桌面软件直接走代理。如果习惯手动控制代理开关,可以取消,改由客户端面板里的开关决定。

?

桌面快捷方式与开始菜单项 按需

纯属使用习惯。需要留意的是:正规安装包不会默认勾选浏览器插件、下载器或第三方推广组件。安装时若看到这类勾选项,全部取消再继续。

Station 03 · 参数预设

初始化配置:四组参数,先把默认值调顺

安装完成后不要急着连节点。先花几分钟把下面四组参数确认一遍,多数「装了却不好用」的问题,根源都在这几步的默认值上。

PORT

端口组

混合端口同时提供 HTTP 与 SOCKS 能力,是大多数客户端的默认项。若本机已有其他程序占用同一端口,会表现为启动报错或代理不生效,换一个不冲突的端口即可。

mixed-port: 7890
MODE

运行模式

日常固定用规则模式:国内域名直连、其余走代理。全局模式只适合临时排查,直连模式用来做对照测试。模式可以随时切换,不需要重启客户端。

mode: rule
DNS

DNS 模块

开启 DNS 模块并把增强模式设为 fake-ip,让域名解析在代理链路内完成。这一步决定了访问记录会不会经由本地运营商,是初始化配置里最容易被跳过、却最该确认的一项。

enhanced-mode: fake-ip
SUB

订阅导入

在配置页粘贴订阅链接,拉取成功后应显示节点数量与更新时间。建议同时打开定时自动更新,节点增删与规则调整由订阅端推送,本地不需要手改配置。

update-interval: 24h
TUN

TUN 开关

若存在命令行程序、游戏客户端等不读系统代理的软件,在这里打开 TUN 模式。首次开启会请求管理员或网络扩展权限,授权后需要重启一次客户端才能生效。

tun: enable: true
LOG

日志级别

日常用 info 即可;排查问题时临时切到 debug,能看到每条连接命中了哪条规则。排查完记得切回来,debug 级别会持续写入大量日志,长时间开启会拖慢运行。

log-level: info

Station 04 · 启动校准

启动设置做完,四项验收逐条过

界面显示「已连接」只代表进程起来了。下面四项是启动校准的验收标准,每一项都有明确的观察位置, 全部通过才算真正部署完成。

01

内核是否正常拉起

客户端启动后会自动拉起内核进程。在「关于」或「设置」页应能看到内核版本号,部分客户端还会显示内核运行时长。若这一栏始终为空,说明内核没起来——多半是权限不足、旧版本残留或安装包不完整。

✓ 内核版本号显示正常
02

端口是否处于监听状态

客户端面板里通常会显示当前端口,也可能是你在参数预设里指定的值。端口被其他程序占用时,客户端可能仍显示运行中,但代理实际不生效。发现异常时先换端口,再排查其他原因。

✓ 面板端口与预设一致且无冲突提示
03

出口 IP 是否已经改变

打开任意查询出口 IP 的页面,确认显示的地区与节点所在地一致。若仍显示本地 IP,说明流量没走代理——依次检查运行模式是否为规则、系统代理是否开启、规则里是否把该流量放行到了直连。

✓ 出口 IP 地区与所选节点一致
04

DNS 是否泄漏

代理连通但解析仍走本地运营商,是最隐蔽的一种「假成功」。用 DNS 泄漏检测页面确认解析服务器与代理链路一致。若不一致,回到参数预设里检查 DNS 模块是否开启、增强模式是否为 fake-ip。

✓ 解析服务器不在本地运营商网段

Troubleshooting · 异常排查要点

五类常见异常,对应五个处置方向

初始化阶段的问题大多有明确的对应关系。下面把现象与处置方向一一对上,遇到问题时按图索骥,不必从头排查。

!

双击安装包毫无反应

典型原因是架构不匹配。回到规格核对,确认系统类型与安装包架构一致;若架构正确仍无反应,检查安装包是否下载中断导致体积不完整,重新下载一次。

!

界面能开,内核版本一栏是空的

说明内核进程没起来。常见于权限不足旧版本残留:以管理员身份重新运行一次;若仍无效,彻底卸载旧版本、清理配置目录后重装,再重新导入订阅。

!

TUN 开关拨不动或开启后无效

多数是授权环节被跳过。Windows 需管理员授权创建虚拟网卡,macOS 需在隐私与安全性中允许网络扩展,安卓需确认 VpnService 请求。授权后通常需要重启客户端一次。

!

端口冲突,代理不生效

同一台机器上装了多个代理工具时,容易出现端口抢占。在参数预设里换一个未被占用的端口,重启客户端后重新验证出口 IP 是否变化。

!

订阅拉取失败

按三种原因分别处理:链接过期换新链接;网络够不到订阅域名换网络环境;格式不是 Clash 系先用订阅转换转成对应格式,再重新导入。

Quick Check · 四个高频问题

初始化配置里最常被问到的四件事

初始化配置可以跳过吗?

不建议。跳过端口与 DNS 预设,短期内可能看不出问题,但遇到端口冲突或 DNS 泄漏时会很难定位。花几分钟确认一遍,比事后排查省时间。看参数预设 →

换客户端需要重新初始化吗?

不需要。订阅、规则、策略组的写法在各客户端之间通用,把原配置文件导入新客户端即可,端口与模式等参数也会一并带过去。看客户端选型 →

一定要开 TUN 模式吗?

不是必须。浏览器与常规桌面软件走系统代理就够了。只有当你需要让命令行工具、游戏客户端也走代理时,才需要打开 TUN 用虚拟网卡接管。看组件装配 →

校准四项里哪项最容易出错?

DNS 泄漏。因为代理连接本身是成功的,界面上看不出异常,需要专门用检测页面确认。这也是初始化配置里最值得多花两分钟的一项。看启动校准 →