配置参考 · 字段说明 · 运行机制Clash 配置参考文档 字段与运行机制
查阅 Clash 与 Mihomo 配置文档,了解规则分流、DNS、TUN 与服务运行,结合字段说明和配置示例完成配置与排障。
简介
4 篇什么是 Clash?
Clash 内核负责什么,和图形客户端有什么区别?从入站、出站与规则路由理解流量处理,再了解 DNS、策略组、Providers、RESTful API 及开源版与 Premium 版的差异。
快速开始
准备单独运行 Clash 内核时,可下载预编译二进制文件,也可用 Go 从源码编译。按设备选择构建方式,核对 GOPATH、运行版本,以及交叉编译所需的 GOOS、GOARCH。
Clash 服务运行
希望 Clash 在后台运行并随系统启动?将二进制文件与 config.yaml 配置为 systemd 服务,依次执行 daemon-reload、启动与状态检查;也可查看 Docker 运行示例。
常见问题
Clash 在路由器或容器中节点异常、Premium 无法联网,或出现 RULE-SET 报错?按现象检查 GOAMD64 架构、规则匹配与 DNS 劫持,并了解规则复杂度对运行的影响。
配置
7 篇Clash 配置介绍
读 Clash YAML 时,沿 Inbound、规则路由到 Outbound 梳理请求走向,再核对 rules 的 TYPE、ARGUMENT、POLICY 写法及 no-resolve 用途。
配置快速入手
不知道 config.yaml 放在哪里,或需要指定另一份配置?先核对默认目录及 -d、-f 启动参数,再检查 IPv6 方括号、DNS 通配符域名的引号和匹配优先级。
Inbound 入站
让浏览器、局域网设备或透明代理流量进入 Clash,先选择 HTTP(S)、SOCKS5、mixed-port、Redirect、TProxy 或 TUN 入口,再配置监听端口与 allow-lan。
Outbound 出站
手动填写原版 Clash 节点时,按 Shadowsocks、SSR、VMess、SOCKS5、HTTP、Snell 或 Trojan 查找格式,再逐项核对认证、加密、TLS、UDP 与插件字段。
Rules 规则
要让请求直连、拒绝或走指定节点,先理清规则顺序与策略组,再按 DOMAIN、GEOIP、IP-CIDR、RULE-SET、SCRIPT、MATCH 选择匹配方式,并核对 no-resolve。
Clash DNS
域名解析异常、分流出错,或局域网域名无法访问?按解析结果核对 Clash DNS 的 nameserver、fallback、fake-ip、nameserver-policy 与 IPv6 配置。
参考配置
编写或检查 Clash YAML 时,可对照完整配置骨架查找字段位置与写法,再按需填写本地端口、模式、日志、控制接口、DNS、TUN、节点、策略组、Providers 和 rules。
代理协议
14 篇HTTP / HTTPS 出站代理
Clash 生态 HTTP 出站配置参考,以当前 Mihomo 字段为准,涵盖 CONNECT 隧道、代理认证、HTTPS 上游与证书校验。
SOCKS5 出站代理
Clash 生态 SOCKS5 出站配置参考,以当前 Mihomo 字段为准,涵盖 TCP CONNECT、UDP Associate、认证与 TLS 包装。
Shadowsocks (SS)
Clash 生态 Shadowsocks 出站配置参考,以当前 Mihomo 字段为准,涵盖加密方法、UDP over TCP 与插件传输。
ShadowsocksR (SSR)
Clash 生态 ShadowsocksR 出站配置参考,以当前 Mihomo 字段为准,涵盖流加密、Protocol、Obfs 与旧节点兼容边界。
VMess
Clash 生态 VMess 出站配置参考,以当前 Mihomo 字段为准,核对用户 ID、协议版本、加密、UDP、传输层与 TLS 参数。
VLESS
Clash 生态 VLESS 出站配置参考,以当前 Mihomo 字段为准,区分 UUID、Vision、VLESS Encryption、Reality、UDP 与传输层。
Trojan
Clash 生态 Trojan 出站配置参考,以当前 Mihomo 字段为准,核对密码、强制 TLS、SNI、证书、Reality、UDP 与传输层。
Snell
Clash 生态 Snell 出站配置参考,以当前 Mihomo 字段为准,核对 psk、version、udp、obfs-opts 与 smux,涵盖最小 YAML、版本兼容和认证排查。
AnyTLS
Clash 生态 AnyTLS 出站配置参考,以当前 Mihomo 字段为准,核对 password、sni、客户端指纹、空闲会话检查与 TLS 校验,并提供最小 YAML 和常见握手错误。
Hysteria
Clash 生态 Hysteria 1.x 出站配置参考,以当前 Mihomo 字段为准,涵盖认证、传输模式、带宽、端口跳跃与 QUIC 参数。
Hysteria2
Clash 生态 Hysteria2 出站配置参考,以当前 Mihomo 字段为准,涵盖认证、端口跳跃、混淆、拥塞控制与 Realm 参数。
TUIC
Clash 生态 TUIC 出站配置参考,以当前 Mihomo 字段为准,区分 v4 与 v5 认证,并涵盖 TLS、QUIC、UDP 中继和连接参数。
WireGuard
Clash 生态 WireGuard 出站配置参考,以当前 Mihomo 字段为准,涵盖本地接口、Peer、Allowed IPs、MTU 与远程 DNS。
传输层配置
Clash 生态传输层配置参考,以当前 Mihomo 字段为准,帮助 VMess、VLESS 与 Trojan 正确关联 network、配套 opts、TLS 与协议边界。
Premium 版本
9 篇Premium 简介
需要 TUN、eBPF、Rule Providers 或 Script,开源内核能否满足?比较 Clash Premium 的增强功能、用户空间 WireGuard 与性能分析能力,再查看获取方式。
功能:TUN 设备
用 Clash Premium TUN 接管 TCP、UDP 与 ICMP 时,核对 auto-route、auto-redir、system/gvisor 和 DNS 劫持设置,确认系统限制再启用。
功能:eBPF 重定向到 TUN
在 Linux 上将流量通过 eBPF redirect-to-tun 送入 TUN 前,先确认接口与内核依赖,再检查 tun.auto-route、Tailscaled 的冲突及可用回退方式。
功能:Rule Providers 规则集
复用规则集时,选 domain、ipcidr 或 classical 格式,再填 rule-providers 的 behavior、url、interval、path,用 RULE-SET 引用。
功能:Script 脚本
用脚本分流时,在 Script 模式编写 Python3 main(ctx, metadata),结合 resolve_ip、geoip 与 rule_providers 匹配,核对 IP 解析要求。
功能:Script Shortcuts 脚本捷径
在 Clash Premium 的 Rule 模式复用脚本条件时,比较 Expr 与 Starlark,用 Script Shortcuts 定义捷径,核对变量、函数及 no-resolve 用法。
功能:用户空间 WireGuard
配置 Clash Premium 用户空间 WireGuard 节点时,核对 private-key、public-key、preshared-key 和地址,再设置远程 DNS、MTU 与 UDP。
功能:性能分析引擎
Clash Premium 运行出现性能瓶颈,普通日志却难以定位?从 tracing 的配置位置和启用方式入手,了解性能采样输出可以用于哪些分析。
实验功能
准备启用 Clash 实验功能时,先确认当前内核版本是否适用、配置应写在哪里,再在可回滚环境中验证效果;不要把某个版本的实验行为当作稳定约定。
运行时
1 篇高级用法
3 篇基于规则的 WireGuard
只让指定流量走 WireGuard?关闭默认路由后,用 interface-name、DIRECT 与 DOMAIN 规则将请求送入 wg0,核对 AllowedIPs、MTU 和 endpoint。
基于规则的 OpenConnect
需要让部分请求经 OpenConnect 访问,而不是让 VPN 接管默认路由?核对接口名称和路由表,再将对应接口、DIRECT 策略与目标规则接入 Clash 分流。
在 Golang 程序中集成 Clash
Go 程序处理代理连接时,从 Clash 的 SOCKS listener 与 ConnContext 读取元数据,再衔接 Direct 出站、DialContext 和 relay 完成双向转发。