ClashX 配置文件完整解析：深入理解 YAML 配置

配置文件概述

ClashX 使用 YAML 格式的配置文件來定義所有的代理行為。理解配置文件的结構和每个配置項的作用，是掌握 ClashX 的關键。

配置文件通常位于 ~/.config/clash/config.yaml，也可以通過訂閱鏈接自動更新。本文将深入解析配置文件的每个部分，幫助你創建最適合自己需求的配置。

💡

YAML 格式要点

YAML 對缩進非常敏感，必須使用空格（不是 Tab）進行缩進。建議使用 2 个空格作為一級缩進。

基础结構

一个完整的 ClashX 配置文件主要包含以下几个部分：

配置文件基本结構

# 通用设置
port: 7890
socks-port: 7891
allow-lan: false
mode: rule
log-level: info

# 代理节点
proxies:
  - name: "节点1"
    type: ss
    server: example.com
    port: 443

# 策略组
proxy-groups:
  - name: "🚀 节点选择"
    type: select
    proxies:
      - "节点1"

# 规则
rules:
  - DOMAIN-SUFFIX,google.com,🚀 节点选择
  - GEOIP,CN,DIRECT
  - MATCH,🚀 节点选择

通用設置 (General)

通用設置控制 ClashX 的基本行為和性能參數。

端口配置

# HTTP 代理端口
port: 7890

# SOCKS5 代理端口
socks-port: 7891

# 混合端口（同时支持 HTTP 和 SOCKS5）
mixed-port: 7892

# RESTful API 端口
external-controller: 127.0.0.1:9090

# API 访问密钥（可选）
secret: "your-secret-key"

網絡設置

# 允许局域网连接
allow-lan: false

# 绑定地址（局域网时使用）
bind-address: "*"

# 运行模式：rule（规则） / global（全局） / direct（直连）
mode: rule

# 日志级别：silent / error / warning / info / debug
log-level: info

# IPv6 支持
ipv6: true

DNS 配置

DNS 配置影響域名解析的速度和準確性：

dns:
  enable: true
  listen: 0.0.0.0:53
  enhanced-mode: fake-ip  # 或 redir-host

  # Fake-IP 地址池
  fake-ip-range: 198.18.0.1/16

  # Fake-IP 过滤（这些域名不使用 Fake-IP）
  fake-ip-filter:
    - "*.lan"
    - "localhost.ptlogin2.qq.com"

  # DNS 服务器
  nameserver:
    - 119.29.29.29
    - 223.5.5.5
    - https://doh.pub/dns-query

  # 回落 DNS（当主 DNS 失败时使用）
  fallback:
    - https://1.1.1.1/dns-query
    - https://dns.google/dns-query

  # 根据域名选择 DNS
  nameserver-policy:
    "geosite:cn":
      - 119.29.29.29
      - 223.5.5.5
    "geosite:geolocation-!cn":
      - https://1.1.1.1/dns-query

⚠️

DNS 模式選择

fake-ip：性能更好，但可能与某些應用不兼容redir-host：兼容性好，但速度稍慢

代理節点配置 (Proxies)

proxies 部分定義所有可用的代理服務器節点。ClashX 支持多種代理協議。

Shadowsocks (SS)

proxies:
  - name: "SS节点"
    type: ss
    server: example.com
    port: 443
    cipher: aes-256-gcm
    password: "your-password"
    udp: true

ShadowsocksR (SSR)

  - name: "SSR节点"
    type: ssr
    server: example.com
    port: 443
    cipher: aes-256-cfb
    password: "your-password"
    protocol: auth_aes128_md5
    protocol-param: ""
    obfs: tls1.2_ticket_auth
    obfs-param: "cloudflare.com"

VMess

  - name: "VMess节点"
    type: vmess
    server: example.com
    port: 443
    uuid: b831381d-6324-4d53-ad4f-8cda48b30811
    alterId: 0
    cipher: auto
    tls: true
    skip-cert-verify: false
    servername: example.com
    network: ws
    ws-opts:
      path: /path
      headers:
        Host: example.com

Trojan

  - name: "Trojan节点"
    type: trojan
    server: example.com
    port: 443
    password: "your-password"
    sni: example.com
    skip-cert-verify: false
    udp: true

HTTP/HTTPS 代理

  - name: "HTTP代理"
    type: http
    server: example.com
    port: 8080
    username: user
    password: pass
    tls: true
    skip-cert-verify: false

策略組配置 (Proxy Groups)

策略組允许你組合多个節点，實現自動選择、负載均衡等高級功能。

select - 手動選择

用戶手動選择使用哪个節点：

proxy-groups:
  - name: "🚀 节点选择"
    type: select
    proxies:
      - "🇭🇰 香港节点"
      - "🇯🇵 日本节点"
      - "🇺🇸 美国节点"
      - DIRECT

url-test - 自動測速

自動選择延遲最低的節点：

  - name: "♻️ 自动选择"
    type: url-test
    proxies:
      - "节点1"
      - "节点2"
      - "节点3"
    url: "http://www.gstatic.com/generate_204"
    interval: 300    # 测试间隔（秒）
    tolerance: 50    # 容差（毫秒）

fallback - 故障轉移

主節点失败時自動切换到備用節点：

  - name: "🔰 故障转移"
    type: fallback
    proxies:
      - "主节点"
      - "备用节点1"
      - "备用节点2"
    url: "http://www.gstatic.com/generate_204"
    interval: 300

load-balance - 负載均衡

在多个節点間分配流量：

  - name: "⚖️ 负载均衡"
    type: load-balance
    proxies:
      - "节点1"
      - "节点2"
      - "节点3"
    url: "http://www.gstatic.com/generate_204"
    interval: 300
    strategy: consistent-hashing  # 或 round-robin

relay - 鏈式代理

流量经過多个代理節点：

  - name: "🔗 链式代理"
    type: relay
    proxies:
      - "节点1"
      - "节点2"

💡

策略組最佳實践

• 為不同用途創建不同的策略組（如流媒體、游戲、下載）• 使用 url-test 實現自動優選• 在 select 組中包含 url-test 組作為選項

規则配置 (Rules)

規则決定哪些流量走代理，哪些直連。規则從上到下匹配，一旦匹配就不再繼續。

完整規则示例

rules:
  # 局域网直连
  - DOMAIN-SUFFIX,local,DIRECT
  - IP-CIDR,127.0.0.0/8,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve

  # 屏蔽广告
  - DOMAIN-KEYWORD,adservice,REJECT
  - DOMAIN-SUFFIX,doubleclick.net,REJECT

  # 流媒体
  - DOMAIN-SUFFIX,youtube.com,🎬 流媒体
  - DOMAIN-SUFFIX,netflix.com,🎬 流媒体
  - DOMAIN-KEYWORD,spotify,🎬 流媒体

  # Apple 服务
  - DOMAIN-SUFFIX,apple.com,🍎 苹果服务
  - DOMAIN-SUFFIX,icloud.com,🍎 苹果服务

  # Google 服务
  - DOMAIN-SUFFIX,google.com,🚀 代理
  - DOMAIN-SUFFIX,googleapis.com,🚀 代理
  - DOMAIN-SUFFIX,gstatic.com,🚀 代理

  # 国内网站直连
  - GEOIP,CN,DIRECT

  # 最终规则
  - MATCH,🚀 代理

規则優先級建議

1. 局域網

最高優先級

2. 屏蔽規则

REJECT

3. 特殊服務

流媒體、游戲等

4. 地理位置

GEOIP 規则

5. 默認策略

MATCH

高級配置選項

Rule Providers - 規则集

從外部文件加載規则，便于维護和更新：

rule-providers:
  reject:
    type: http
    behavior: domain
    url: "https://cdn.example.com/reject.yaml"
    path: ./ruleset/reject.yaml
    interval: 86400

  proxy:
    type: http
    behavior: domain
    url: "https://cdn.example.com/proxy.yaml"
    path: ./ruleset/proxy.yaml
    interval: 86400

rules:
  - RULE-SET,reject,REJECT
  - RULE-SET,proxy,🚀 代理

TUN 模式

系統級代理，無需配置應用：

tun:
  enable: true
  stack: system  # 或 gvisor
  dns-hijack:
    - any:53
  auto-route: true
  auto-detect-interface: true

實驗性功能

experimental:
  # 忽略解析失败的域名
  ignore-resolve-fail: true

  # 接口名称检测
  interface-name: en0

⚠️

注意事項

• TUN 模式需要管理员權限• 修改配置后需重新加載才能生效• 建議先在測試環境驗證配置

這篇文章對你有幫助吗？

✓ 感谢你的反馈！

標簽： ClashX 配置文件 YAML 教程高級配置