DOCS // 使用教程

Clash 使用教程

从安装到高级配置，全平台完整指引。无论你是初次接触 Clash 的新手，还是需要深入定制规则分流的进阶用户，本页均提供对应的操作步骤与配置示例。

适用版本：Clash v3.0.0+ 更新日期：2025-03-15

三步极速上手 [QUICKSTART]

Clash 是一个基于规则的网络代理客户端，核心依赖 YAML 配置文件驱动。以下三个步骤帮助你在 5 分钟内完成基本配置，开始使用代理。

01
下载客户端

前往下载页，根据操作系统选择 Clash 客户端。Windows 推荐 Clash for Windows 或 Clash Verge Rev，macOS 推荐 ClashX Meta，Android 推荐 Clash Meta。

02
导入订阅配置

在客户端的 Profiles / 配置面板中粘贴服务商提供的 YAML 订阅链接，点击下载，客户端将自动解析节点、规则集与策略组，零手动操作。

03
启动系统代理

点击客户端中的「系统代理」开关，立即开始享受规则分流的低延迟网络体验。如需接管所有流量（含游戏、终端），请参考 TUN 模式配置章节。

提示 如果你没有节点资源，需要先从代理服务商（通常称为"机场"）购买订阅，获取一个 https://... 格式的订阅链接，才能正常使用 Clash。Clash 本身仅是免费开源客户端，不提供任何节点或服务。

平台安装教程 [PLATFORM]

选择你的操作系统，查看对应的完整安装与初始配置步骤。

Windows Clash 客户端安装教程

Windows 平台推荐使用经典的 Clash for Windows 或现代化的 Clash Verge Rev。两者均完美支持 Windows 10/11，并兼容所有 YAML 订阅链接。

  1. 下载与安装
    前往下载页，下载 Clash for Windows 或 Clash Verge Rev 的 .exe 安装包。运行安装程序时，若弹出 SmartScreen 提示，请点击「更多信息」→「仍要运行」。
  2. 导入订阅配置
    Clash for Windows：点击左侧 Profiles，在顶部粘贴订阅链接，点击 Download。下载后点击生成的配置文件名称激活。
    Clash Verge Rev：点击左侧 订阅，在顶部粘贴链接并保存，随后点击该订阅条目进行激活。
  3. 开启代理
    Clash for Windows：在 General 页面开启 System Proxy 开关。
    Clash Verge Rev：在 设置 中开启 系统代理 开关。此时状态栏图标变色即代表代理已生效。
  4. （进阶）开启 TUN 模式
    若需代理游戏或终端流量，请开启 TUN 模式。 Clash for Windows 需先点击 General → Service Mode → Install 安装服务；Clash Verge Rev 可在设置中直接启用 TUN 模式并授权。
系统要求 支持 Windows 10 / 11 (64-bit)。推荐系统版本 1903 以上，并确保已内置 WebView2 Runtime 环境。

macOS Clash 客户端教程

macOS 推荐使用 Clash Verge Rev 或 ClashX Meta。两者均支持 Mihomo 内核，适配 Apple Silicon (M1/M2/M3) 及 Intel 芯片。

  1. 下载与安装
    前往下载页，根据芯片类型下载 Clash Verge Rev (.dmg) 或 ClashX Meta (.zip)。拖入 Applications 文件夹完成安装。
  2. 导入订阅配置
    Clash Verge Rev：在“订阅”页面点击右上角“+”，粘贴 URL 并保存。
    ClashX Meta：点击菜单栏图标 → Config → Remote config → Manage，点击 Add 粘贴链接。
  3. 开启系统代理
    点击菜单栏图标，选择 Set as System Proxy（设置系统代理）。图标变色即代表配置成功。
  4. （进阶）开启增强模式
    点击菜单栏图标 → Enhanced Mode（增强模式），按系统提示安装网络扩展。该模式等同于 TUN，可代理全局流量。
提示 若启动时提示“无法验证开发者”，请前往 系统设置 → 隐私与安全性，在页面底部点击“仍要打开”。

Clash Meta for Android 安装教程

Android 平台推荐使用 Clash Meta for Android。它基于开源的 Mihomo 内核，提供比原版更强大的功能支持（如更多的加密协议）。

  1. 下载并安装 APK
    前往下载页，推荐下载 Universal APK（自动适配架构）。下载后运行 APK 完成安装（需在系统设置中允许“安装未知应用”）。
  2. 导入订阅配置
    打开 Clash Meta for Android，点击 配置 → 右上角 + → 选择「从 URL 导入」。粘贴订阅链接后点击右上角保存图标，然后点击激活该配置。
  3. 启动代理
    回到首页，点击右下角灰色 已停止 按钮。在系统弹出 VPN 授权请求时点击「确定」，按钮变为 运行中 即可。
  4. （进阶）开启 TUN 模式
    在 设置 → 网络 中勾选 自动路由（即开启 TUN 模式）。该模式无需系统 VPN 授权即可接管全流量（部分版本可能仍需授权）。
注意 若安装时提示「解析安装包时出现问题」，请确保下载的是 Universal 版本，且 Android 版本高于 5.0。

iOS / iPadOS Clash 系客户端教程

重要提示 由于 Apple 平台政策，iOS 上没有名为"Clash"的官方 App，需使用兼容 Clash 配置格式的第三方客户端。以下以 Stash 和 Shadowrocket 为例进行说明。两款应用均需从非中国区 App Store 购买。

Stash 使用教程

  1. 在 App Store 购买并下载 Stash
    使用美区 / 港区 Apple ID，在 App Store 搜索 Stash 并购买（约 ¥30）。
  2. 添加订阅配置
    打开 Stash → 配置 标签 → 右上角 + → 选择「从 URL 导入」，粘贴订阅链接，输入配置名称后点击「完成」。
  3. 启动代理
    切换至 主页 标签，点击「连接」按钮，iOS 系统将弹出 VPN 授权请求，点击「允许」即开始代理。
  4. 选择节点
    在 代理 标签中可查看各策略组并手动选择节点，也可点击⚡按钮进行延迟测试自动选优。

Shadowrocket 使用教程

  1. 购买并下载 Shadowrocket
    使用美区 Apple ID，在 App Store 搜索 Shadowrocket 并购买（$2.99）。
  2. 导入订阅链接
    打开 Shadowrocket → 点击右上角 + → 类型选择「Subscribe」→ 粘贴订阅 URL → 点击「完成」。订阅节点将自动解析并显示在列表中。
  3. 启动连接
    在节点列表中选择一个节点，然后打开顶部 Connected 开关，点击「Allow」授权 VPN，即开始代理。

Surge 5 使用教程

  1. 下载 Surge 5
    在 App Store 搜索并下载 Surge 5。该应用提供 14 天免费试用，之后需购买授权。
  2. 导入配置文件
    在首页点击「首选配置」→「从 URL 下载」，粘贴订阅链接并下载。
  3. 启动代理
    点击右上角的「启动」按钮并授权。Surge 5 能够自动识别大多数 Clash 订阅格式。

Linux Clash 客户端教程 (GUI)

对于桌面端 Linux 用户，推荐使用 Clash Verge Rev。它提供完整的图形界面和 TUN 模式支持，适配 Ubuntu、Debian、Fedora 等主流发行版。

  1. 下载与安装
    前往下载页，下载适合您发行版的安装包（Ubuntu/Debian 选 .deb，Fedora/CentOS 选 .rpm）。使用包管理器完成安装。
  2. 导入订阅
    启动 Clash Verge，进入“订阅”选项卡，点击右上角“+”，粘贴 URL 并保存。
  3. 开启代理
    在主界面开启“系统代理”开关。如需全流量接管，请在设置中开启 TUN 模式（可能需要 sudo 权限）。

Clash Core for Linux (进阶/服务器)

适合无图形界面的服务器环境或进阶用户手动部署。

  1. 下载并解压内核
    下载适合架构的 .gz 压缩包，解压并赋予可执行权限：
    $wget https://clashconf.com/assets/clients/core/mihomo-linux-amd64.gz
    $gunzip mihomo-linux-amd64.gz
    $chmod +x mihomo-linux-amd64
    $sudo mv mihomo-linux-amd64 /usr/local/bin/clash
  2. 放置配置文件
    将 config.yaml（从服务商下载，或手动编写）放置到 Clash 配置目录：
    $mkdir -p ~/.config/clash
    $cp config.yaml ~/.config/clash/config.yaml
  3. 启动 Clash
    执行以下命令启动 Clash，默认会在 127.0.0.1:9090 开启 RESTful API：
    $clash -d ~/.config/clash
    # INFO[0000] Start initial compatible provider 默认
    # INFO[0000] Clash is running, RESTful API: 127.0.0.1:9090
  4. 配置系统代理
    Clash 默认监听 HTTP 端口 7890 和 SOCKS5 端口 7891。在系统网络设置或终端环境变量中配置：
    $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
提示 如需开机自启，可参考 Wiki 中使用 systemd 服务单元文件注册 Clash 为系统服务的说明。

导入订阅配置 [SUBSCRIPTION]

订阅链接（Subscription URL）是服务商提供的 YAML 格式配置文件在线地址，通常以 https:// 开头。Clash 客户端通过此链接自动下载并解析节点列表、规则集与策略组。

什么是订阅链接

订阅链接本质上是一个指向 YAML 配置文件的 URL。每次在客户端更新订阅时，Clash 会重新请求该 URL 获取最新的节点信息和规则，确保配置始终为最新状态。

订阅更新频率建议

最佳实践 建议在客户端中设置自动更新订阅间隔为 24h（每天一次），以保持节点信息最新。在节点列表异常或出现大量超时时，可手动点击「更新」强制刷新订阅。

导入步骤对照表

平台 / 客户端 导入路径 激活方式
Clash for Windows Profiles → 顶部 URL 输入框 → 回车 点击配置文件名称
ClashX Pro (macOS) 菜单栏图标 → Config → Remote config → Manage 点击 Select
Clash for Android 配置 → + → 从 URL 导入 点击配置旁圆形按钮
Stash (iOS) 配置 → + → 从 URL 导入 点击完成后自动激活
Clash Core (Linux) wget <URL> -O ~/.config/clash/config.yaml 重启 Clash 进程

YAML 配置详解 [CONFIG.YAML]

Clash 所有的行为均由 config.yaml 驱动。了解核心字段含义，能帮助你精准调整代理行为、添加自定义节点并编写高级分流规则。

基础端口与运行模式

~/.config/clash/config.yaml
# HTTP proxy port
port: 7890
# SOCKS5 proxy port
socks-port: 7891
# Allow LAN devices to use proxy (true/false)
allow-lan: false
# Proxy mode: rule | global | direct
mode: rule
# Log level: info | warning | error | debug | silent
log-level: info
# RESTful API port
external-controller: 127.0.0.1:9090

代理节点（proxies）

proxies 字段定义所有可用出站节点，支持 Shadowsocks、VMess、Trojan、VLESS、Hysteria2、WireGuard 等协议：

proxies section
proxies:
  - name: "🇭🇰 香港-01" # node display name
    type: ss # protocol: ss / vmess / trojan / vless / hy2 / wireguard
    server: hk01.example.com
    port: 8388
    cipher: aes-256-gcm
    password: "your_password"
  - name: "🇯🇵 日本-VMess"
    type: vmess
    server: jp01.example.com
    port: 443
    uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    alterId: 0
    cipher: auto
    tls: true

支持的协议类型

Shadowsocks (ss) ShadowsocksR (ssr) VMess VLESS Trojan Hysteria2 (hy2) TUIC WireGuard SOCKS5 / HTTP(S) Snell

策略组（proxy-groups）

策略组将多个节点按指定选择策略进行分组，支持 select（手动选择）、url-test（自动延迟优选）、fallback（故障转移）、load-balance（负载均衡）四种模式：

proxy-groups section
proxy-groups:
  - name: "PROXY" # main outbound group
    type: select # manual selection
    proxies:
      - Auto-Select
      - 🇭🇰 香港-01
      - 🇯🇵 日本-VMess
  - name: "Auto-Select"
    type: url-test # auto select lowest latency
    proxies:
      - 🇭🇰 香港-01
      - 🇯🇵 日本-VMess
    url: "http://www.gstatic.com/generate_204"
    interval: 300 # test every 300 seconds

TUN 模式配置 [TUN MODE]

TUN 模式通过在操作系统中创建虚拟网卡（TUN/TAP），在内核层拦截所有 TCP/UDP 流量，包括不遵循系统代理设置的应用程序（如游戏客户端、命令行工具、UWP 应用等），实现真正意义上的全局透明代理。

何时需要开启 TUN 模式

场景 是否需要 TUN 说明
外服游戏加速（UDP） ✅ 需要 游戏使用 UDP 协议，不走系统 HTTP 代理
终端 / curl / git 代理 ⚠️ 可选 可通过环境变量 http_proxy 替代
Windows UWP 应用代理 ✅ 需要 UWP 应用沙箱机制隔离系统代理
普通浏览器上网 ❌ 不需要 浏览器自动遵循系统 HTTP 代理设置
路由器 / NAS 全局透明代理 ✅ 需要 需要接管所有设备流量

YAML 中启用 TUN 配置

tun config block
tun:
  enable: true
  stack: system # system | gvisor | mixed
  auto-route: true # auto add routes for TUN
  auto-detect-interface: true # auto detect outbound interface
  dns-hijack:
    - any:53 # hijack all DNS queries
dns:
  enable: true
  enhanced-mode: fake-ip # fake-ip prevents DNS leaks
  nameserver:
    - 223.5.5.5 # Alibaba DNS (domestic)
    - 119.29.29.29 # DNSPod (domestic)
  fallback:
    - tls://8.8.8.8:853 # Google DoT (for overseas)
    - https://1.1.1.1/dns-query # Cloudflare DoH
注意 在 Windows 上开启 TUN 模式需要先在客户端中安装 Service Mode（以管理员权限运行 Clash for Windows 后在 General 页面点击 Install）。macOS 上需要在系统设置中允许安装网络扩展（内核扩展）。

规则分流进阶 [RULES]

Clash 的规则引擎是其核心优势：通过在 rules 字段中按优先级从高到低排列规则，精确决定每个请求走 PROXY、DIRECT 还是 REJECT。

规则类型速查

规则类型 示例 说明
DOMAIN DOMAIN,google.com,PROXY 精确匹配完整域名
DOMAIN-SUFFIX DOMAIN-SUFFIX,youtube.com,PROXY 匹配域名及所有子域名
DOMAIN-KEYWORD DOMAIN-KEYWORD,openai,PROXY 域名中包含指定关键词
IP-CIDR IP-CIDR,192.168.0.0/16,DIRECT 按 IP 地址段匹配
GEOIP GEOIP,CN,DIRECT 按 GeoIP 地理位置匹配，CN 为中国大陆 IP
PROCESS-NAME PROCESS-NAME,steam.exe,PROXY 按进程名匹配（仅桌面端）
RULE-SET RULE-SET,gfw,PROXY 引用外部规则集文件（rule-providers）
MATCH MATCH,DIRECT 兜底规则，匹配所有未命中请求，必须放在最后

推荐规则结构示例

rules section (recommended order)
rules:
  # 1. LAN addresses - direct
  - IP-CIDR,192.168.0.0/16,DIRECT
  - IP-CIDR,10.0.0.0/8,DIRECT
  - IP-CIDR,127.0.0.0/8,DIRECT
  # 2. Block ad domains
  - RULE-SET,reject,REJECT
  # 3. Domestic sites - direct
  - RULE-SET,direct,DIRECT
  - GEOIP,CN,DIRECT
  # 4. Overseas sites - proxy
  - RULE-SET,proxy,PROXY
  # 5. Fallback rule (must be last)
  - MATCH,DIRECT
最佳实践 推荐使用 Loyalsoldier/clash-rules 等社区维护的规则集，通过 rule-providers 字段自动拉取并按计划更新，避免手动维护大量规则。

策略组配置 [PROXY-GROUPS]

策略组（proxy-groups）决定规则命中后实际使用哪个节点出站。合理设计策略组结构，可以实现自动选优、故障转移、负载均衡等高级用法。

策略组类型说明

类型 说明 推荐场景
select 手动从列表中选择节点或子组 主出站组，便于手动切换节点
url-test 定期 ping 测试 URL，自动选择延迟最低的节点 自动选优（推荐日常使用）
fallback 顺序检测节点可用性，自动跳过失败节点 节点稳定性保障
load-balance 在多个节点间进行负载均衡分发连接 多节点高并发下载场景

DNS 防泄漏配置 [DNS]

DNS 泄漏是指在使用代理时，DNS 查询请求绕过代理通道，直接由 ISP 的 DNS 服务器解析，导致访问记录暴露。Clash 通过内置 DNS 模块与 fake-ip 模式从根本上解决此问题。

DNS 模块推荐配置

dns section
dns:
  enable: true
  listen: 0.0.0.0:53 # DNS listen port
  enhanced-mode: fake-ip # recommended: fake-ip or redir-host
  fake-ip-range: 198.18.0.0/16
  # Domestic DNS servers (queried for CN domains)
  nameserver:
    - 223.5.5.5 # Alibaba DNS
    - 114.114.114.114
  # Encrypted overseas DNS (for non-CN domains)
  fallback:
    - tls://8.8.8.8:853 # Google DNS over TLS
    - https://1.1.1.1/dns-query
  fallback-filter:
    geoip: true # use fallback DNS for non-CN IPs
    geoip-code: CN
原理说明 fake-ip 模式下，Clash 对所有 DNS 请求立即返回一个虚假 IP（来自 198.18.0.0/16 段），实际 DNS 解析在流量到达代理节点时于远端进行，彻底防止本地 DNS 泄漏，同时大幅降低首次连接延迟。

常见问题 [FAQ]

Clash 是一个纯粹的代理客户端，本身不包含任何节点资源。它的作用是解析 YAML 配置文件、匹配分流规则，并将流量通过配置中指定的节点进行转发。节点通常由代理服务商（俗称"机场"）以 YAML 订阅链接的形式提供。本站不提供、不售卖任何节点或订阅服务。
浏览器默认遵循系统 HTTP 代理设置，而游戏客户端使用 UDP 协议、终端工具不读取系统代理，因此无法走普通系统代理。解决方案：开启 TUN 模式（参见上方 TUN 模式章节），通过虚拟网卡在内核层接管所有 TCP/UDP 流量。
通常是规则配置问题，导致国内流量被错误地路由到代理节点，增加了延迟。解决方法：

1. 在规则中加入 GEOIP,CN,DIRECT 确保国内 IP 直连；
2. 引入 rule-providers，使用社区维护的 direct（国内域名白名单）规则集；
3. 确保 DNS 配置中国内域名走国内 DNS 服务器解析（如阿里 DNS 223.5.5.5）。
默认配置文件路径：

macOS / Linux：~/.config/clash/config.yaml
Windows：%USERPROFILE%\.config\clash\config.yaml

在 Clash for Windows 中，可点击 General 页面的「Open Clash Home Folder」按钮直接打开所在目录。建议使用支持 YAML 语法高亮的编辑器（如 VS Code）进行编辑，编辑后在客户端中点击「Reload Config」重载配置。
fake-ip：对所有 DNS 请求立即返回一个虚假 IP（198.18.x.x），实际域名解析推迟到远端代理节点进行。优点是连接建立极快、防 DNS 泄漏，推荐 TUN 模式下使用。

redir-host：在本地真实解析 DNS 后再进行规则匹配，兼容性更好，但存在 DNS 泄漏风险，且首次连接有额外延迟。适合对 IP 地址有特殊需求的场景。
排查步骤：

1. 检查订阅链接是否完整，可直接在浏览器中打开验证可访问性；
2. 确认订阅链接未过期（部分机场订阅有时效限制）；
3. 若网络本身需要代理才能访问订阅地址，可在客户端设置中启用「通过代理更新订阅」选项；
4. 检查日志（Log 页面）中的错误信息，根据报错类型进一步处理。