Clash Logo 使用教程中心

5 分钟配置 Clash,全平台图文教程

从安装到智能分流,手把手带你完成 Clash 全部配置。支持 Windows、macOS、Android、iOS、Linux,以及 Mihomo Core / CLI 命令行服务器部署,零基础新手与高级用户均适用。

5 分钟完成配置 · 6 大平台覆盖 · 含 CLI 高级教程 · 持续更新维护

三步完成 Clash 全部配置

无论你使用哪个平台,核心流程都相同。下方分平台教程提供更详细的图文说明。

01

下载并安装客户端

根据你的操作系统选择对应的 Clash 图形化客户端。Windows 推荐 Clash Verge RevFlClash(两者均活跃维护,免费开源);macOS 推荐 Clash Verge RevFlClash(两款均支持 Apple Silicon 与 Intel);Linux 推荐 Clash Verge Rev(.deb / .rpm / AUR)或 FlClash(.deb,amd64);Android 推荐 FlClash(arm64,Material Design 3)、Clash Meta for Android(通用版,全架构兼容)或 Surfboard(轻量 Material You 风格);iOS 推荐 StashShadowrocket;服务器 / NAS / 路由器 / Docker 等无界面场景推荐使用 Mihomo Core(命令行二进制)。

前往下载页面
02

导入机场订阅链接

从机场服务商(代理节点提供商)获取 Clash 格式的订阅 URL,复制粘贴到客户端的「配置」或「订阅」页面,点击更新即可。客户端自动解析节点列表与分流规则,无需手动编写任何 YAML 配置。

03

选择节点,开启代理

在节点列表中选择延迟低的代理节点,开启「系统代理」(轻量模式)或「TUN 模式」(全局透明代理)。Clash 自动分流——国内网站直连保速,境外服务走代理,无感知智能切换。

Windows 使用教程

以 Clash Verge Rev 为例(FlClash 操作步骤基本一致),适用于 Windows 10 / 11

步骤 1

下载并安装 Windows 客户端

前往 下载页面,Windows 平台目前有两款活跃维护的免费客户端可选:

FlClash

基于 Flutter 的跨平台客户端,Material Design 3 界面,同时覆盖 Windows、macOS、Android、Linux 四端,适合跨平台用户。

  • 下载 FlClash-0.8.93-windows-amd64-setup.exe(当前仅提供 x64,ARM64 设备建议选 Clash Verge Rev)
下载后双击安装包,按提示完成安装,客户端会自动添加到开始菜单,首次启动会弹出欢迎界面。两款客户端后续的导入订阅、选节点、开启代理步骤基本一致,本教程以 Clash Verge Rev 为例说明。
如果 Windows Defender 弹出安全警告,点击「更多信息」→「仍要运行」即可,这是开源软件未进行 Microsoft 代码签名的正常现象。
步骤 2

导入机场订阅链接

打开 Clash Verge Rev,在左侧导航栏点击「订阅」(Profiles),然后:

  1. 点击右上角「新建」或输入框
  2. 将机场提供的 Clash 订阅 URL 粘贴进去
  3. 点击「导入」或按 Enter 确认
  4. 等待订阅下载完成,配置文件会出现在列表中
  5. 点击配置文件右侧的「使用此配置」将其激活(选中状态)
建议开启「自动更新」功能(可设置每 24 小时自动拉取最新节点列表),避免因订阅过期导致节点失效。
订阅 URL 格式示例
https://your-airport.com/api/v1/client/subscribe?token=xxxxxxxx&flag=clash
步骤 3

查看并选择代理节点

在左侧导航点击「代理」(Proxies),你会看到所有可用节点和策略组:

  • 点击任意策略组(如「Proxy」),在下方节点列表中选择延迟低的节点
  • 点击节点右侧的闪电图标可以手动测速,显示当前实时延迟
  • 「自动选择」策略会根据延迟自动切换最优节点,适合不想手动管理的用户
延迟低于 100ms 为优质节点,100–200ms 为可用节点,超过 300ms 建议换其他节点。显示 timeout 表示节点不可达。
步骤 4

开启系统代理

在 Clash Verge Rev 右上角,找到「系统代理」开关,点击将其打开(变为蓝色)。

  • 系统代理模式会自动配置 Windows 系统代理设置,浏览器等支持系统代理的应用立即生效
  • Clash 默认监听 127.0.0.1:7890(HTTP 代理)和 127.0.0.1:7891(SOCKS5 代理)
  • 验证是否生效:在浏览器中访问 google.com,能正常打开即配置成功
步骤 5

开启 TUN 模式(全局透明代理)

TUN 模式可以代理所有流量(包括游戏、命令行工具等不支持系统代理的程序),推荐进阶用户开启:

  1. 在 Clash Verge Rev 设置页面,找到「TUN 模式」开关,点击开启
  2. 系统会弹出 UAC 权限提示,点击「是」授予管理员权限(TUN 需要系统权限创建虚拟网卡)
  3. TUN 模式开启后,系统代理开关可以关闭,TUN 会全面接管所有流量
TUN 模式需要管理员权限,普通上网使用系统代理即可。开启 TUN 后记得退出时关闭,避免影响其他网络程序。
常见问题

Windows 使用常见问题

开启系统代理后浏览器还是无法访问 Google?
检查:① 已激活订阅配置;② 节点延迟正常(非 timeout);③ 代理模式选择「规则」而非「直连」。如仍不行,尝试切换节点或重启 Clash Verge Rev。
如何让特定应用走直连,不走代理?
在订阅的 YAML 配置文件中,rules 部分添加 PROCESS-NAME,xxx.exe,DIRECT 规则;或在客户端代理规则页面手动添加直连规则。
Clash Verge Rev 开机自启如何设置?
在 Clash Verge Rev 设置页面,开启「开机自启动」选项即可,同时建议开启「静默启动」避免弹窗打扰。
我在用 Clash for Windows(CFW),需要迁移吗?
是的,建议尽快迁移。Clash for Windows 原作者已宣布停止维护,代码库已归档,不再修复安全漏洞。推荐迁移至 Clash Verge Rev(功能更完善,社区最活跃)或 FlClash(跨平台,Material Design 3 界面)。两款均活跃维护、完全免费,前往下载页面即可获取。
Clash Verge Rev 和 FlClash 怎么选?
两款均内置 Clash Meta 核心、活跃维护、完全免费。Clash Verge Rev 功能更丰富(支持 ARM64、配置覆写等),社区支持更广,适合大多数用户;FlClash 界面风格更简洁,跨平台一致性更好(同一客户端覆盖 Windows / macOS / Android / Linux),适合多设备用户。

macOS 使用教程

支持 Clash Verge Rev 与 FlClash,适用于 macOS 11 Big Sur 及以上(Intel / Apple Silicon M 系列)

步骤 1

下载并安装 macOS 客户端

前往 下载页面,macOS 平台目前有两款活跃维护的免费客户端可选:

FlClash

基于 Flutter 的跨平台客户端,Material Design 3 界面,同时覆盖 Windows、macOS、Android、Linux 四端,适合多设备用户。

  • M1 / M2 / M3 / M4 芯片 Mac:下载 FlClash-0.8.93-macos-arm64.dmg
  • Intel 芯片 Mac(2020 年前):下载 FlClash-0.8.93-macos-amd64.dmg
不确定芯片型号?点击左上角苹果菜单 →「关于本机」,显示 Apple M 开头为 Apple Silicon,显示 Intel 为 Intel 芯片。下载完成后,双击 .dmg 文件,将应用图标拖入 Applications(应用程序)文件夹完成安装。两款客户端后续的导入订阅、选节点、开启代理步骤基本一致,本教程以 Clash Verge Rev 为例说明。
步骤 2

解除 macOS Gatekeeper 限制

首次打开客户端时,macOS 可能提示「无法打开,因为无法验证开发者」,这是正常现象(Clash Verge Rev 与 FlClash 均为开源软件,未进行 Apple 付费公证)。有两种方法解决:

终端命令方式

打开「终端」应用,根据所选客户端执行对应命令:

Terminal — Clash Verge Rev
sudo xattr -r -d com.apple.quarantine /Applications/ClashVergeRev.app
Terminal — FlClash
sudo xattr -r -d com.apple.quarantine /Applications/FlClash.app
步骤 3

导入机场订阅链接

打开 Clash Verge Rev,在左侧导航点击「订阅」:

  1. 点击「新建」按钮
  2. 在 URL 输入框中粘贴机场提供的订阅链接
  3. (可选)填写备注名称,方便区分多个订阅
  4. 点击「导入」,等待配置文件下载完成
  5. 点击配置文件,将其设为当前使用的配置
步骤 4

选择节点并开启系统代理

在「代理」页面选择节点后,开启右上角「系统代理」开关:

  • macOS 会弹出网络权限请求,点击「好」授权
  • Clash Verge Rev 会自动配置 macOS 系统代理,Safari、Chrome 等浏览器立即生效
  • 菜单栏会出现 Clash 状态图标,点击可快速切换节点
验证配置:打开浏览器访问 google.com,能正常加载即代表配置成功。
步骤 5

开启增强模式(TUN)

需要代理所有流量(包括不支持系统代理的命令行工具、游戏等)时,开启增强模式:

  1. 在设置中找到「TUN 模式」或「增强模式
  2. 开启后会请求安装系统扩展,输入 macOS 密码确认
  3. 在「隐私与安全性」中允许安装系统扩展
  4. 重启 Clash Verge Rev 后 TUN 模式生效
常见问题

macOS 使用常见问题

为什么终端(Terminal)里的命令不走代理?
系统代理对命令行工具不生效。解决方案:① 开启 TUN 模式;或 ② 在终端手动设置环境变量:export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
退出 Clash 后网络无法访问怎么办?
退出时若未自动关闭系统代理,可前往「系统设置 → 网络 → 代理」,手动关闭 HTTP 和 SOCKS5 代理。或重启 Clash Verge Rev 后再正常退出。
Clash Verge Rev 和 FlClash 在 macOS 上怎么选?
两款均内置 Clash Meta 核心、活跃维护、完全免费,且均同时支持 Apple Silicon 与 Intel Mac。Clash Verge Rev 功能更丰富(配置覆写、脚本、更细粒度代理设置),社区支持更广,适合大多数用户;FlClash 界面更简洁(Material Design 3),跨平台一致性更好(同一客户端覆盖 Windows / macOS / Android / Linux),适合同时使用多端设备的用户。前往下载页面即可获取两款客户端。

Android 使用教程

适用于 FlClash、Clash Meta for Android(CMFA)及 Surfboard;支持 Android 5.0 及以上

步骤 1

下载并安装 Android 客户端 APK

前往 下载页面,Android 平台有三款推荐客户端:

  • FlClash(推荐首选):下载 FlClash-0.8.93-android-arm64-v8a.apk,适合 2016 年后的主流安卓手机,Material Design 3 界面现代,同时覆盖 Windows / macOS / Linux 四端,跨平台一致性佳
  • Clash Meta for Android(CMFA,通用版):下载通用版 APK,兼容 ARM64、ARMv7 及 x86_64 全架构,不确定手机型号或架构时优先选此版本
  • Surfboard(轻量替代):下载通用版 APK,采用 Material You 设计风格,完全兼容 Clash YAML 订阅,界面简洁,适合偏好轻便体验的用户
安装 APK 前,需要在「设置 → 安全」(或「设置 → 应用」)中允许「安装未知来源应用」。不同手机品牌菜单位置略有差异。
步骤 2

导入订阅配置

打开客户端(FlClash / CMFA / Surfboard),在底部导航点击「配置」:

  1. 点击右上角「+」按钮,选择「URL
  2. 在名称栏输入任意备注,在 URL 栏粘贴机场订阅链接
  3. 点击右上角保存图标,然后点击「更新」下载配置
  4. 下载完成后,点击配置名称旁的圆点将其选为当前使用的配置
长按配置可设置「自动更新」,推荐设置为每 24 小时更新一次,保持节点信息最新。
步骤 3

选择节点并启动代理

  1. 在底部导航点击「代理」,查看并选择策略组中的节点
  2. 点击节点右侧的测速图标测试延迟,选择延迟低的节点
  3. 返回首页,点击大型「启动」按钮(播放图标)
  4. 系统弹出 VPN 连接授权提示,点击「确定」
  5. 状态变为「运行中」,通知栏出现 VPN 图标即代理已生效
步骤 4

配置 TUN 模式(全局代理)

FlClash 与 CMFA 均默认使用 Android VPN API 接管流量,无需额外配置即可实现类似 TUN 的全局代理效果。如需更精细的控制:

  • 在「设置 → 覆写」中可自定义代理模式(规则/全局/直连)
  • 绕过私有网络」选项可以让局域网流量不走代理,推荐开启
  • 在「设置 → 访问控制」可设置哪些应用走代理(按应用过滤);Surfboard 用户可在「应用代理」中按 App 单独配置
常见问题

Android 使用常见问题

安装 APK 提示「解析安装包失败」?
可能原因:① 下载的 APK 架构与设备不匹配,改下载通用版;② 文件下载不完整,重新下载;③ 系统版本过低(低于 Android 5.0 不支持)。
代理启动后某些 App 还是无法访问?
检查「访问控制」设置,确认该 App 未被设置为直连。同时检查订阅规则是否包含对应域名,必要时切换到「全局」代理模式测试。
如何省电,避免代理常驻消耗电量?
在手机「电池」设置中将 FlClash 或 CMFA 设为「不限制后台活动」,防止系统杀进程断开代理;或仅在需要时手动开关代理,不使用时关闭 VPN 连接。
FlClash、CMFA 和 Surfboard 在安卓上怎么选?
FlClash 推荐首选,Material Design 3 界面现代、跨平台一致(同一客户端覆盖 Windows / macOS / Android / Linux),适合多设备用户;Clash Meta for Android(CMFA)通用版 APK 全架构兼容,不确定机型时优先选此版本,功能完整;Surfboard 界面更轻量(Material You 风格),适合只需基础订阅导入和规则分流的用户。三款均内置 Clash Meta 核心、活跃维护、完全免费,前往下载页面获取。
iOS

iOS 使用教程

以 Stash 为例,需使用非中国大陆区 Apple ID 购买下载

iOS 平台代理客户端均需使用非中国大陆区(美区、香港区等)Apple ID 付费购买。推荐 Stash(功能最完善)或 Shadowrocket(小火箭,经典之选)。
步骤 1

切换非国区 Apple ID 并购买

  1. 打开 App Store,点击右上角头像,滑到底部点击「退出登录」
  2. 使用美区或港区 Apple ID 重新登录(可向朋友借用或自行注册)
  3. 搜索「Stash」或「Shadowrocket」,付费购买并下载
  4. 下载完成后,切换回你的国区 Apple ID 即可,已购买的 App 不会消失
请勿轻信出售「美区账号」的第三方,有账号被锁风险。建议自己注册美区 Apple ID(注册时将地区选为美国,无需信用卡)。
步骤 2

在 Stash 中导入订阅

  1. 打开 Stash,点击底部「首页
  2. 点击「添加配置文件」→「从 URL 下载
  3. 粘贴机场提供的 Clash 订阅 URL,点击「下载
  4. 配置下载成功后自动切换为当前使用的配置
  5. 在「策略组」页面选择节点,或使用自动选择
步骤 3

在 Shadowrocket(小火箭)中导入订阅

  1. 打开 Shadowrocket,点击右上角「+
  2. 「类型」选择「Subscribe(订阅)」
  3. 在 URL 栏粘贴机场的订阅链接,添加备注
  4. 点击右上角「完成」,等待节点加载完成
  5. 在节点列表中选择延迟低的节点
步骤 4

启动代理

导入配置并选好节点后,在应用首页点击「未连接」旁边的开关,将其打开:

  • iOS 会弹出「此 App 想要添加 VPN 配置」授权提示,点击「允许」并输入 Face ID / 密码
  • 状态显示「已连接」,状态栏出现 VPN 图标即代理已生效
  • 打开 Safari 访问 google.com 验证是否正常
常见问题

iOS 使用常见问题

切换了非国区账号但 App Store 仍显示「不支持」?
确认账号已完整切换:退出登录后,重新登录非国区 Apple ID,进入 App Store 主页检查右上角头像,确认显示的是非国区账号再搜索购买。
订阅导入后显示节点数量为 0?
可能订阅链接不是 Clash 格式。联系机场客服,索要 Clash / Surge 兼容格式的订阅链接;或在链接后加上 ?flag=clash 参数后重试。
连接后 YouTube 还是打不开,但 Google 可以?
节点速度不够或连接质量差。尝试:① 切换延迟更低的节点;② 手动测速选最优节点;③ 切换到「全局」代理模式测试是否为规则问题。
Linux

Linux 使用教程

支持 Clash Verge Rev 与 FlClash,适用于 Ubuntu / Debian / Fedora / Arch Linux / openSUSE

步骤 1

下载并安装 Linux 客户端

前往 下载页面,Linux 平台目前有两款活跃维护的免费客户端可选:

FlClash

基于 Flutter 的跨平台客户端,Material Design 3 界面,同时覆盖 Windows、macOS、Android、Linux 四端,适合多设备用户。

  • Ubuntu / Debian(amd64):下载 FlClash-0.8.93-linux-amd64.deb
  • RPM 发行版(Fedora / RHEL)或 ARM 用户建议选 Clash Verge Rev
Ubuntu / Debian 安装
sudo apt install ./FlClash-0.8.93-linux-amd64.deb
安装完成后在应用菜单或终端中启动客户端。两款客户端后续的导入订阅、选节点、开启代理步骤基本一致,本教程以 Clash Verge Rev 为例说明。
步骤 2

导入订阅配置

与 Windows / macOS 版操作完全一致:

  1. 打开 Clash Verge Rev(或 FlClash),点击「订阅」页面
  2. 点击「新建」,粘贴机场订阅 URL
  3. 点击「导入」,等待配置下载完成
  4. 点击配置将其设为当前使用的配置
步骤 3

开启代理

Linux 下 Clash 提供两种代理方式:

终端环境变量方式

~/.bashrc 或 ~/.zshrc
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export all_proxy="socks5://127.0.0.1:7891"

也可以开启 TUN 模式实现全局透明代理(需 root 权限),在设置中找到 TUN 选项并开启即可。

常见问题

Linux 使用常见问题

开启系统代理后浏览器不生效?
GNOME 用户确认已安装 gnome-settings-daemon;KDE 用户检查系统设置中代理配置。部分发行版需手动在网络设置中添加代理:主机 127.0.0.1,端口 7890
如何开机自动启动 Clash Verge Rev?
在 Clash Verge Rev 设置中开启「开机自启」选项;或手动创建 ~/.config/autostart/clash-verge-rev.desktop 自启动文件,指向客户端的可执行文件路径。
Wayland 下界面显示异常?
Tauri 应用(Clash Verge Rev)在 Wayland 下可能有显示问题。尝试设置环境变量 WAYLAND_DISPLAY="" 后启动,强制在 XWayland 下运行。FlClash 基于 Flutter,Wayland 兼容性通常更好。
Clash Verge Rev 和 FlClash 在 Linux 上怎么选?
两款均内置 Clash Meta 核心、活跃维护、完全免费。Clash Verge Rev 功能更丰富,同时支持 .deb、.rpm 和 AUR,覆盖所有主流发行版,适合大多数 Linux 用户;FlClash 界面更简洁(Material Design 3),跨平台一致性更好(同一客户端覆盖 Windows / macOS / Android / Linux),但目前仅提供 amd64 .deb 格式,Fedora / RPM 发行版或 ARM 用户建议选 Clash Verge Rev。前往下载页面获取两款客户端。

Mihomo 内核 / CLI 使用教程

适用于 Linux 服务器、NAS、Docker 容器、路由器及 Windows 无界面场景的命令行部署教程

本教程面向高级用户,适合需要在服务器、NAS、路由器或容器中无图形界面运行 Mihomo(Clash Meta)的场景。如果你只是普通用户,建议使用 WindowsmacOSLinux 标签中的图形化客户端教程。
步骤 1

下载 Mihomo 内核二进制

前往 下载页面 → Core / CLI,根据目标设备的操作系统和架构选择对应的二进制文件:

  • Linux x86_64 服务器 / VPS / NAS:下载 mihomo-linux-amd64.gz(压缩包)或 mihomo-linux-amd64.deb(Debian/Ubuntu 软件包,推荐)
  • Linux ARM64(树莓派、ARM 服务器):在 GitHub Releases 下载 mihomo-linux-arm64.gz
  • Windows x64:下载 mihomo-windows-amd64.zip
Mihomo 是 Clash Meta 内核的正式名称(即原 clash-meta 项目),是目前功能最完整、最活跃维护的 Clash 核心引擎,支持 Hysteria2、TUIC、VLESS、Reality 等全部新型协议。
步骤 2

准备 Clash 配置文件

Mihomo 通过单个 YAML 配置文件(config.yaml)驱动,你需要准备一个有效的 Clash 格式配置文件。有两种方式获取:

手动编写最小配置

如需从零开始构建配置,以下是包含基本代理设置的最小可用 config.yaml:

~/.config/mihomo/config.yaml(最小示例)
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 114.114.114.114
    - 223.5.5.5

proxies:
  - name: "my-node"
    type: vmess
    server: example.com
    port: 443
    uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    alterId: 0
    cipher: auto
    tls: true

proxy-groups:
  - name: "Proxy"
    type: select
    proxies: ["my-node", "DIRECT"]

rules:
  - MATCH,Proxy
Linux 默认配置目录为 ~/.config/mihomo/,Windows 默认目录为 %USERPROFILE%\.config\mihomo\。也可通过 -d <目录> 参数指定自定义目录。
步骤 3

Linux — 通过 .deb 安装并注册 systemd 服务(推荐)

使用 .deb 软件包安装是 Debian / Ubuntu 系统上最推荐的方式,会自动注册 systemd 服务,支持开机自启和进程守护:

Ubuntu / Debian — 安装 .deb 并启动服务
# 安装 .deb 包(自动注册 systemd 服务)
sudo apt install ./mihomo-linux-amd64.deb

# 将配置文件放入服务目录
sudo mkdir -p /etc/mihomo
sudo cp ~/.config/mihomo/config.yaml /etc/mihomo/config.yaml

# 启用并立即启动 mihomo 服务
sudo systemctl enable --now mihomo

# 查看运行状态
systemctl status mihomo

# 实时查看日志
journalctl -u mihomo -f
常用服务管理命令
# 停止服务
sudo systemctl stop mihomo

# 重启服务(修改配置后执行)
sudo systemctl restart mihomo

# 禁用开机自启
sudo systemctl disable mihomo

# 查看最近 100 行日志
journalctl -u mihomo -n 100
.deb 安装后,Mihomo 的配置目录为 /etc/mihomo/,systemd 服务文件位于 /etc/systemd/system/mihomo.service,修改配置后需执行 sudo systemctl restart mihomo 使其生效。
步骤 4

Linux — 使用独立二进制(.gz)

如果你不使用 .deb 包,可以直接下载压缩的二进制文件解压后运行:

Linux — 独立二进制部署
# 解压并赋予执行权限
gunzip mihomo-linux-amd64.gz
chmod +x mihomo-linux-amd64
sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo

# 创建配置目录
mkdir -p ~/.config/mihomo
# 将 config.yaml 放入 ~/.config/mihomo/

# 前台运行(调试用)
mihomo -d ~/.config/mihomo

# 后台运行
nohup mihomo -d ~/.config/mihomo > ~/.config/mihomo/mihomo.log 2>&1 &
echo $! > ~/.config/mihomo/mihomo.pid

如需手动创建 systemd 服务文件(不使用 .deb 时):

/etc/systemd/system/mihomo.service(手动创建)
[Unit]
Description=Mihomo Clash Meta Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target
注册并启动自定义服务
sudo systemctl daemon-reload
sudo systemctl enable --now mihomo
步骤 5

Windows — PowerShell 运行 Mihomo

Windows 用户可通过 PowerShell 直接运行 Mihomo 二进制,或通过任务计划程序实现开机自启:

Windows PowerShell — 解压并运行
# 解压 zip 包
Expand-Archive mihomo-windows-amd64.zip -DestinationPath .\mihomo

# 进入目录
cd .\mihomo

# 创建配置目录并放入 config.yaml
New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\mihomo"
# (将 config.yaml 复制到上述目录)

# 前台运行
.\mihomo.exe -d "$env:USERPROFILE\.config\mihomo"

通过任务计划程序实现开机自启:

Windows PowerShell — 注册开机自启任务
# 以管理员身份在 PowerShell 中执行
$action = New-ScheduledTaskAction `
    -Execute "C:\path\to\mihomo.exe" `
    -Argument "-d `"$env:USERPROFILE\.config\mihomo`""
$trigger = New-ScheduledTaskTrigger -AtLogOn
$settings = New-ScheduledTaskSettingsSet -ExecutionTimeLimit 0
Register-ScheduledTask -TaskName "Mihomo" `
    -Action $action -Trigger $trigger `
    -Settings $settings -RunLevel Highest -Force
Windows 上如需开启 TUN 模式,Mihomo 必须以管理员权限运行。右键点击 PowerShell 选择「以管理员身份运行」,或在任务计划程序中将「运行级别」设为「最高权限」。
步骤 6

Docker 容器部署

使用 Docker 是在服务器上部署 Mihomo 最干净的方式,无需手动管理依赖:

docker-compose.yml
services:
  mihomo:
    image: metacubex/mihomo:latest
    container_name: mihomo
    restart: unless-stopped
    network_mode: host          # 使用 host 网络以便 TUN 模式生效
    cap_add:
      - NET_ADMIN               # TUN 模式所需权限
    devices:
      - /dev/net/tun:/dev/net/tun
    volumes:
      - ./config:/root/.config/mihomo  # 挂载配置目录
    environment:
      - TZ=Asia/Shanghai
启动与管理
# 将 config.yaml 放入 ./config/ 目录后启动
docker compose up -d

# 查看日志
docker compose logs -f mihomo

# 更新镜像后重启
docker compose pull && docker compose up -d

# 停止并删除容器
docker compose down
如不需要 TUN 模式,可移除 cap_adddevicesnetwork_mode: host,改用普通端口映射(ports: - "7890:7890" - "9090:9090"),安全性更高。
步骤 7

使用 Web 管理面板(Dashboard)

Mihomo 内置 RESTful API,可通过开源 Web 面板实时监控流量、切换节点、查看连接,无需命令行操作。

首先确保配置文件中已开启外部控制器:

config.yaml — 开启外部控制器
external-controller: 127.0.0.1:9090   # API 监听地址(远程访问改为 0.0.0.0:9090)
secret: "your-secret-key"              # API 密钥(留空则无需鉴权,远程访问请务必设置)

# 可选:内嵌面板(自动下载 metacubexd 到本地)
external-ui: ui
external-ui-url: "https://github.com/MetaCubeX/metacubexd/archive/refs/heads/gh-pages.zip"

启动 Mihomo 后,在浏览器访问以下任一在线面板,填入控制器地址和密钥即可:

若将 external-controller 设为 0.0.0.0:9090 以供外网访问,务必设置强密码secret 字段),否则任何人均可控制你的代理节点。
常见问题

Core / CLI 使用常见问题

启动报错「level=fatal msg="Parse config error: ...」?
配置文件格式错误。常见原因:① YAML 缩进不正确(必须使用空格,不能用 Tab);② 机场订阅链接返回的不是 Clash 格式(尝试在 URL 后加 ?flag=clash);③ 配置文件编码不是 UTF-8。可用 mihomo -t -d ~/.config/mihomo 命令进行语法检测而不实际启动。
端口 7890 已被占用启动失败?
修改配置文件中的 mixed-port 为其他可用端口(如 7892);或先找到占用进程:Linux 执行 lsof -i :7890,Windows 执行 netstat -ano | findstr 7890,终止冲突进程后再启动 Mihomo。
如何让局域网内其他设备通过 Mihomo 代理上网?
在 config.yaml 中设置 allow-lan: true,并确保防火墙开放了 mixed-port 对应的端口。其他设备在网络设置中配置 HTTP 代理为运行 Mihomo 的设备 IP(如 192.168.1.100:7890)即可共享代理。
如何自动更新订阅?
在 config.yaml 中配置 proxy-providers 引用订阅 URL,并设置 interval(单位秒),Mihomo 会自动在后台定期刷新节点列表,无需重启服务。也可以通过 cron 任务定期执行 curl 重新下载 config.yaml 后调用 API 热重载配置:curl -X PUT http://127.0.0.1:9090/configs?force=true -d '{"path":"/etc/mihomo/config.yaml"}'
我应该选 .gz 二进制还是 .deb 包?
Debian / Ubuntu 服务器推荐 .deb 包,自动注册 systemd 服务,开机自启和日志管理都更方便;其他 Linux 发行版(Fedora / Arch / Alpine 等)或需要完全手动控制时选 .gz 二进制,解压即用,灵活性更高。

Clash 进阶使用技巧

掌握以下技巧,让 Clash 发挥更强大的功能,满足个性化代理需求。

DNS 防泄漏配置

在 YAML 配置的 dns 字段中设置 enhanced-mode: fake-ip,并配置 DoH(https://8.8.8.8/dns-query)或 DoT 作为 fallback DNS,防止 DNS 查询泄露真实 IP。

config.yaml
dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - 114.114.114.114
    - 223.5.5.5
  fallback:
    - https://8.8.8.8/dns-query
    - https://1.1.1.1/dns-query

Rule Provider 规则集订阅

使用 Rule Provider 从远程订阅分流规则集,无需手动维护规则,自动保持最新。Clash Meta 支持 DOMAIN、IPCIDR 等多种规则集格式。

config.yaml
rule-providers:
  reject:
    type: http
    behavior: domain
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
    interval: 86400

代理组(Proxy Group)配置

通过 Proxy Group 实现高级流量调度策略:url-test 自动选择最低延迟节点,fallback 自动故障转移,load-balance 多节点负载均衡。

config.yaml
proxy-groups:
  - name: "Auto"
    type: url-test
    proxies: [Node-HK, Node-US, Node-JP]
    url: http://www.gstatic.com/generate_204
    interval: 300

外部控制面板(Dashboard)

Clash Meta 内置 RESTful API,可通过 Web 面板实时监控流量、管理节点。访问 d.metacubex.one,填入控制器地址(默认 127.0.0.1:9090)和密钥即可。

使用教程常见问题解答

整理了用户在配置和使用 Clash 过程中最常遇到的问题,帮你快速排查。

可能原因:① 订阅链接不是 Clash 格式,联系机场获取专用 Clash 订阅 URL;② 本地网络无法访问订阅地址,先开启其他代理再更新订阅;③ 订阅已过期,重新购买机场服务;④ 链接中含有特殊字符,粘贴时确保完整复制。
① 手动测速选择延迟最低的节点;② 尝试不同的节点地区(香港节点通常延迟最低);③ 如果机场提供 Hysteria2 或 TUIC 协议节点,优先选择这些新协议(弱网下速度更快);④ 代理模式选「规则」而非「全局」,避免国内流量绕行;⑤ 检查机场套餐是否有限速,必要时升级套餐。
访问 ipaddress.comifconfig.me,查看显示的 IP 地址是否为代理节点所在国家/地区的 IP,如果是则代理生效;也可以在 Clash 的「连接」标签页实时查看正在代理的连接记录。
在 Clash 配置文件中设置 allow-lan: true,同时确保防火墙允许局域网设备访问 7890 端口。其他设备在网络设置中将 HTTP/HTTPS 代理指向运行 Clash 的设备局域网 IP(如 192.168.1.100:7890)即可共享代理,无需在每台设备上都安装 Clash。
Clash 客户端本身不会上传任何数据,代码完全开源可审计。代理流量经过你选择的机场节点服务器中转——机场服务商可能记录连接日志(具体取决于服务商政策)。Clash 软件本身是安全的,使用前请阅读并信任你选择的机场服务商的隐私政策。
还没下载客户端?

免费下载 Clash 客户端,立即开始配置

支持 Windows、macOS、Linux、Android、iOS 全平台,完全免费开源。结合本页教程,5 分钟即可完成全部配置,体验国内直连、境外畅通的智能代理。