配置教程文档

Clash 使用教程
从零开始，10 分钟上手

新手必读指南：下载安装、订阅链接导入、代理模式选择、规则分流配置、TUN 透明代理，覆盖 Windows / macOS / Android / iOS / Linux 全平台操作详解。

快速开始 先去下载客户端

快速开始

5 步完成 Clash 初次上手

订阅链接导入

添加与管理代理订阅

代理模式说明

规则 / 全局 / 直连模式详解

YAML 配置详解

配置文件结构与字段说明

TUN 透明代理

接管全部流量的高级模式

平台安装指南

各平台客户端操作步骤

策略组配置

Fallback / URL-Test / 负载均衡

常见问题 FAQ

连接失败、无法访问等排查
1

快速开始：5 步完成初次上手

如果您是第一次使用 Clash，按照以下 5 个步骤操作，大约 10 分钟内即可完成配置并正常使用。

1

下载适合您系统的客户端

前往 Clash 客户端下载页，根据您的操作系统选择对应安装包。Windows 推荐 Clash Verge Rev，macOS 推荐 ClashX Meta，Android 推荐 Clash Meta for Android，iOS 推荐 Stash 或 Shadowrocket。

2

安装并首次启动

Windows：双击 .exe 安装包按提示完成安装；macOS：将 .dmg 中的 App 拖入 Applications 文件夹；Android：安装 .apk 文件（需允许未知来源）。

3

获取订阅链接

向您的代理服务提供商获取 Clash 格式的订阅 URL（以 https:// 开头的长链接）。大多数服务商会在用户控制台提供一键复制按钮。

4

导入订阅并更新节点

在客户端找到「订阅管理」或「配置」界面，点击「添加订阅」粘贴 URL 并保存，随后点击「更新」或「刷新」加载节点列表。详细步骤见 §2 订阅链接导入。

5

选择节点并开启系统代理

在节点列表中选择延迟较低的节点，将代理模式设为「规则」（Rule），最后开启「系统代理」开关，即可开始使用 Clash 上网。

新手提示 首次使用建议选择「规则模式」，它会自动对国内网站直连、国外网站代理，兼顾速度与安全，无需手动配置规则。
2

订阅链接导入与管理

订阅链接是一种在线托管的 Clash YAML 配置文件地址，客户端通过它自动拉取最新节点信息。相较于手动导入单个节点，订阅方式更便捷，且支持一键更新。

添加新订阅

1

打开订阅/配置管理页面

在 Clash Verge Rev 中点击左侧「Profiles」；ClashX Meta 点击菜单栏图标 → Config → Manage；Clash for Android 点击底部「配置文件」。

2

粘贴订阅链接

点击「新建」或「+」，在 URL 输入框粘贴订阅链接，填写备注名称（例如：我的机场），点击确认。

3

拉取并启用配置

点击「更新」或「刷新」按钮，等待节点列表加载完成后，点击配置卡片将其设为当前使用的配置。

订阅自动更新

大多数客户端支持配置自动更新间隔（通常为 12 小时或 24 小时），到期后自动拉取最新节点，无需手动刷新。在 Clash Verge Rev 中，点击订阅卡片的设置图标，找到「自动更新」选项设置间隔时间即可。

手动导入本地配置文件

若您拥有本地 config.yaml 文件，也可通过「导入本地文件」功能直接加载，无需网络请求。

安全提示 请仅从可信来源获取订阅链接，切勿随意扫描二维码或点击陌生链接添加订阅，以免泄露流量或遭受中间人攻击。
3

代理模式详解

Clash 提供三种代理模式，适用于不同场景。了解各模式的特点，有助于您在速度和隐私之间做出最优选择。

模式 工作原理 适用场景 推荐
规则模式 按 YAML 规则智能判断：国内直连，国外走代理 日常上网、兼顾国内外访问速度 强烈推荐
全局模式 所有流量强制通过代理节点发出 需要完全匿名、测试节点连通性 按需使用
直连模式 所有流量均不经过代理直接访问 临时关闭代理、测试本地网络 临时使用
关于规则模式的分流逻辑 规则模式下，Clash 会从上到下依次匹配规则列表：先匹配到的规则优先生效。常见规则类型包括 DOMAIN（精确域名）、DOMAIN-SUFFIX（域名后缀）、IP-CIDR（IP 地址段）、GEOIP（地理位置）和 MATCH（兜底规则）。
4

YAML 配置文件详解

Clash 的核心配置文件为 YAML 格式，通常命名为 config.yaml。文件包含五大核心部分：基础设置、代理节点、代理策略组、DNS 设置和流量规则。

基础端口与模式配置

YAML · config.yaml 
# Basic port settings
port: 7890          # HTTP proxy port
socks-port: 7891    # SOCKS5 proxy port
mixed-port: 7892    # HTTP + SOCKS5 mixed port (recommended)
redir-port: 7893    # Transparent proxy port (Linux/macOS)
tproxy-port: 7894   # TProxy port (Linux only)

# Global settings
allow-lan: false    # Whether to allow LAN connections
mode: rule          # rule | global | direct
log-level: info     # silent | error | warning | info | debug
ipv6: false

# External controller (Web Dashboard)
external-controller: 127.0.0.1:9090
secret: ""          # Dashboard access password (optional)

代理节点（proxies）

YAML · proxies section 
proxies:
  # Shadowsocks node example
  - name: "HK-SS-01"
    type: ss
    server: hk.example.com
    port: 8388
    cipher: aes-256-gcm
    password: "your-password"
    udp: true

  # VMess node example
  - name: "JP-VMess-01"
    type: vmess
    server: jp.example.com
    port: 443
    uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    alterId: 0
    cipher: auto
    tls: true
    network: ws
    ws-opts:
      path: "/path"

  # Trojan node example
  - name: "SG-Trojan-01"
    type: trojan
    server: sg.example.com
    port: 443
    password: "your-trojan-password"
    sni: sg.example.com

流量分流规则（rules）

YAML · rules section 
rules:
  # Specific domains - direct connection
  - DOMAIN-SUFFIX,cn,DIRECT
  - DOMAIN-SUFFIX,baidu.com,DIRECT
  - DOMAIN-SUFFIX,taobao.com,DIRECT
  - DOMAIN-SUFFIX,jd.com,DIRECT

  # GeoIP: China mainland traffic - direct
  - GEOIP,CN,DIRECT

  # Private IP ranges - direct
  - IP-CIDR,192.168.0.0/16,DIRECT
  - IP-CIDR,10.0.0.0/8,DIRECT
  - IP-CIDR,172.16.0.0/12,DIRECT

  # Process name rule (mihomo only)
  - PROCESS-NAME,curl,DIRECT

  # Catch-all rule - proxy everything else
  - MATCH,Proxy
规则匹配优先级 规则从上到下依次匹配，第一条匹配到的规则立即生效并停止继续匹配。因此更精确的规则应放在列表靠前位置，MATCH 兜底规则必须放在最后。
5

TUN 透明代理模式

TUN 模式通过在系统层面创建虚拟网卡，使 Clash 能够接管设备上所有应用程序的网络流量——包括那些不读取系统代理设置的程序（如某些游戏客户端、命令行工具、Steam 等）。

TUN 模式 vs 系统代理模式对比

特性 系统代理模式 TUN 模式
流量覆盖范围 仅支持代理的应用（浏览器等） 全部应用程序，含游戏/终端
UDP 流量 部分支持 完整支持
权限要求 普通用户权限 需要管理员 / root 权限
配置难度 简单 略复杂（一键开关）
游戏加速 通常无效 有效

开启 TUN 模式（以 Clash Verge Rev 为例）

1

以管理员身份运行客户端

Windows：右键客户端图标 → 以管理员身份运行；macOS：直接启动，首次开启时系统会弹出授权请求。

2

进入设置页面

点击左侧导航栏的「设置」（Settings）图标，找到「TUN 模式」或「虚拟网卡」选项卡。

3

开启 TUN 并选择驱动

打开「TUN 模式」开关，驱动类型选择 Mixed（推荐）。Windows 用户首次使用时客户端会自动安装 WinTun 驱动。

4

确认虚拟网卡已激活

开启成功后，系统网络适配器中会出现 Clash 或 mihomo 虚拟网卡，此时所有流量均已接管。

YAML 中手动启用 TUN

YAML · TUN configuration 
tun:
  enable: true
  stack: mixed      # mixed (recommended) | system | gvisor
  dns-hijack:
    - "any:53"        # Hijack all DNS queries
  auto-route: true  # Auto-add routes
  auto-detect-interface: true
6

各平台安装与配置指南

不同平台的 Clash 客户端在界面和操作上略有差异，以下提供各平台的完整安装指导。

Windows 安装指南（推荐：Clash Verge Rev）

1

下载安装包

前往下载页面，选择 Clash Verge Rev Windows 版本，下载 ClashVergeRev_x.x.x_x64-setup.exe（64位系统）安装程序。

2

安装（建议选「为所有用户安装」）

双击安装包，建议选择「为所有用户安装」以确保 TUN 模式可用，安装目录保持默认即可。

3

首次启动 → 导入订阅

启动后点击左侧「Profiles」，点击右上角输入框粘贴订阅 URL，点击「Import」下载配置。

4

开启系统代理

进入「Settings」，找到「System Proxy」开关并开启；在「Proxies」页面选择节点，即可使用。

Windows 防火墙提示 若首次启动时 Windows 防火墙弹出询问，请选择「允许访问」，否则 Clash 无法正常监听网络端口。

macOS 安装指南（推荐：ClashX Meta）

1

下载 DMG 安装包

根据您的 Mac 型号选择：Apple Silicon (M1/M2/M3) 选 arm64 版本；Intel Mac 选 x64 版本。

2

安装并移除隔离属性

打开 DMG，将 App 拖入 Applications。若系统提示「无法验证开发者」，打开终端执行：xattr -cr /Applications/ClashX\ Meta.app

3

导入订阅并启用系统代理

点击菜单栏 ClashX Meta 图标 → Config → Remote config → Manage，添加订阅 URL；返回菜单选择「Set as system proxy」启用系统代理。

Android 安装指南（推荐：Clash Meta for Android）

1

下载 APK 并允许安装

前往下载页下载 cmfa-x.x.x-meta-universal-release.apk，在系统设置中允许「安装未知来源应用」后执行安装。

2

添加配置文件

打开 App → 底部「配置文件」→ 右上角「+」→ 选择「URL」，粘贴订阅链接并保存，点击刷新图标更新配置。

3

启动代理

返回主页面，点击中央启动按钮，系统会询问是否允许建立 VPN 连接，点击「确定」即可。

iOS 安装指南（推荐：Stash / Shadowrocket）

关于 iOS 客户端 iOS 平台因 App Store 政策限制，主要兼容 Clash 配置格式的客户端为 Stash（支持 Clash 配置）和 Shadowrocket，均为付费 App，需切换至非中国大陆区账号购买。
1

安装 Stash 或 Shadowrocket

在 App Store（非中国区）搜索并购买安装 Stash 或 Shadowrocket。

2

导入 Clash 订阅（Stash 为例）

打开 Stash → 「配置」→「从 URL 安装」，粘贴 Clash 订阅链接并确认下载。

3

启动代理

返回主页面打开代理开关，系统询问 VPN 配置安装请求，点击「允许」并用 Face ID / Touch ID 确认即可。

Linux 安装指南（推荐：mihomo CLI / FlClash）

1

下载 mihomo 二进制文件

根据架构选择对应版本（amd64 / arm64 / armv7 等），下载后解压至 /usr/local/bin/mihomo 并授予执行权限：chmod +x /usr/local/bin/mihomo

2

放置配置文件

将 config.yaml 放置于 ~/.config/mihomo/ 目录下，启动命令：mihomo -d ~/.config/mihomo

3

设置系统代理或配置 TUN

设置环境变量：export http_proxy=http://127.0.0.1:7890 和 https_proxy=http://127.0.0.1:7890；或在 YAML 中启用 TUN 模式接管全部流量。

4

配置 systemd 自启（可选）

创建 /etc/systemd/system/mihomo.service 服务文件，执行 systemctl enable --now mihomo 即可开机自启。

GUI 推荐 如需图形化界面，可选择 FlClash（跨平台 Flutter 版本），支持 Linux AppImage 和 deb 包，操作界面与 Android 版类似。
7

代理策略组详解

代理策略组（proxy-groups）允许您将多个节点组合成一个「虚拟节点」，实现自动选择最优节点、故障转移、负载均衡等高级功能，是 Clash 最强大的核心特性之一。

策略组类型 说明 适用场景
select 手动选择节点，用户在 Dashboard 中自行切换 主代理组、手动指定出口
url-test 定期测速，自动选择延迟最低的节点 自动选优、游戏低延迟
fallback 按顺序测活，首选节点不可用时自动切换到下一个 高可用、防止单点故障
load-balance 多节点轮询分配流量，提升并发下载速度 大流量下载、多任务并发
relay 流量依次经过多个节点中继转发 多跳链路、增强匿名性

策略组配置示例

YAML · proxy-groups 
proxy-groups:
  # Main proxy group - manual select
  - name: "Proxy"
    type: select
    proxies:
      - Auto-Best
      - HK-SS-01
      - JP-VMess-01
      - SG-Trojan-01

  # Auto url-test group - pick lowest latency
  - name: "Auto-Best"
    type: url-test
    proxies:
      - HK-SS-01
      - JP-VMess-01
      - SG-Trojan-01
    url: "http://www.gstatic.com/generate_204"
    interval: 300    # Test every 300 seconds
    tolerance: 50    # Switch if diff > 50ms

  # Fallback group - failover
  - name: "Fallback-Group"
    type: fallback
    proxies:
      - HK-SS-01
      - JP-VMess-01
      - SG-Trojan-01
    url: "http://www.gstatic.com/generate_204"
    interval: 300

  # Load balance group
  - name: "Load-Balance"
    type: load-balance
    strategy: consistent-hashing
    proxies:
      - HK-SS-01
      - JP-VMess-01
    url: "http://www.gstatic.com/generate_204"
    interval: 300
8

DNS 设置与防泄漏配置

合理的 DNS 配置可以防止 DNS 泄漏（DNS Leak），确保您的真实访问记录不被本地 ISP 记录，同时加速域名解析速度。

推荐 DNS 配置示例

YAML · DNS configuration 
dns:
  enable: true
  ipv6: false
  listen: 0.0.0.0:1053

  # Enhanced mode: fake-ip intercepts DNS and returns virtual IPs
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16

  # Domains that should NOT use fake-ip
  fake-ip-filter:
    - "*.lan"
    - "localhost.ptlogin2.qq.com"
    - "+.stun.*.*"
    - "+.stun.*.*.*"

  # Default nameservers (used for bootstrap)
  default-nameserver:
    - 223.5.5.5     # Alibaba DNS
    - 119.29.29.29  # Tencent DNS

  # Nameservers for proxy traffic
  nameserver:
    - https://doh.pub/dns-query
    - https://dns.alidns.com/dns-query

  # Nameservers for direct traffic
  fallback:
    - https://1.1.1.1/dns-query    # Cloudflare DoH
    - https://8.8.8.8/dns-query    # Google DoH

  # Only use fallback servers for non-CN IPs
  fallback-filter:
    geoip: true
    geoip-code: CN
关于 fake-ip 模式 fake-ip 模式下 Clash 会返回虚假 IP 地址以快速建立连接，但可能导致部分软件（如网络游戏、P2P 程序）出现异常。如遇问题，可将 enhanced-mode 改为 redir-host。
9

常见问题解答 FAQ

Clash 本身包含节点/服务器资源吗？
不包含。Clash 是一个本地代理客户端与规则分流引擎，本身不提供任何服务器节点。您需要自行从第三方服务商获取订阅链接或节点配置信息。
导入订阅后提示「No proxies」或节点列表为空，如何解决？
请检查：①订阅链接是否正确（建议重新复制一次）；②当前网络是否能访问订阅地址（部分订阅链接需在特定网络环境下才能访问）；③尝试在浏览器中直接打开订阅链接，确认返回内容为 YAML 格式。如仍无法解决，请联系您的服务商。
Clash 开启后浏览器可以访问，但其他软件（游戏/应用）无法走代理？
默认的「系统代理」模式只对识别 HTTP 代理设置的应用生效（主要是浏览器）。游戏客户端、终端程序等通常需要开启 TUN 模式才能被接管。请参考 §5 TUN 透明代理模式 的开启步骤。
Clash 规则模式下部分国内网站无法访问或速度很慢？
可能的原因：①该网站未被纳入直连规则，流量走了代理导致速度慢；②订阅附带的规则文件较旧，缺少对应域名。解决方案：①更新订阅（规则文件随订阅一起更新）；②在 YAML 中手动为该域名添加 DOMAIN-SUFFIX,example.cn,DIRECT 规则；③临时切换至「直连模式」测试。
如何查看当前 Clash 的实时连接日志？
Clash 内置 RESTful API 与 Web Dashboard（默认地址：http://127.0.0.1:9090/ui）。在浏览器中打开此地址，进入「Connections」页面即可实时查看所有活跃连接及其走代理还是直连的判断结果。
Clash 配置文件放在哪里？可以手动编辑吗？
Windows：%APPDATA%\clash-verge\profiles\ 或 C:\Users\用户名\.config\clash\；macOS/Linux：~/.config/clash/config.yaml 或 ~/.config/mihomo/config.yaml。可以用任意文本编辑器手动编辑，修改后在客户端中点击「重载配置」或重启客户端生效。
Clash 与 V2Ray / Xray 有什么区别？
V2Ray/Xray 更侧重于代理协议实现和流量混淆；Clash（特别是 Mihomo/Clash.Meta 内核）则在此基础上提供了完善的规则分流引擎、策略组管理、Web Dashboard 等功能，更易于日常使用和管理多节点订阅。现代版的 Clash.Meta 内核同时支持 VMess、VLESS、Reality 等 Xray 特有协议。
Clash 是否支持多订阅合并使用？
原生 Clash 不直接支持多订阅合并，但可以借助第三方工具（如 Sub-Store、subconverter）将多个订阅链接合并为一个。合并后生成的新订阅 URL 可直接在 Clash 中使用，操作方式与单订阅完全相同。

还没有 Clash 客户端？

立即下载适合您操作系统的最新版客户端，按照本教程配置后即可开始使用。

免费下载 Clash 客户端