Clash
● 配置参考 · 字段说明 · 运行机制

Clash 配置参考文档
字段与运行机制

围绕 Clash 与 Mihomo 配置结构,系统梳理入站、出站、策略组、规则、DNS 与 TUN 虚拟网卡运行机制。

🔍 共 25 项

简介

^
简介

什么是 Clash?

全面了解 Clash 代理工具的设计理念、核心架构以及本地分流的工作原理。

文档详情 ⌄
Clash 是基于 Go 语言开发的跨平台规则代理核心,支持在本地创建 HTTP/SOCKS5/TUN 入口,并按 YAML 规则将流量精确分发至不同出站节点。
简介

快速上手

最小可用 YAML 配置文件结构示例与本地启动测试流程。

文档详情 ⌄
核心字段包含 mixed-port: 7890、mode: rule、proxies(节点列表)、proxy-groups(策略组)与 rules(分流规则)。
简介

Clash 路由概念

数据包从本地应用进入入站口、经过 DNS/规则匹配到出站转发的完整生命周期。

文档详情 ⌄
处理链路:Inbound 接收连接 → Fake-IP / DNS 域名解析 → Rules 自上而下首条命中 → Strategy Group 选取出口 → Outbound 建立加密隧道。
简介

常见问题

YAML 配置文件缩进格式校验、编码要求与热重载注意事项。

文档详情 ⌄
YAML 严格禁止使用 Tab 制表符缩进,所有层级必须统一使用 2 个半角空格,文件编码需保存为 UTF-8 无 BOM 格式。

配置

^
配置

Clash 配置介绍

全局基础字段:mixed-port、allow-lan、mode、log-level 与 external-controller。

文档详情 ⌄
mixed-port: 7890 / allow-lan: false / mode: rule / log-level: info / external-controller: 127.0.0.1:9090
配置

配置本地入站

port(HTTP)、socks-port(SOCKS5)与 mixed-port 混合端口的监听绑定设置。

文档详情 ⌄
推荐使用 mixed-port,可在单一端口同时自动识别 HTTP CONNECT 与 SOCKS5 握手协议,简化本地代理配置。
配置

Outbound 出站

内置 DIRECT 直连、REJECT 拦截以及自定义代理节点(proxies)的声明规范。

文档详情 ⌄
每个节点对象需包含 name(唯一名称)、type(协议类型)、server(服务器域名或 IP)、port(端口号)及对应加密认证字段。
配置

Outbound 策略组

select 手动选择、url-test 自动测速、fallback 故障转移与 load-balance 负载均衡。

文档详情 ⌄
url-test 组通过定时请求 http://www.gstatic.com/generate_204 测算真实握手延迟,并结合 tolerance 阈值防止频繁切换。
配置

Rules 规则

DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、IP-CIDR、GEOIP、PROCESS-NAME 与 MATCH 匹配器。

文档详情 ⌄
示例:- DOMAIN-SUFFIX,openai.com,US-PROXY / - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve / - MATCH,PROXY
配置

Clash DNS

nameserver、fallback、enhanced-mode(fake-ip / redir-host)与防泄露分流解析。

文档详情 ⌄
启用 fake-ip 后,Clash 会为海外域名即时分配 198.18.0.1/16 保留段虚拟 IP,消除本地 DNS 解析等待时间。
配置

性能与并发

tcp-concurrent 并发拨号与 unified-delay 统一延迟计算优化参数。

文档详情 ⌄
开启 tcp-concurrent: true 后,客户端会向目标域名的多个解析 IP 同时发起 TCP 连接并采用最快响应的一条。

代理协议

^
代理协议

HTTP / HTTPS 代理出站

标准 HTTP/HTTPS 上游代理服务器连接及 TLS 证书校验参数。

文档详情 ⌄
type: http, server, port, username, password, tls: true, skip-cert-verify: false
代理协议

SOCKS5 代理出站

支持 TCP 与 UDP 转发的标准 SOCKS5 上游代理节点配置。

文档详情 ⌄
type: socks5, server, port, udp: true
代理协议

Shadowsocks (SS)

AEAD 加密(aes-128-gcm / chacha20-ietf-poly1305)及 2022 新加密套件配置。

文档详情 ⌄
type: ss, server, port, cipher: aes-128-gcm, password, udp: true
代理协议

ShadowsocksR (SSR)

兼容混淆(obfs)与协议插件参数的传统 SSR 节点格式。

文档详情 ⌄
type: ssr, server, port, cipher, password, obfs, protocol
代理协议

VMess

uuid、alterId、network(ws / grpc / h2)、tls 与 servername 详细参数。

文档详情 ⌄
type: vmess, server, port, uuid, alterId: 0, cipher: auto, tls: true, network: ws
代理协议

VLESS

XTLS-Vision 流控与 REALITY 无证书公钥(reality-opts)配置说明。

文档详情 ⌄
type: vless, server, port, uuid, flow: xtls-rprx-vision, reality-opts: { public-key, short-id }
代理协议

Trojan

基于 TLS 1.3 的密码认证与 WebSocket / gRPC 传输层复用配置。

文档详情 ⌄
type: trojan, server, port, password, sni, udp: true
代理协议

Hysteria2

基于 QUIC 的高吞吐抗丢包协议,支持上下行速率控制与端口跳跃。

文档详情 ⌄
type: hysteria2, server, port, password, up: "100 Mbps", down: "500 Mbps"
代理协议

TUIC

支持 BBR 拥塞控制与 native/quic 双模式 UDP 中继的高性能协议。

文档详情 ⌄
type: tuic, server, port, uuid, password, congestion-controller: bbr
代理协议

WireGuard

原生集成三层 WireGuard 隧道,支持自定义 MTU 与对端 Peer 列表。

文档详情 ⌄
type: wireguard, server, port, ip: 10.0.0.2, private-key, public-key, mtu: 1420

Premium / Mihomo 扩展版本

^
高级特性

功能:Proxies 组高级筛选

使用 include-all 与 filter 正则表达式自动按地区归类节点。

文档详情 ⌄
在策略组中配置 include-all: true 与 filter: "(?i)HK|Hong Kong|香港",即可自动聚合全部香港节点。
高级特性

功能:TUN 虚拟网卡设置

stack(system / gvisor / mixed)、auto-route 与 dns-hijack 劫持配置。

文档详情 ⌄
tun: { enable: true, stack: mixed, auto-route: true, dns-hijack: ["any:53"] }
高级特性

功能:Rule Providers 规则集

订阅远程 YAML 或二进制 MRS 规则集并设置自动更新周期。

文档详情 ⌄
支持 behavior: domain / ipcidr / classical,采用 mrs 二进制格式可降低 80% 内存占用。
高级特性

功能:Script 动态路由脚本

通过自定义脚本根据源 IP、进程名或时间段实现动态策略路由。

文档详情 ⌄
适合企业多出口网关或需要针对特定开发进程单独指定路由出口的高级用户。