使用教程中心
5 分钟配置 Clash,全平台图文教程
从安装到智能分流,手把手带你完成 Clash 全部配置。支持 Windows、macOS、Android、iOS、Linux,以及 Mihomo Core / CLI 命令行服务器部署,零基础新手与高级用户均适用。
三步完成 Clash 全部配置
无论你使用哪个平台,核心流程都相同。下方分平台教程提供更详细的图文说明。
下载并安装客户端
根据你的操作系统选择对应的 Clash 图形化客户端。Windows 推荐 Clash Verge Rev 或 FlClash(两者均活跃维护,免费开源);macOS 推荐 Clash Verge Rev 或 FlClash(两款均支持 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 推荐 Stash 或 Shadowrocket;服务器 / NAS / 路由器 / Docker 等无界面场景推荐使用 Mihomo Core(命令行二进制)。
前往下载页面导入机场订阅链接
从机场服务商(代理节点提供商)获取 Clash 格式的订阅 URL,复制粘贴到客户端的「配置」或「订阅」页面,点击更新即可。客户端自动解析节点列表与分流规则,无需手动编写任何 YAML 配置。
选择节点,开启代理
在节点列表中选择延迟低的代理节点,开启「系统代理」(轻量模式)或「TUN 模式」(全局透明代理)。Clash 自动分流——国内网站直连保速,境外服务走代理,无感知智能切换。
下载并安装 Windows 客户端
前往 下载页面,Windows 平台目前有两款活跃维护的免费客户端可选:
Clash Verge Rev
基于 Tauri 框架,界面精美、资源占用低,社区最活跃推荐的 Clash 客户端。支持 x64 与 ARM64。
- 大多数用户选
Clash%20Verge_2.4.7_x64-setup.exe(适合绝大多数台式机 / 笔记本) - Surface Pro X 等 ARM 设备选
clash-verge-rev-win-arm64.exe
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,在左侧导航栏点击「订阅」(Profiles),然后:
- 点击右上角「新建」或输入框
- 将机场提供的 Clash 订阅 URL 粘贴进去
- 点击「导入」或按 Enter 确认
- 等待订阅下载完成,配置文件会出现在列表中
- 点击配置文件右侧的「使用此配置」将其激活(选中状态)
https://your-airport.com/api/v1/client/subscribe?token=xxxxxxxx&flag=clash
查看并选择代理节点
在左侧导航点击「代理」(Proxies),你会看到所有可用节点和策略组:
- 点击任意策略组(如「Proxy」),在下方节点列表中选择延迟低的节点
- 点击节点右侧的闪电图标可以手动测速,显示当前实时延迟
- 「自动选择」策略会根据延迟自动切换最优节点,适合不想手动管理的用户
开启系统代理
在 Clash Verge Rev 右上角,找到「系统代理」开关,点击将其打开(变为蓝色)。
- 系统代理模式会自动配置 Windows 系统代理设置,浏览器等支持系统代理的应用立即生效
- Clash 默认监听
127.0.0.1:7890(HTTP 代理)和127.0.0.1:7891(SOCKS5 代理) - 验证是否生效:在浏览器中访问 google.com,能正常打开即配置成功
开启 TUN 模式(全局透明代理)
TUN 模式可以代理所有流量(包括游戏、命令行工具等不支持系统代理的程序),推荐进阶用户开启:
- 在 Clash Verge Rev 设置页面,找到「TUN 模式」开关,点击开启
- 系统会弹出 UAC 权限提示,点击「是」授予管理员权限(TUN 需要系统权限创建虚拟网卡)
- TUN 模式开启后,系统代理开关可以关闭,TUN 会全面接管所有流量
Windows 使用常见问题
PROCESS-NAME,xxx.exe,DIRECT 规则;或在客户端代理规则页面手动添加直连规则。下载并安装 macOS 客户端
前往 下载页面,macOS 平台目前有两款活跃维护的免费客户端可选:
Clash Verge Rev
基于 Tauri 框架,界面精美、资源占用低,社区最活跃推荐的 Clash 客户端,同时支持 macOS 与 Linux。
- M1 / M2 / M3 / M4 芯片 Mac:下载
Clash%20Verge_2.4.7_aarch64.dmg - Intel 芯片 Mac(2020 年前):下载
Clash%20Verge_2.4.7_x64.dmg
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
.dmg 文件,将应用图标拖入 Applications(应用程序)文件夹完成安装。两款客户端后续的导入订阅、选节点、开启代理步骤基本一致,本教程以 Clash Verge Rev 为例说明。解除 macOS Gatekeeper 限制
首次打开客户端时,macOS 可能提示「无法打开,因为无法验证开发者」,这是正常现象(Clash Verge Rev 与 FlClash 均为开源软件,未进行 Apple 付费公证)。有两种方法解决:
通过系统设置允许
- 打开「系统设置」→「隐私与安全性」
- 向下滚动,找到关于客户端应用的提示
- 点击「仍要打开」按钮并输入密码确认
终端命令方式
打开「终端」应用,根据所选客户端执行对应命令:
sudo xattr -r -d com.apple.quarantine /Applications/ClashVergeRev.app
sudo xattr -r -d com.apple.quarantine /Applications/FlClash.app
导入机场订阅链接
打开 Clash Verge Rev,在左侧导航点击「订阅」:
- 点击「新建」按钮
- 在 URL 输入框中粘贴机场提供的订阅链接
- (可选)填写备注名称,方便区分多个订阅
- 点击「导入」,等待配置文件下载完成
- 点击配置文件,将其设为当前使用的配置
选择节点并开启系统代理
在「代理」页面选择节点后,开启右上角「系统代理」开关:
- macOS 会弹出网络权限请求,点击「好」授权
- Clash Verge Rev 会自动配置 macOS 系统代理,Safari、Chrome 等浏览器立即生效
- 菜单栏会出现 Clash 状态图标,点击可快速切换节点
google.com,能正常加载即代表配置成功。开启增强模式(TUN)
需要代理所有流量(包括不支持系统代理的命令行工具、游戏等)时,开启增强模式:
- 在设置中找到「TUN 模式」或「增强模式」
- 开启后会请求安装系统扩展,输入 macOS 密码确认
- 在「隐私与安全性」中允许安装系统扩展
- 重启 Clash Verge Rev 后 TUN 模式生效
macOS 使用常见问题
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890下载并安装 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 订阅,界面简洁,适合偏好轻便体验的用户
导入订阅配置
打开客户端(FlClash / CMFA / Surfboard),在底部导航点击「配置」:
- 点击右上角「+」按钮,选择「URL」
- 在名称栏输入任意备注,在 URL 栏粘贴机场订阅链接
- 点击右上角保存图标,然后点击「更新」下载配置
- 下载完成后,点击配置名称旁的圆点将其选为当前使用的配置
选择节点并启动代理
- 在底部导航点击「代理」,查看并选择策略组中的节点
- 点击节点右侧的测速图标测试延迟,选择延迟低的节点
- 返回首页,点击大型「启动」按钮(播放图标)
- 系统弹出 VPN 连接授权提示,点击「确定」
- 状态变为「运行中」,通知栏出现 VPN 图标即代理已生效
配置 TUN 模式(全局代理)
FlClash 与 CMFA 均默认使用 Android VPN API 接管流量,无需额外配置即可实现类似 TUN 的全局代理效果。如需更精细的控制:
- 在「设置 → 覆写」中可自定义代理模式(规则/全局/直连)
- 「绕过私有网络」选项可以让局域网流量不走代理,推荐开启
- 在「设置 → 访问控制」可设置哪些应用走代理(按应用过滤);Surfboard 用户可在「应用代理」中按 App 单独配置
Android 使用常见问题
切换非国区 Apple ID 并购买
- 打开 App Store,点击右上角头像,滑到底部点击「退出登录」
- 使用美区或港区 Apple ID 重新登录(可向朋友借用或自行注册)
- 搜索「Stash」或「Shadowrocket」,付费购买并下载
- 下载完成后,切换回你的国区 Apple ID 即可,已购买的 App 不会消失
在 Stash 中导入订阅
- 打开 Stash,点击底部「首页」
- 点击「添加配置文件」→「从 URL 下载」
- 粘贴机场提供的 Clash 订阅 URL,点击「下载」
- 配置下载成功后自动切换为当前使用的配置
- 在「策略组」页面选择节点,或使用自动选择
在 Shadowrocket(小火箭)中导入订阅
- 打开 Shadowrocket,点击右上角「+」
- 「类型」选择「Subscribe(订阅)」
- 在 URL 栏粘贴机场的订阅链接,添加备注
- 点击右上角「完成」,等待节点加载完成
- 在节点列表中选择延迟低的节点
启动代理
导入配置并选好节点后,在应用首页点击「未连接」旁边的开关,将其打开:
- iOS 会弹出「此 App 想要添加 VPN 配置」授权提示,点击「允许」并输入 Face ID / 密码
- 状态显示「已连接」,状态栏出现 VPN 图标即代理已生效
- 打开 Safari 访问 google.com 验证是否正常
iOS 使用常见问题
?flag=clash 参数后重试。下载并安装 Linux 客户端
前往 下载页面,Linux 平台目前有两款活跃维护的免费客户端可选:
Clash Verge Rev
基于 Tauri 框架,功能最完善的 Linux 图形化客户端,提供 .deb、.rpm 两种格式,同时支持 AUR,覆盖所有主流发行版。
- Ubuntu / Debian:下载
Clash%20Verge_2.4.7_amd64.deb - Fedora / RHEL / openSUSE:下载
Clash%20Verge-2.4.7-1.x86_64.rpm - Arch Linux / Manjaro(AUR):见下方安装命令
sudo apt install ./Clash%20Verge_2.4.7_amd64.deb
sudo rpm -i Clash%20Verge-2.4.7-1.x86_64.rpm
paru -S clash-verge-rev
# 或使用 yay
yay -S clash-verge-rev
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
sudo apt install ./FlClash-0.8.93-linux-amd64.deb
导入订阅配置
与 Windows / macOS 版操作完全一致:
- 打开 Clash Verge Rev(或 FlClash),点击「订阅」页面
- 点击「新建」,粘贴机场订阅 URL
- 点击「导入」,等待配置下载完成
- 点击配置将其设为当前使用的配置
开启代理
Linux 下 Clash 提供两种代理方式:
系统代理(GNOME / KDE)
在 Clash Verge Rev 或 FlClash 中开启「系统代理」,支持 GNOME 和 KDE 桌面环境自动配置代理。
终端环境变量方式
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-settings-daemon;KDE 用户检查系统设置中代理配置。部分发行版需手动在网络设置中添加代理:主机 127.0.0.1,端口 7890。~/.config/autostart/clash-verge-rev.desktop 自启动文件,指向客户端的可执行文件路径。WAYLAND_DISPLAY="" 后启动,强制在 XWayland 下运行。FlClash 基于 Flutter,Wayland 兼容性通常更好。下载 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
准备 Clash 配置文件
Mihomo 通过单个 YAML 配置文件(config.yaml)驱动,你需要准备一个有效的 Clash 格式配置文件。有两种方式获取:
使用机场订阅链接下载配置
直接用 curl 或 wget 将机场的 Clash 订阅下载为 config.yaml,是最快的方式。
mkdir -p ~/.config/mihomo
curl -L "https://your-airport.com/api/v1/client/subscribe?token=xxxx&flag=clash" \
-o ~/.config/mihomo/config.yaml
手动编写最小配置
如需从零开始构建配置,以下是包含基本代理设置的最小可用 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
~/.config/mihomo/,Windows 默认目录为 %USERPROFILE%\.config\mihomo\。也可通过 -d <目录> 参数指定自定义目录。Linux — 通过 .deb 安装并注册 systemd 服务(推荐)
使用 .deb 软件包安装是 Debian / Ubuntu 系统上最推荐的方式,会自动注册 systemd 服务,支持开机自启和进程守护:
# 安装 .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
/etc/mihomo/,systemd 服务文件位于 /etc/systemd/system/mihomo.service,修改配置后需执行 sudo systemctl restart mihomo 使其生效。Linux — 使用独立二进制(.gz)
如果你不使用 .deb 包,可以直接下载压缩的二进制文件解压后运行:
# 解压并赋予执行权限
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 时):
[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
Windows — PowerShell 运行 Mihomo
Windows 用户可通过 PowerShell 直接运行 Mihomo 二进制,或通过任务计划程序实现开机自启:
# 解压 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"
通过任务计划程序实现开机自启:
# 以管理员身份在 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
Docker 容器部署
使用 Docker 是在服务器上部署 Mihomo 最干净的方式,无需手动管理依赖:
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
cap_add、devices 和 network_mode: host,改用普通端口映射(ports: - "7890:7890" - "9090:9090"),安全性更高。使用 Web 管理面板(Dashboard)
Mihomo 内置 RESTful API,可通过开源 Web 面板实时监控流量、切换节点、查看连接,无需命令行操作。
首先确保配置文件中已开启外部控制器:
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 后,在浏览器访问以下任一在线面板,填入控制器地址和密钥即可:
- MetaCubeXD(推荐):d.metacubex.one
- Yacd-meta:yacd.metacubex.one
- 本地内嵌面板(配置了 external-ui 后):
http://127.0.0.1:9090/ui
external-controller 设为 0.0.0.0:9090 以供外网访问,务必设置强密码(secret 字段),否则任何人均可控制你的代理节点。Core / CLI 使用常见问题
?flag=clash);③ 配置文件编码不是 UTF-8。可用 mihomo -t -d ~/.config/mihomo 命令进行语法检测而不实际启动。mixed-port 为其他可用端口(如 7892);或先找到占用进程:Linux 执行 lsof -i :7890,Windows 执行 netstat -ano | findstr 7890,终止冲突进程后再启动 Mihomo。allow-lan: true,并确保防火墙开放了 mixed-port 对应的端口。其他设备在网络设置中配置 HTTP 代理为运行 Mihomo 的设备 IP(如 192.168.1.100:7890)即可共享代理。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"}'Clash 进阶使用技巧
掌握以下技巧,让 Clash 发挥更强大的功能,满足个性化代理需求。
DNS 防泄漏配置
在 YAML 配置的 dns 字段中设置 enhanced-mode: fake-ip,并配置 DoH(https://8.8.8.8/dns-query)或 DoT 作为 fallback DNS,防止 DNS 查询泄露真实 IP。
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 等多种规则集格式。
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 多节点负载均衡。
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 过程中最常遇到的问题,帮你快速排查。
ifconfig.me,查看显示的 IP 地址是否为代理节点所在国家/地区的 IP,如果是则代理生效;也可以在 Clash 的「连接」标签页实时查看正在代理的连接记录。allow-lan: true,同时确保防火墙允许局域网设备访问 7890 端口。其他设备在网络设置中将 HTTP/HTTPS 代理指向运行 Clash 的设备局域网 IP(如 192.168.1.100:7890)即可共享代理,无需在每台设备上都安装 Clash。免费下载 Clash 客户端,立即开始配置
支持 Windows、macOS、Linux、Android、iOS 全平台,完全免费开源。结合本页教程,5 分钟即可完成全部配置,体验国内直连、境外畅通的智能代理。