ingest | mihomo（Clash Meta 内核）官方资料入库（2 摘编 + 2 wiki 页面 + 导航/登记）
This commit is contained in:
AAsige
Vendored
+1
-1
@@ -46,6 +46,6 @@
|
|||||||
"repelStrength": 10.3574397339983,
|
"repelStrength": 10.3574397339983,
|
||||||
"linkStrength": 0.848101265822785,
|
"linkStrength": 0.848101265822785,
|
||||||
"linkDistance": 322,
|
"linkDistance": 322,
|
||||||
"scale": 1.0890794994553836,
|
"scale": 2.140646794355269,
|
||||||
"close": false
|
"close": false
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,120 @@
|
|||||||
|
---
|
||||||
|
title: "mihomo（Clash Meta 内核）架构与核心概念摘编"
|
||||||
|
source: "MetaCubeX/mihomo 官方仓库 README（https://github.com/MetaCubeX/mihomo，默认分支 Meta）+ 官方文档 wiki.metacubex.one（虚空终端 Docs）"
|
||||||
|
source_date: 2026-08-07
|
||||||
|
extracted_date: 2026-08-07
|
||||||
|
type: source-derivative
|
||||||
|
tags:
|
||||||
|
- "mihomo"
|
||||||
|
- "Clash"
|
||||||
|
- "代理"
|
||||||
|
- "网络工具"
|
||||||
|
- "DNS"
|
||||||
|
- "TUN"
|
||||||
|
confidence: high
|
||||||
|
contested: false
|
||||||
|
evidence_boundary: "抓取时间 2026-08-07。依据：① GitHub MetaCubeX/mihomo Meta 分支 README.md（raw.githubusercontent.com 抓取）；② 官方文档 wiki.metacubex.one 的 简介/全局配置/通用字段/代理组/路由规则/DNS/代理集合/规则集合 章节；③ Alpha 分支 docs/config.yaml 全量示例（100,853 字符）。版本特性以文档写作时为基准，新版本可能新增或废弃字段；配置示例中的服务器地址、密码、密钥均为占位符，不可直接使用。文中\"原神\"指原版 Clash（Dreamacro/clash，已归档），\"虚空终端\"为 mihomo 的中文社区名。"
|
||||||
|
---
|
||||||
|
|
||||||
|
# 来源说明
|
||||||
|
|
||||||
|
本文件是 mihomo（Clash Meta 内核）的架构与核心概念中文结构化摘编，内容综合官方仓库 README 与官方文档。配置编写细节见同目录《官方文档-配置编写-摘编.md》。
|
||||||
|
|
||||||
|
## 证据分级
|
||||||
|
|
||||||
|
- **官方事实**：README、官方文档、官方配置示例中的功能描述与字段定义。
|
||||||
|
- **可复核机制**：DNS 防污染、fake-ip、规则路由、健康检查等可实际验证的机制。
|
||||||
|
- **时效性提示**：项目迭代快，部分字段（如已弃用的 `sniffing`、`port-whitelist`、组内 `interface-name`/`routing-mark`、全局 `client-fingerprint`、`fallback-filter.geosite`）在文档中已标记废弃，编写新配置时应使用新写法。
|
||||||
|
|
||||||
|
# 1. 项目定位
|
||||||
|
|
||||||
|
- **mihomo**（曾用名 Clash Meta）是原 Dreamacro/clash（"原神"）的二次开发代理内核，Go 语言实现，默认分支 `Meta`（稳定），`Alpha`（开发）分支承载最新特性。
|
||||||
|
- 功能上**兼容原版 Clash 全部特性**，并吸收 sing-box、v2ray-core 等项目的实现（见 README Credits）。
|
||||||
|
- 许可 **GPL-3.0**；附加条款：任何与 MetaCubeX 无关的下游项目不得在名称中使用 "mihomo" 一词。
|
||||||
|
- 配套 Dashboard：**metacubexd**（https://github.com/MetaCubeX/metacubexd）。
|
||||||
|
- 官方文档（中文）：https://wiki.metacubex.one/ ；配置示例：`docs/config.yaml`（Alpha 分支）。
|
||||||
|
- 构建：Go 1.20+；`go build`（可选 `-tags with_gvisor` 启用 gvisor tun 栈）；国内网络可设 `GOPROXY=https://goproxy.io,direct`。
|
||||||
|
|
||||||
|
# 2. 功能特性（官方 README）
|
||||||
|
|
||||||
|
1. 本地 HTTP/HTTPS/SOCKS 代理服务器，支持认证。
|
||||||
|
2. 协议支持：VMess、VLESS、Shadowsocks、Trojan、Snell、TUIC、Hysteria 等。
|
||||||
|
3. 内置 DNS 服务器，目标是最小化 DNS 污染攻击影响，支持 DoH/DoT 上游与 fake-ip。
|
||||||
|
4. 基于域名、GEOIP、IPCIDR 或进程的规则路由，将数据包转发到不同节点。
|
||||||
|
5. 远程策略组：自动 fallback、负载均衡或基于延迟自动选择节点。
|
||||||
|
6. 远程提供者（proxy-providers / rule-providers）：远程获取节点列表与规则，而非硬编码在配置中。
|
||||||
|
7. Netfilter TCP 重定向（iptables），可部署在网关/路由器。
|
||||||
|
8. 完整 HTTP RESTful API 控制器。
|
||||||
|
|
||||||
|
# 3. 分层架构与流量路径
|
||||||
|
|
||||||
|
```
|
||||||
|
应用 → 本地监听入口（mixed-port/socks/tun/redir/tproxy/自定义 listeners）
|
||||||
|
→ DNS 解析（内置 DNS：fake-ip 或 redir-host）
|
||||||
|
→ 规则匹配（rules 自上而下，首条命中生效）
|
||||||
|
→ 出口（proxy-groups 或 proxies；DIRECT/REJECT/COMPATIBLE 内置出站）
|
||||||
|
→ 节点 → 目标服务器
|
||||||
|
```
|
||||||
|
|
||||||
|
- **入口（inbound）**：mixed-port（HTTP+SOCKS 混合）、port（HTTP）、socks-port、tun、redir-port、tproxy-port，以及 `listeners` 自定义入站（hysteria2、tuic、tun、ss/vmess 入口等，传入流量按 `mode` 匹配处理）。`tunnels` 提供端口转发（本地端口→目标，经指定 proxy）。
|
||||||
|
- **运行模式 mode**：`rule`（规则匹配，默认）、`global`（全局走 GLOBAL 策略组）、`direct`（全局直连）。
|
||||||
|
- **内置出站**：`DIRECT`（直连）、`REJECT`（拒绝）、`COMPATIBLE`/`PASS`（兼容/放行）、`GLOBAL`（全局组）。代理组 `empty-fallback` 默认回退 `COMPATIBLE`。
|
||||||
|
- **API 层**：`external-controller`（RESTful API，可配 `secret`、TLS、Unix socket、Windows namedpipe、CORS）；`external-ui` 挂载 Web 面板，访问路径为 `API 地址/ui`；可在外置端口开启 DoH 服务器（`external-doh-server`）。
|
||||||
|
|
||||||
|
# 4. DNS 体系（防污染核心）
|
||||||
|
|
||||||
|
## 4.1 两种增强模式
|
||||||
|
|
||||||
|
- **fake-ip**（推荐）：DNS 返回 fake-ip 池（默认 `198.18.0.1/16`）中的虚拟 IP，mihomo 内部维护域名→fake-ip 映射；实际连接时按域名规则转发。优点：客户端不接触真实解析结果，规避 DNS 污染；配合 TUN 时所有流量可被内核接管。`store-fake-ip: true` 可持久化映射，重启后复用。
|
||||||
|
- **redir-host**：返回真实 IP，行为与传统代理一致。
|
||||||
|
|
||||||
|
## 4.2 关键字段
|
||||||
|
|
||||||
|
- `nameserver`：默认解析服务器（一般用国内/本地 DNS，如 114.114.114.114、DoH 阿里/腾讯）。
|
||||||
|
- `fallback`：后备服务器（一般用境外可信 DNS，如 tls://8.8.8.8）；配合 `fallback-filter` 判断 nameserver 返回的 IP 是否为 CN 以外（被视为污染）再改用 fallback 结果。
|
||||||
|
- `nameserver-policy`：按域名（支持 `+.domain`、geosite、rule-set 键）指定解析服务器，优先级高于 nameserver/fallback。
|
||||||
|
- `default-nameserver`：仅用于解析其他 DNS 服务器域名，必须为纯 IP 或加密 DNS，防止 DNS 服务器自身域名解析死循环。
|
||||||
|
- `proxy-server-nameserver`：专门解析代理节点域名的 DNS（防止"鸡蛋问题"——节点域名需要代理才能解析时）。
|
||||||
|
- `direct-nameserver`：direct 出口专用解析服务器。
|
||||||
|
- `enhanced-mode: fake-ip|redir-host`；`fake-ip-range`；`fake-ip-filter`（不回发 fake-ip 的域名，如 `*.lan`、局域网设备、内网服务）；`fake-ip-filter-mode`（blacklist 默认/whitelist/rule）。
|
||||||
|
- `listen`：监听 UDP/TCP 53 可作局域网 DNS 服务器；`ipv6: false` 时返回 AAAA 空结果。
|
||||||
|
- `respect-rules`：DNS 上游连接是否遵守路由规则（需配置 proxy-server-nameserver；不建议与 prefer-h3 同用）。
|
||||||
|
- 附加参数（`#` 连接）：`8.8.8.8/dns-query#proxy`（经指定代理/策略组连接）、`#RULES`（遵守路由规则）、`#h3=true`（强制 DoH over HTTP/3）、`#ecs=1.1.1.1/24`（指定 EDNS Client Subnet）、`skip-cert-verify`、`disable-qtype-65`（屏蔽 HTTPS/TYPE65 解析）等。
|
||||||
|
|
||||||
|
## 4.3 防污染工作流（fake-ip 典型）
|
||||||
|
|
||||||
|
1. 客户端请求域名 → mihomo 用 nameserver（国内）解析，或直接回 fake-ip；
|
||||||
|
2. 若解析出境外 IP（fallback-filter geoip 判断非 CN）→ 改用 fallback（境外可信 DNS）结果；
|
||||||
|
3. 实际建连时按规则：命中代理规则的域名走节点，命中国内规则的走 DIRECT（用 nameserver 结果）。
|
||||||
|
|
||||||
|
# 5. TUN 与透明代理
|
||||||
|
|
||||||
|
- `tun.enable: true` 创建虚拟网卡接管系统流量；`stack: system|gvisor|mixed`（gvisor 需 `with_gvisor` 编译标签；mixed 默认 tcp 走 system、udp 走 gvisor）。
|
||||||
|
- `dns-hijack`：劫持 `0.0.0.0:53` 的 DNS 请求。
|
||||||
|
- `auto-route`：自动配置路由表（把默认流量导入 tun）；`auto-redirect`（Linux）：自动配置 iptables 重定向 TCP，路由器场景可与 auto-route 组合。
|
||||||
|
- `strict-route`：所有连接强制走 tun 防泄漏（本机其他设备将不可访问）。
|
||||||
|
- 高级过滤（Linux/Android 部分需 auto-route）：include/exclude-interface、uid、mac-address、Android 用户/应用包名；`route-address` 自定义路由段；`mtu`、`gso` 等。
|
||||||
|
- iptables 透明代理：`tproxy-port: 9898` + `iptables: {enable: true, inbound-interface: eth0}`。
|
||||||
|
- `listeners` 中的 tun 类型可多实例配置（高级用法）。
|
||||||
|
|
||||||
|
# 6. 流量嗅探（sniffer）
|
||||||
|
|
||||||
|
- 对无域名流量（TUN/Redir/TProxy 且 DNS 为 redir-host，或纯 IP 流量）嗅探 TLS/HTTP/QUIC 以还原域名，从而走域名规则。
|
||||||
|
- `override-destination`：是否用嗅探结果作为实际访问目标。
|
||||||
|
- `force-domain`（如 `+.v2ex.com`）强制嗅探；`skip-*` 跳过；`sniff` 配置各协议端口（TLS/QUIC 默认 443，HTTP 默认 80）。
|
||||||
|
- 已废弃写法：`sniffing`、`port-whitelist`（被 `sniffer.sniff` 取代）。
|
||||||
|
|
||||||
|
# 7. 其他关键能力
|
||||||
|
|
||||||
|
- **Geo 数据**：GEOIP/GEOSITE/ASN 数据库，`geox-url` 自定义下载地址（meta-rules-dat release），`geo-auto-update` + `geo-update-interval` 自动更新；`geodata-loader` 有内存友好模式。
|
||||||
|
- **订阅加密**：proxy-providers 支持 age 加密（`age-secret-key`，age-encryption.org/v1 armor 格式）；命令行工具 `mihomo age keygen/convert/decrypt/encrypt`；`mihomo generate ech-keypair` 生成 ECH 密钥，`mihomo convert-ruleset` 转换 mrs 规则集。
|
||||||
|
- **多路复用**：smux（sing-mux，协议 smux/yamux/h2mux）、TCP Brutal 拥塞控制（brutal-opts）、gRPC 多路复用。
|
||||||
|
- **性能**：`tcp-concurrent`（并发连接所有解析 IP 取最快）、`unified-delay`（统一延迟计算）、TCP Fast Open（tfo）、MPTCP（mptcp）、`keep-alive` 调优。
|
||||||
|
- **出站控制**：`interface-name`（绑定网卡）、`routing-mark`（fwmark，Linux）、`dialer-proxy`（节点经另一代理建立连接，可链式）。
|
||||||
|
- **调试**：API 提供 debug 接口；日志级别 silent/error/warning/info/debug。
|
||||||
|
|
||||||
|
# 8. 与周边生态的关系
|
||||||
|
|
||||||
|
- 订阅/面板：metacubexd（官方面板）、Clash Verge Rev、Clash Meta for Android（CMFA）等客户端内嵌 mihomo 内核。
|
||||||
|
- 规则集数据源：MetaCubeX/meta-rules-dat（geoip.dat/geosite.dat/mmdb/mrs 包）。
|
||||||
|
- 上游/参考：Dreamacro/clash、SagerNet/sing-box、go-shadowsocks2、v2ray-core、wireguard-go。
|
||||||
@@ -0,0 +1,376 @@
|
|||||||
|
---
|
||||||
|
title: "mihomo 配置编写精要摘编（config.yaml 字段与模板）"
|
||||||
|
source: "MetaCubeX/mihomo Alpha 分支 docs/config.yaml 全量示例 + 官方文档 wiki.metacubex.one（全局配置/通用字段/代理组/路由规则/DNS/代理集合/规则集合）"
|
||||||
|
source_date: 2026-08-07
|
||||||
|
extracted_date: 2026-08-07
|
||||||
|
type: source-derivative
|
||||||
|
tags:
|
||||||
|
- "mihomo"
|
||||||
|
- "Clash"
|
||||||
|
- "config.yaml"
|
||||||
|
- "代理配置"
|
||||||
|
- "YAML"
|
||||||
|
confidence: high
|
||||||
|
contested: false
|
||||||
|
evidence_boundary: "抓取时间 2026-08-07。依据官方 docs/config.yaml（Alpha 分支，100,853 字符，含全部注释）与官方文档各配置章节。字段以官方示例注释为权威；示例中的 server/uuid/password/密钥均为占位符，复制使用时必须替换。部分字段随版本演进（文档已标废弃项见正文），新配置优先采用新写法。文中 YAML 片段为演示模板，未在真实 mihomo 实例上运行验证。"
|
||||||
|
---
|
||||||
|
|
||||||
|
# 来源说明
|
||||||
|
|
||||||
|
本文件是 mihomo `config.yaml` 配置编写的中文结构化精要，按"全局 → 节点 → 代理组 → 规则 → 提供者 → DNS"组织，附最小可用模板与常见坑。概念与架构见同目录《官方文档-架构与核心概念-摘编.md》。
|
||||||
|
|
||||||
|
## 证据分级
|
||||||
|
|
||||||
|
- **字段定义**：来自官方文档与官方示例注释，可直接作为编写依据。
|
||||||
|
- **模板示例**：按官方示例整理的最小组合，需按实际节点/需求替换占位符。
|
||||||
|
- **注意事项**：含官方文档标注的废弃项与社区常见误区，编写新配置时避免。
|
||||||
|
|
||||||
|
# 1. 全局配置（通用字段）
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
mixed-port: 7890 # HTTP+SOCKS5 混合入口端口（也可分别用 port/socks-port）
|
||||||
|
# redir-port / tproxy-port # Linux 透明代理
|
||||||
|
allow-lan: false # 允许局域网设备使用（true 时可用 bind-address 限定）
|
||||||
|
mode: rule # rule | global | direct
|
||||||
|
log-level: info # silent/error/warning/info/debug
|
||||||
|
ipv6: true
|
||||||
|
external-controller: 127.0.0.1:9090 # RESTful API；0.0.0.0 则对外
|
||||||
|
secret: "" # API 访问密钥（Authorization: Bearer）
|
||||||
|
external-ui: ./ui # Web 面板目录（访问 /ui）
|
||||||
|
profile:
|
||||||
|
store-selected: true # 记住 API 上对 select 组的选择
|
||||||
|
store-fake-ip: true # 持久化 fake-ip 映射
|
||||||
|
unified-delay: true
|
||||||
|
tcp-concurrent: true
|
||||||
|
find-process-mode: strict # always/strict/off（路由器建议 off）
|
||||||
|
geox-url: # 自定义 geo 数据下载地址（GEOIP/GEOSITE/mmdb/asn）
|
||||||
|
geoip: "https://fastly.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geoip.dat"
|
||||||
|
geosite: "https://fastly.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geosite.dat"
|
||||||
|
mmdb: "https://fastly.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geoip.metadb"
|
||||||
|
```
|
||||||
|
|
||||||
|
- 认证：`authentication: ["user:pass"]` + `skip-auth-prefixes`（跳过验证的 IP 段）；`lan-allowed-ips`/`lan-disallowed-ips` 控制 allow-lan 时允许/禁止的网段（黑名单优先）。
|
||||||
|
- hosts：类似 /etc/hosts，支持单 IP 或别名。
|
||||||
|
- 已废弃：全局 `client-fingerprint`（改在节点内配置）、组内 `interface-name`/`routing-mark`（改在节点内配置）。
|
||||||
|
|
||||||
|
# 2. 节点（proxies）
|
||||||
|
|
||||||
|
## 2.1 通用字段
|
||||||
|
|
||||||
|
| 字段 | 说明 |
|
||||||
|
|---|---|
|
||||||
|
| name | 必须，唯一 |
|
||||||
|
| type | 必须：ss / vmess / vless / trojan / snell / tuic / hysteria2 / wireguard / direct / dns / reject / compatible(pass) / gost-relay 等 |
|
||||||
|
| server / port | 服务器地址与端口（必须） |
|
||||||
|
| udp | 是否允许 UDP 过代理，默认 false（tuic/hysteria2/direct/dns 默认开） |
|
||||||
|
| ip-version | dual/ipv4/ipv6/ipv4-prefer/ipv6-prefer，默认 dual |
|
||||||
|
| tfo / mptcp | TCP Fast Open / 多路径 TCP |
|
||||||
|
| dialer-proxy | 经指定代理/组建立连接（链式代理） |
|
||||||
|
| interface-name / routing-mark | 绑定网卡 / fwmark（Linux） |
|
||||||
|
| smux | sing-mux 多路复用：enabled、protocol(smux/yamux/h2mux)、max-connections/min-streams/max-streams（互斥）、padding、brutal-opts（TCP Brutal 上下行 Mbps） |
|
||||||
|
| client-fingerprint | TLS 指纹：chrome/firefox/safari/ios/random（TLS 传输的 vmess/vless/trojan 等） |
|
||||||
|
| skip-cert-verify / name-cert-verify | 跳过证书校验 / 仅改 DNSName 校验目标（不改 SNI） |
|
||||||
|
| sni / servername | 覆盖 SNI（优先级高于 ws host） |
|
||||||
|
|
||||||
|
## 2.2 常用节点写法
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
proxies:
|
||||||
|
- name: "ss-1" # Shadowsocks
|
||||||
|
type: ss
|
||||||
|
server: example.com
|
||||||
|
port: 443
|
||||||
|
cipher: chacha20-ietf-poly1305 # 也支持 aes-*-gcm、2022-blake3-* 等
|
||||||
|
password: "your-password"
|
||||||
|
udp: true
|
||||||
|
# plugin: obfs / v2ray-plugin / shadow-tls / restls / kcptun（plugin-opts 见官方示例）
|
||||||
|
|
||||||
|
- name: "vmess-ws" # VMess + WebSocket + TLS
|
||||||
|
type: vmess
|
||||||
|
server: example.com
|
||||||
|
port: 443
|
||||||
|
uuid: "uuid"
|
||||||
|
alterId: 0
|
||||||
|
cipher: auto
|
||||||
|
tls: true
|
||||||
|
network: ws
|
||||||
|
ws-opts:
|
||||||
|
path: "/path"
|
||||||
|
headers: { Host: example.com }
|
||||||
|
|
||||||
|
- name: "vless-reality" # VLESS + REALITY（推荐自建）
|
||||||
|
type: vless
|
||||||
|
server: example.com
|
||||||
|
port: 443
|
||||||
|
uuid: "uuid"
|
||||||
|
network: tcp
|
||||||
|
tls: true
|
||||||
|
udp: true
|
||||||
|
flow: xtls-rprx-vision
|
||||||
|
servername: www.microsoft.com # REALITY 借用域名
|
||||||
|
client-fingerprint: chrome # 必填，不能为空
|
||||||
|
reality-opts:
|
||||||
|
public-key: xxx
|
||||||
|
short-id: xxx
|
||||||
|
# support-x25519mlkem768: false
|
||||||
|
|
||||||
|
- name: "trojan-1" # Trojan
|
||||||
|
type: trojan
|
||||||
|
server: example.com
|
||||||
|
port: 443
|
||||||
|
password: "your-password"
|
||||||
|
sni: example.com
|
||||||
|
udp: true
|
||||||
|
|
||||||
|
- name: "hy2-1" # Hysteria2（HTTP/3 + QUIC，UDP 默认开）
|
||||||
|
type: hysteria2
|
||||||
|
server: example.com
|
||||||
|
port: 443
|
||||||
|
password: "your-password"
|
||||||
|
up: "50 Mbps" # 客户端声明带宽，留空用 BBR 流控
|
||||||
|
down: "200 Mbps"
|
||||||
|
# obfs: salamander; obfs-password: xxx
|
||||||
|
```
|
||||||
|
|
||||||
|
- 其他类型要点：snell 需 `psk`（可选 obfs-opts: http/tls/shadow-tls/restls/jls）；wireguard 需 `private-key`、`ip`、`dns`、`public-key`、`mtu`；trojan 支持 grpc/ws 传输、reality-opts、shadow-tls/restls/jls-opts（需 tls: true）；`direct` 可配 interface-name 作"指定网卡直连"。
|
||||||
|
|
||||||
|
# 3. 代理组（proxy-groups）
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
proxy-groups:
|
||||||
|
- name: "PROXY" # 手动选择（select）
|
||||||
|
type: select
|
||||||
|
proxies: [DIRECT, auto, 节点名...] # 可引用其他组和内置 DIRECT/REJECT
|
||||||
|
# use: [provider1] # 引用代理集合
|
||||||
|
# default-selected: auto # 默认选中项
|
||||||
|
# filter: "(?i)港|hk|hongkong" # 正则筛选 use 引入的节点
|
||||||
|
# exclude-filter: "美|日"
|
||||||
|
# exclude-type: "Shadowsocks|Http"
|
||||||
|
# empty-fallback: COMPATIBLE # 组为空时的回退 proxy
|
||||||
|
|
||||||
|
- name: "auto" # 按延迟自动选择（url-test）
|
||||||
|
type: url-test
|
||||||
|
proxies: [...]
|
||||||
|
url: "https://www.gstatic.com/generate_204"
|
||||||
|
interval: 300 # 健康检查间隔（秒），0 关闭定时测试
|
||||||
|
tolerance: 150 # 延迟容差（毫秒）
|
||||||
|
lazy: true # 未选中时不测试
|
||||||
|
expected-status: 204 # 期望 HTTP 状态码（支持 200/302、400-503 写法）
|
||||||
|
|
||||||
|
- name: "fallback-1" # 按健康检查顺序优先（fallback）
|
||||||
|
type: fallback
|
||||||
|
proxies: [...]
|
||||||
|
url: "https://cp.cloudflare.com/generate_204"
|
||||||
|
interval: 300
|
||||||
|
|
||||||
|
- name: "lb" # 负载均衡
|
||||||
|
type: load-balance
|
||||||
|
proxies: [...]
|
||||||
|
url: "https://cp.cloudflare.com/generate_204"
|
||||||
|
interval: 300
|
||||||
|
strategy: round-robin # 可选 consistent-hashing / sticky-sessions
|
||||||
|
```
|
||||||
|
|
||||||
|
- 健康检查要点：`url` 只检查 `proxies` 字段（不检查 `use` 引入的集合节点，集合节点需在 provider 内配置 health-check）；`lazy: true`（默认）避免后台持续测试；`timeout` 毫秒；`max-failed-times` 失败次数超限触发强制检查（默认 5）。
|
||||||
|
- `include-all` / `include-all-proxies` / `include-all-providers`：自动引入全部节点/集合（按名称排序，不包含策略组）。
|
||||||
|
- `hidden: true` / `icon: xxx`：供面板隐藏组或显示图标（需前端适配）。
|
||||||
|
|
||||||
|
# 4. 规则（rules）
|
||||||
|
|
||||||
|
- **匹配顺序**：自上而下，第一条命中生效；规则不命中继续向下，最后用 `MATCH` 兜底。
|
||||||
|
- 常用规则类型：
|
||||||
|
|
||||||
|
| 类型 | 说明 |
|
||||||
|
|---|---|
|
||||||
|
| DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD | 完整域名 / 后缀（`google.com` 匹配 `www.google.com` 但不匹配 `content-google.com`）/ 关键字 |
|
||||||
|
| DOMAIN-WILDCARD / DOMAIN-REGEX | 通配符（`*` `?`）/ 正则 |
|
||||||
|
| GEOSITE, 分类名 | 匹配 geosite 域名集合（如 `GEOSITE,youtube,PROXY`） |
|
||||||
|
| GEOIP, 国家码 | IP 归属国（`GEOIP,CN,DIRECT`）；`GEOIP,CN,DIRECT,no-resolve` 跳过 DNS 解析 |
|
||||||
|
| IP-CIDR / IP-CIDR6 / IP-SUFFIX / IP-ASN | IP 段 / IP 段别名 / IP 后缀 / ASN 号 |
|
||||||
|
| SRC-GEOIP / SRC-IP-ASN / SRC-IP-CIDR / SRC-IP-SUFFIX | 匹配来源 IP |
|
||||||
|
| DST-PORT / SRC-PORT | 目标/来源端口 |
|
||||||
|
| IN-PORT / IN-TYPE / IN-USER / IN-NAME | 匹配入站端口 / 类型 / 用户名 / 名称 |
|
||||||
|
| PROCESS-PATH(-WILDCARD/-REGEX) / PROCESS-NAME(-WILDCARD/-REGEX) | 进程路径/名称匹配（Android 可匹配包名） |
|
||||||
|
| UID / NETWORK / DSCP | Linux UID / tcp|udp / DSCP 标记（仅 tproxy udp 入站） |
|
||||||
|
| RULE-SET, 名称 | 引用规则集（需 rule-providers） |
|
||||||
|
| AND / OR / NOT | 逻辑组合，如 `AND,((DOMAIN,baidu.com),(NETWORK,UDP)),DIRECT`（注意括号） |
|
||||||
|
| SUB-RULE | 匹配到子规则（`SUB-RULE,(NETWORK,tcp),sub-rule-name`） |
|
||||||
|
| MATCH | 匹配一切，兜底 |
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
rules:
|
||||||
|
- RULE-SET,reject,REJECT # 广告拦截
|
||||||
|
- RULE-SET,proxy,PROXY # 代理规则集（由 rule-providers 提供）
|
||||||
|
- GEOSITE,cn,DIRECT # 国内域名直连
|
||||||
|
- GEOIP,CN,DIRECT,no-resolve
|
||||||
|
- MATCH,PROXY
|
||||||
|
```
|
||||||
|
|
||||||
|
- 附加参数：`no-resolve`（目标 IP 类规则跳过 DNS 解析，避免触发解析污染；若前面已解析则仍会匹配）、`src`（把目标 IP 匹配转为来源 IP 匹配）。
|
||||||
|
|
||||||
|
# 5. 提供者（proxy-providers / rule-providers）
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
proxy-providers:
|
||||||
|
airport: # 机场订阅
|
||||||
|
type: http
|
||||||
|
url: "https://example.com/sub" # 支持 mihomo/Clash 格式或 v2ray 分享链接
|
||||||
|
interval: 86400 # 更新间隔（秒）
|
||||||
|
path: ./providers/airport.yaml # 默认限制在 HomeDir 内（SAFE_PATHS 可扩展）
|
||||||
|
proxy: DIRECT # 经哪个代理下载订阅（防订阅域名被墙）
|
||||||
|
health-check:
|
||||||
|
enable: true
|
||||||
|
url: "https://www.gstatic.com/generate_204"
|
||||||
|
interval: 300
|
||||||
|
override: # 覆写加载的节点
|
||||||
|
udp: true
|
||||||
|
# skip-cert-verify: true
|
||||||
|
# additional-prefix: "[机场] "
|
||||||
|
# proxy-name: [{pattern: "IPLC-(.*?)倍", target: "iplc x $1"}]
|
||||||
|
# override-expr: # yq v4 风格表达式（高级）
|
||||||
|
# - '.name = "[prov] " + .name'
|
||||||
|
|
||||||
|
rule-providers:
|
||||||
|
reject:
|
||||||
|
type: http
|
||||||
|
behavior: domain # domain / ipcidr / classical
|
||||||
|
format: yaml # yaml / text / mrs
|
||||||
|
url: "https://example.com/reject.yaml"
|
||||||
|
interval: 86400
|
||||||
|
path: ./rules/reject.yaml
|
||||||
|
# type: inline + payload 可内联定义；type: file 读本地文件
|
||||||
|
```
|
||||||
|
|
||||||
|
- provider 类型：`http`（远程）/ `file`（本地）/ `inline`（内联 payload；http/file 解析失败时 payload 可作备用）。
|
||||||
|
- `size-limit` 限制下载大小（字节）；`header` 自定义请求头（UA、Authorization）；`age-secret-key` 支持 age 加密订阅。
|
||||||
|
- rule-provider `behavior` 必须与文件内容格式一致：`domain`（每行一个域名）/ `ipcidr`（每行一个 CIDR）/ `classical`（完整 Clash 规则行）。`mrs` 格式二进制更省内存，`mihomo convert-ruleset` 可转换。
|
||||||
|
- `path-in-bundle`：从 BundleMRS.7z（meta-rules-dat）按路径加载规则集。
|
||||||
|
|
||||||
|
# 6. DNS 最小推荐配置（fake-ip + 防污染）
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
dns:
|
||||||
|
enable: true
|
||||||
|
enhanced-mode: fake-ip
|
||||||
|
fake-ip-range: 198.18.0.1/16
|
||||||
|
fake-ip-filter:
|
||||||
|
- "*.lan"
|
||||||
|
- "+.local"
|
||||||
|
- "localhost.ptlogin2.qq.com"
|
||||||
|
default-nameserver:
|
||||||
|
- 223.5.5.5
|
||||||
|
- 119.29.29.29
|
||||||
|
nameserver:
|
||||||
|
- https://doh.pub/dns-query
|
||||||
|
- https://dns.alidns.com/dns-query
|
||||||
|
fallback:
|
||||||
|
- tls://8.8.8.8
|
||||||
|
- tls://1.1.1.1
|
||||||
|
fallback-filter:
|
||||||
|
geoip: true
|
||||||
|
geoip-code: CN
|
||||||
|
ipcidr:
|
||||||
|
- 240.0.0.0/4
|
||||||
|
nameserver-policy:
|
||||||
|
"geosite:cn,private,apple":
|
||||||
|
- https://doh.pub/dns-query
|
||||||
|
- https://dns.alidns.com/dns-query
|
||||||
|
```
|
||||||
|
|
||||||
|
- 开启 `listen: 0.0.0.0:53` 可给局域网设备提供 DNS。
|
||||||
|
- 国内域名走 nameserver（精准、快），境外域名经 fallback-filter 判定后走 fallback（可信、防污染）。
|
||||||
|
- 节点为域名时配置 `proxy-server-nameserver`（如 `https://doh.pub/dns-query`）避免节点域名解析污染。
|
||||||
|
|
||||||
|
# 7. 最小可用配置模板（客户端，含 TUN）
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
mixed-port: 7890
|
||||||
|
allow-lan: false
|
||||||
|
mode: rule
|
||||||
|
log-level: info
|
||||||
|
ipv6: true
|
||||||
|
external-controller: 127.0.0.1:9090
|
||||||
|
secret: "your-api-secret"
|
||||||
|
profile:
|
||||||
|
store-selected: true
|
||||||
|
store-fake-ip: true
|
||||||
|
|
||||||
|
dns:
|
||||||
|
enable: true
|
||||||
|
enhanced-mode: fake-ip
|
||||||
|
fake-ip-range: 198.18.0.1/16
|
||||||
|
default-nameserver: [223.5.5.5, 119.29.29.29]
|
||||||
|
nameserver:
|
||||||
|
- https://doh.pub/dns-query
|
||||||
|
- https://dns.alidns.com/dns-query
|
||||||
|
fallback:
|
||||||
|
- tls://8.8.8.8
|
||||||
|
- tls://1.1.1.1
|
||||||
|
fallback-filter:
|
||||||
|
geoip: true
|
||||||
|
geoip-code: CN
|
||||||
|
|
||||||
|
tun:
|
||||||
|
enable: false # Windows/macOS 客户端可开 true；stack: mixed
|
||||||
|
stack: mixed
|
||||||
|
dns-hijack: ["0.0.0.0:53"]
|
||||||
|
auto-route: true
|
||||||
|
auto-detect-interface: true
|
||||||
|
|
||||||
|
proxy-providers: # 或直接写 proxies 节点
|
||||||
|
airport:
|
||||||
|
type: http
|
||||||
|
url: "https://你的订阅地址"
|
||||||
|
interval: 86400
|
||||||
|
health-check:
|
||||||
|
enable: true
|
||||||
|
url: "https://www.gstatic.com/generate_204"
|
||||||
|
interval: 300
|
||||||
|
|
||||||
|
proxy-groups:
|
||||||
|
- name: "PROXY"
|
||||||
|
type: select
|
||||||
|
proxies: [auto, DIRECT]
|
||||||
|
use: [airport]
|
||||||
|
default-selected: auto
|
||||||
|
- name: "auto"
|
||||||
|
type: url-test
|
||||||
|
proxies: [DIRECT]
|
||||||
|
use: [airport]
|
||||||
|
url: "https://www.gstatic.com/generate_204"
|
||||||
|
interval: 300
|
||||||
|
|
||||||
|
rule-providers:
|
||||||
|
reject:
|
||||||
|
type: http
|
||||||
|
behavior: domain
|
||||||
|
url: "https://cdn.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/cnc/ads.yaml" # 示例地址，按实际规则集替换
|
||||||
|
interval: 86400
|
||||||
|
path: ./rules/reject.yaml
|
||||||
|
proxy:
|
||||||
|
type: http
|
||||||
|
behavior: domain
|
||||||
|
url: "https://你的代理规则集地址"
|
||||||
|
interval: 86400
|
||||||
|
path: ./rules/proxy.yaml
|
||||||
|
|
||||||
|
rules:
|
||||||
|
- RULE-SET,reject,REJECT
|
||||||
|
- RULE-SET,proxy,PROXY
|
||||||
|
- GEOSITE,cn,DIRECT
|
||||||
|
- GEOIP,CN,DIRECT,no-resolve
|
||||||
|
- MATCH,PROXY
|
||||||
|
```
|
||||||
|
|
||||||
|
# 8. 常见坑（写配置时逐条核对）
|
||||||
|
|
||||||
|
1. **YAML 缩进/引号**：节点名、密码含特殊字符（`:` `#` 等）必须加引号；组名含特殊符号同理。
|
||||||
|
2. **规则顺序**：`MATCH` 必须放最后；GEOIP,CN,DIRECT 前先放 RULE-SET 代理规则，避免国内 CDN/境外域名误直连或误代理。
|
||||||
|
3. **fake-ip 与直连内网**：内网/局域网域名（`*.lan`、`*.local`、NAS、路由器管理页）必须进 `fake-ip-filter`，否则 TUN 模式下无法访问。
|
||||||
|
4. **节点域名解析**：订阅节点为域名时，务必配置 `proxy-server-nameserver`，否则可能解析失败或走错 DNS。
|
||||||
|
5. **健康检查与 UDP**：url-test/fallback 组只测 `proxies` 里的节点；需要 UDP 的协议（游戏、VoIP）确认节点 `udp: true` 且组未 `disable-udp`。
|
||||||
|
6. **allow-lan 安全**：对外监听时配 `authentication` 或限制 `lan-allowed-ips`，API 别绑 0.0.0.0 且无 secret。
|
||||||
|
7. **路径限制**：provider 的 path 默认只能在 HomeDir（启动 `-d` 指定），其他位置需 `SAFE_PATHS` 环境变量。
|
||||||
|
8. **已废弃字段**：`sniffing`/`port-whitelist`（用 `sniffer.sniff`）、组内 `interface-name`/`routing-mark`（用节点内）、全局 `client-fingerprint`（用节点内）、`fallback-filter.geosite`（用 nameserver-policy）。
|
||||||
|
9. **规则集 behavior 必须匹配**：domain 规则集配 `behavior: domain`，写错会加载失败。
|
||||||
|
10. **验证方式**：`mihomo -t -f config.yaml` 测试配置；`mihomo -d .` 指定工作目录；API `GET /configs` 可查运行状态。
|
||||||
@@ -612,3 +612,47 @@ last_updated: 2026-08-03
|
|||||||
**中文**: ATR 止损
|
**中文**: ATR 止损
|
||||||
**定义**: 以平均真实波动范围（ATR，TR 的均值，TR = max(|最高-最低|, |最高-昨收|, |昨收-最低|)）的倍数作为止盈止损距离的风险控制规则；期货双向策略中需按买入方向（call/put）区分触发条件。
|
**定义**: 以平均真实波动范围（ATR，TR 的均值，TR = max(|最高-最低|, |最高-昨收|, |昨收-最低|)）的倍数作为止盈止损距离的风险控制规则；期货双向策略中需按买入方向（call/put）区分触发条件。
|
||||||
**参见**: [[阿布量化策略开发与回测|阿布量化策略开发与回测]]
|
**参见**: [[阿布量化策略开发与回测|阿布量化策略开发与回测]]
|
||||||
|
|
||||||
|
## 网络工具
|
||||||
|
|
||||||
|
### mihomo (Clash Meta 内核)
|
||||||
|
**英文**: mihomo
|
||||||
|
**中文**: mihomo（曾用名 Clash Meta，社区中文名"虚空终端"）
|
||||||
|
**定义**: 原 Dreamacro/clash 的二次开发代理内核，Go 语言实现；提供本地 HTTP/SOCKS 代理、TUN 虚拟网卡、内置防污染 DNS（fake-ip）、规则路由、远程代理/规则提供者与 RESTful API 控制面。GPL-3.0 许可，与 MetaCubeX 无关的下游项目不得在名称中使用 mihomo。
|
||||||
|
**参见**: [[mihomo-内核与配置体系|mihomo（Clash Meta 内核）架构与配置体系]]、[[mihomo-配置编写指南]]
|
||||||
|
|
||||||
|
### Clash (原版 Clash)
|
||||||
|
**英文**: Clash
|
||||||
|
**中文**: Clash（原版）
|
||||||
|
**定义**: Dreamacro/clash 开发的规则路由代理内核（已归档）；mihomo 兼容其全部特性并在此基础上扩展。社区常把基于 Clash 规则的客户端配置（config.yaml：proxies/proxy-groups/rules）统称为"Clash 配置"。
|
||||||
|
**参见**: [[mihomo-内核与配置体系|mihomo（Clash Meta 内核）架构与配置体系]]
|
||||||
|
|
||||||
|
### fake-ip (虚拟 IP 模式)
|
||||||
|
**英文**: fake-ip
|
||||||
|
**中文**: 虚拟 IP 模式（fake-ip）
|
||||||
|
**定义**: mihomo DNS 的增强模式之一：DNS 查询返回 fake-ip 池（默认 198.18.0.1/16）中的虚拟 IP，内核内部维护域名→fake-ip 映射，实际建连时按域名规则转发。客户端不接触真实解析结果，可规避 DNS 污染，配合 TUN 可接管全部系统流量。
|
||||||
|
**参见**: [[mihomo-内核与配置体系|mihomo（Clash Meta 内核）架构与配置体系]]
|
||||||
|
|
||||||
|
### redir-host (真实 IP 模式)
|
||||||
|
**英文**: redir-host
|
||||||
|
**中文**: 真实 IP 模式（redir-host）
|
||||||
|
**定义**: mihomo DNS 的增强模式之一：DNS 查询返回真实 IP，行为与传统代理一致；相对 fake-ip 更易受 DNS 污染影响。
|
||||||
|
**参见**: [[mihomo-内核与配置体系|mihomo（Clash Meta 内核）架构与配置体系]]
|
||||||
|
|
||||||
|
### Proxy Group (代理组/策略组)
|
||||||
|
**英文**: Proxy Group
|
||||||
|
**中文**: 代理组（策略组）
|
||||||
|
**定义**: 将若干节点（或子组）组合为单一出口并定义选择策略的配置单元；类型包括 select（手动）、url-test（按延迟选优）、fallback（按健康顺序优先）与 load-balance（负载均衡）。内置出站 DIRECT（直连）、REJECT（拒绝）、COMPATIBLE/PASS（放行）。
|
||||||
|
**参见**: [[mihomo-配置编写指南]]
|
||||||
|
|
||||||
|
### Proxy Provider (代理集合)
|
||||||
|
**英文**: Proxy Provider
|
||||||
|
**中文**: 代理集合（节点提供者）
|
||||||
|
**定义**: 从远程（http）、本地文件（file）或内联（inline）加载节点列表的机制；支持按间隔更新、经指定代理下载、age 加密订阅、override 覆写（含 yq 风格表达式）与筛选。用于替代硬编码节点，保持配置可维护。
|
||||||
|
**参见**: [[mihomo-配置编写指南]]
|
||||||
|
|
||||||
|
### Rule Provider (规则集/规则提供者)
|
||||||
|
**英文**: Rule Provider
|
||||||
|
**中文**: 规则集（规则提供者）
|
||||||
|
**定义**: 将一组规则（域名/IP 段/完整规则行）打包为独立文件或远程资源的机制，通过 `RULE-SET,名称,出口` 在 rules 中引用；behavior 分 domain/ipcidr/classical，格式支持 yaml/text/mrs。
|
||||||
|
**参见**: [[mihomo-配置编写指南]]
|
||||||
|
|||||||
@@ -115,6 +115,10 @@ last_updated: 2026-08-07
|
|||||||
- [[玻璃数据字典与数据库设计|玻璃数据字典与数据库设计]] - 隆众、Wind、海关指标口径与质量检查
|
- [[玻璃数据字典与数据库设计|玻璃数据字典与数据库设计]] - 隆众、Wind、海关指标口径与质量检查
|
||||||
- [[企业自由现金流分析|企业自由现金流分析]] - FCFF、FCFE 和现金流指标审阅方法
|
- [[企业自由现金流分析|企业自由现金流分析]] - FCFF、FCFE 和现金流指标审阅方法
|
||||||
|
|
||||||
|
## 10. 网络工具
|
||||||
|
- [[mihomo-内核与配置体系|mihomo（Clash Meta 内核）架构与配置体系]] - 代理内核的分层架构、DNS 防污染（fake-ip）、规则路由、健康检查与提供者机制
|
||||||
|
- [[mihomo-配置编写指南|mihomo 配置编写指南]] - 从零编写 config.yaml 的流程、模板与检查清单，供代写配置复用
|
||||||
|
|
||||||
## 资料与证据
|
## 资料与证据
|
||||||
- [[期货资料来源与证据边界|期货资料来源与证据边界]] - 期货资料轻量化迁移、证据等级和未复制文件说明
|
- [[期货资料来源与证据边界|期货资料来源与证据边界]] - 期货资料轻量化迁移、证据等级和未复制文件说明
|
||||||
|
|
||||||
|
|||||||
@@ -107,3 +107,5 @@ raw/期货/10-品种相关/锌/百川盈孚-锌锭市场周报-2026年第31周-
|
|||||||
raw/期货/00-整体相关/上海期货交易所-有色金属系列期货合约交易操作手册-2019版-摘编.md sha256:A0F8F98FB84E4592D8F317382D80ED5CB3D14E75BB87B644FF0FEFAF0133B0F2 2026-08-07 wiki/concepts/锌期货产业链与供需框架.md,wiki/concepts/锌期货合约交割与风险控制.md,wiki/practices/锌期货研究框架.md,wiki/INDEX.md,wiki/sources.md 2026-08-07 success
|
raw/期货/00-整体相关/上海期货交易所-有色金属系列期货合约交易操作手册-2019版-摘编.md sha256:A0F8F98FB84E4592D8F317382D80ED5CB3D14E75BB87B644FF0FEFAF0133B0F2 2026-08-07 wiki/concepts/锌期货产业链与供需框架.md,wiki/concepts/锌期货合约交割与风险控制.md,wiki/practices/锌期货研究框架.md,wiki/INDEX.md,wiki/sources.md 2026-08-07 success
|
||||||
raw/期货/90-待核验/黄金-数月以来最大的行情布局-ZeroHedge-20260805-摘编.md sha256:B1DC97A6EA9E9BC67C91DC413D5F0759D5D7C4D71D8A88900EE39CC5C5BFE890 2026-08-07 wiki/practices/黄金市场观点与交易判断.md,wiki/INDEX.md,wiki/sources.md 2026-08-07 success
|
raw/期货/90-待核验/黄金-数月以来最大的行情布局-ZeroHedge-20260805-摘编.md sha256:B1DC97A6EA9E9BC67C91DC413D5F0759D5D7C4D71D8A88900EE39CC5C5BFE890 2026-08-07 wiki/practices/黄金市场观点与交易判断.md,wiki/INDEX.md,wiki/sources.md 2026-08-07 success
|
||||||
raw/宏观/金融前沿的20种思考-巴曙松-2021-摘编.md sha256:A3E9E0F01C5EA4BB90DDB34FAA4D3C3670E862858C0B9457DF11C2FD72FB9734 2026-08-07 wiki/concepts/金融前沿20种思考.md,wiki/INDEX.md,wiki/sources.md 2026-08-07 success
|
raw/宏观/金融前沿的20种思考-巴曙松-2021-摘编.md sha256:A3E9E0F01C5EA4BB90DDB34FAA4D3C3670E862858C0B9457DF11C2FD72FB9734 2026-08-07 wiki/concepts/金融前沿20种思考.md,wiki/INDEX.md,wiki/sources.md 2026-08-07 success
|
||||||
|
raw/技术/mihomo/官方文档-架构与核心概念-摘编.md d2540a477284aa6b46e1ae6ba8d34b2f909c521a7ed32de9474203dd9301299a 2026-08-07 wiki/concepts/mihomo-内核与配置体系.md,wiki/practices/mihomo-配置编写指南.md,wiki/INDEX.md,wiki/Glossary.md,wiki/sources.md 2026-08-07 success
|
||||||
|
raw/技术/mihomo/官方文档-配置编写-摘编.md 17ad7664cb257744a3277c1709d15912156a521dcac1f014ccfd335f3880b1cf 2026-08-07 wiki/concepts/mihomo-内核与配置体系.md,wiki/practices/mihomo-配置编写指南.md,wiki/INDEX.md,wiki/Glossary.md,wiki/sources.md 2026-08-07 success
|
||||||
|
|||||||
|
@@ -271,3 +271,11 @@
|
|||||||
- 编译：新增 `wiki/concepts/金融前沿20种思考.md`（8 个可复用框架：社融/M2 口径、金融周期政策组合、系统性风险三拐点、固收定价与久期、资产配置与大宗商品定位、期权与保险+期货、商品定价权、周期与商品联动）；更新 `wiki/INDEX.md`、`wiki/sources.md` 和 `wiki/compile-results.tsv`。
|
- 编译：新增 `wiki/concepts/金融前沿20种思考.md`（8 个可复用框架：社融/M2 口径、金融周期政策组合、系统性风险三拐点、固收定价与久期、资产配置与大宗商品定位、期权与保险+期货、商品定价权、周期与商品联动）；更新 `wiki/INDEX.md`、`wiki/sources.md` 和 `wiki/compile-results.tsv`。
|
||||||
- 证据边界：20 讲演讲集中于 2017-2018 年，数据与判断具有时效性；每章预测性表述降级为主讲人观点；PDF 表格数字提取不全，以正文文字为准。
|
- 证据边界：20 讲演讲集中于 2017-2018 年，数据与判断具有时效性；每章预测性表述降级为主讲人观点；PDF 表格数字提取不全，以正文文字为准。
|
||||||
- 哈希：摘编正文 `A3E9E0F01C5EA4BB90DDB34FAA4D3C3670E862858C0B9457DF11C2FD72FB9734`（文件字节 SHA-256）；原始 PDF `F3C0C1396FF61E639696A376B2B00B4B7C2D9F9DF72D4524FA1D197256BCF389`。
|
- 哈希：摘编正文 `A3E9E0F01C5EA4BB90DDB34FAA4D3C3670E862858C0B9457DF11C2FD72FB9734`（文件字节 SHA-256）；原始 PDF `F3C0C1396FF61E639696A376B2B00B4B7C2D9F9DF72D4524FA1D197256BCF389`。
|
||||||
|
|
||||||
|
## [2026-08-07] ingest | MetaCubeX/mihomo（Clash Meta 内核）官方资料入库
|
||||||
|
|
||||||
|
- 输入：官方仓库 README（Meta 分支，raw.githubusercontent.com 抓取）、官方文档 wiki.metacubex.one（全局配置/节点/代理组/路由规则/DNS/代理集合/规则集合章节）、Alpha 分支 docs/config.yaml 全量示例（100,853 字符，本地缓存）。注意：GitHub 首页同名项目 KT-Yeh/mihomo（崩坏星穹铁道 Python 库）与本项目无关，已排除。
|
||||||
|
- 保存：中文结构化摘编 2 份入 `raw/技术/mihomo/`：① 架构与核心概念（项目定位、分层架构、DNS 防污染/fake-ip、TUN/透明代理、sniffer、API、许可与生态）；② 配置编写精要（全局/节点/代理组/规则/提供者字段、DNS 推荐配置、最小可用模板、8 步流程与 10 条检查清单、10 个常见坑）。
|
||||||
|
- 编译：新增 `wiki/concepts/mihomo-内核与配置体系.md`（concept 总览）与 `wiki/practices/mihomo-配置编写指南.md`（practice，供后续代写配置复用）；更新 `wiki/INDEX.md`（新增第 10 节"网络工具"）、`wiki/Glossary.md`（mihomo/Clash/fake-ip/redir-host/代理组/代理提供者/规则集术语）、`wiki/sources.md` 与 `wiki/compile-results.tsv`。
|
||||||
|
- 证据边界：官方 README/文档/示例为唯一依据，抓取时间 2026-08-07；示例中服务器/密码/密钥为占位符；文档已标注废弃字段（sniffing、组内 interface-name/routing-mark、全局 client-fingerprint、fallback-filter.geosite）在新配置中不采用；模板未经真实实例运行验证。
|
||||||
|
- 哈希：两份摘编均按正文（frontmatter 之后 body）SHA-256 登记：架构 `d2540a477284aa6b46e1ae6ba8d34b2f909c521a7ed32de9474203dd9301299a`，配置 `17ad7664cb257744a3277c1709d15912156a521dcac1f014ccfd335f3880b1cf`。
|
||||||
|
|||||||
@@ -0,0 +1,99 @@
|
|||||||
|
---
|
||||||
|
title: "mihomo（Clash Meta 内核）架构与配置体系"
|
||||||
|
type: concept
|
||||||
|
last_updated: 2026-08-07
|
||||||
|
tags:
|
||||||
|
- "网络工具"
|
||||||
|
- "mihomo"
|
||||||
|
- "代理"
|
||||||
|
- "DNS"
|
||||||
|
- "TUN"
|
||||||
|
confidence: high
|
||||||
|
contested: false
|
||||||
|
raw_sources:
|
||||||
|
- path: "raw/技术/mihomo/官方文档-架构与核心概念-摘编.md"
|
||||||
|
hash: "sha256:d2540a477284aa6b46e1ae6ba8d34b2f909c521a7ed32de9474203dd9301299a"
|
||||||
|
- path: "raw/技术/mihomo/官方文档-配置编写-摘编.md"
|
||||||
|
hash: "sha256:17ad7664cb257744a3277c1709d15912156a521dcac1f014ccfd335f3880b1cf"
|
||||||
|
---
|
||||||
|
|
||||||
|
# mihomo（Clash Meta 内核）架构与配置体系
|
||||||
|
|
||||||
|
## 页面定位
|
||||||
|
|
||||||
|
本页解释 mihomo 内核是什么、它的分层架构与核心机制（DNS 防污染、规则路由、健康检查、提供者机制），是理解代理工具工作原理的**总览概念页**。实际写配置的逐步流程见 [[mihomo-配置编写指南]]；字段级细节与模板见 `raw/技术/mihomo/` 两份摘编。
|
||||||
|
|
||||||
|
## 定义与项目背景
|
||||||
|
|
||||||
|
- **mihomo**（曾用名 Clash Meta）是原 Dreamacro/clash 的二次开发代理内核，Go 语言实现；默认分支 `Meta`（稳定）、`Alpha`（开发）。
|
||||||
|
- 兼容原版 Clash 全部特性，并吸收 sing-box、v2ray-core 等项目的实现；官方文档站 wiki.metacubex.one（中文，社区称"虚空终端"）。
|
||||||
|
- 许可 GPL-3.0，附加条款：与 MetaCubeX 无关的下游项目不得在名称中使用 "mihomo"。
|
||||||
|
- 配套面板 metacubexd；客户端（Clash Verge Rev、CMFA 等）内嵌本内核。
|
||||||
|
- 构建要求 Go 1.20+；gvisor tun 栈需 `-tags with_gvisor` 编译。
|
||||||
|
|
||||||
|
## 分层架构
|
||||||
|
|
||||||
|
```
|
||||||
|
应用 → 入口监听（mixed-port/socks/tun/redir/tproxy/自定义 listeners）
|
||||||
|
→ 内置 DNS（fake-ip 或 redir-host）
|
||||||
|
→ 规则匹配（rules 自上而下，首条命中生效）
|
||||||
|
→ 出口（代理组/节点；DIRECT/REJECT/COMPATIBLE 内置出站）
|
||||||
|
→ 节点 → 目标服务器
|
||||||
|
```
|
||||||
|
|
||||||
|
- **入口**：mixed-port（HTTP+SOCKS 混合）、port、socks-port、tun、redir/tproxy（Linux 透明代理）、`listeners` 自定义入站（hysteria2/tuic/tun/ss/vmess 等）、`tunnels` 端口转发。
|
||||||
|
- **模式**：`rule`（默认）/ `global` / `direct`。
|
||||||
|
- **控制面**：RESTful API（external-controller + secret + 可选 TLS/Unix socket/namedpipe），`external-ui` 挂 Web 面板；可外置 DoH 服务器。
|
||||||
|
|
||||||
|
## 核心机制
|
||||||
|
|
||||||
|
### 1. DNS 防污染（fake-ip + fallback）
|
||||||
|
|
||||||
|
- `enhanced-mode: fake-ip` 时 DNS 返回 fake-ip 池（默认 `198.18.0.1/16`）的虚拟 IP，内核内部维护 域名→fake-ip 映射，实际建连按域名规则转发——客户端不接触真实解析结果，天然规避 DNS 污染；配合 TUN 可接管全部系统流量。
|
||||||
|
- `redir-host` 模式返回真实 IP。
|
||||||
|
- 防污染工作流：`nameserver`（国内 DNS）解析 → `fallback-filter` 判断结果非 CN 时改用 `fallback`（境外可信 DNS）；`nameserver-policy` 按域名/geosite 精确指定解析器；`proxy-server-nameserver` 专门解析节点域名，避免"鸡蛋问题"。
|
||||||
|
|
||||||
|
### 2. 规则路由
|
||||||
|
|
||||||
|
- 规则自上而下首条命中；类型覆盖域名（DOMAIN/SUFFIX/KEYWORD/WILDCARD/REGEX/GEOSITE）、IP（GEOIP/IP-CIDR/IP-ASN/SRC-*）、端口、入站（IN-*）、进程（PROCESS-*）、UID、网络类型、逻辑组合（AND/OR/NOT/SUB-RULE）与 RULE-SET。
|
||||||
|
- 目标 IP 类规则可用 `no-resolve` 跳过 DNS 解析。
|
||||||
|
- GEOIP/GEOSITE 数据来自 meta-rules-dat，可 `geox-url` 自定义下载并自动更新。
|
||||||
|
|
||||||
|
### 3. 代理组与健康检查
|
||||||
|
|
||||||
|
- `select` 手动选择、`url-test` 按延迟选最优、`fallback` 按健康顺序优先、`load-balance` 负载均衡。
|
||||||
|
- 健康检查：`url`（如 gstatic generate_204）+ `interval` + `timeout` + `expected-status`；`lazy: true` 时未选中不测试。url 只测 `proxies` 字段的节点，`use` 引入的集合节点在 provider 内单独配 health-check。
|
||||||
|
|
||||||
|
### 4. 提供者机制（解耦配置）
|
||||||
|
|
||||||
|
- `proxy-providers`：http/file/inline 三种来源加载节点，支持间隔更新、经代理下载、age 加密订阅、override 覆写（字段覆盖 + yq v4 风格 `override-expr` 表达式）、filter 筛选。
|
||||||
|
- `rule-providers`：domain/ipcidr/classical 三种 behavior，yaml/text/mrs 格式，可远程更新；`path-in-bundle` 从 BundleMRS.7z 加载。
|
||||||
|
|
||||||
|
### 5. TUN / 透明代理 / 嗅探
|
||||||
|
|
||||||
|
- `tun`：虚拟网卡接管流量；stack system/gvisor/mixed；dns-hijack、auto-route、auto-redirect（Linux iptables）、strict-route 防泄漏；支持接口/UID/MAC/Android 应用级过滤。
|
||||||
|
- `sniffer`：对纯 IP/redir-host 流量嗅探 TLS/HTTP/QUIC 还原域名，使无域名流量也能走域名规则。
|
||||||
|
|
||||||
|
## 证据与不确定性
|
||||||
|
|
||||||
|
- 本页基于官方 README、官方文档与官方 config.yaml 示例（2026-08-07 抓取），字段定义可直接作为编写依据。
|
||||||
|
- 项目迭代快：文档已标注若干废弃字段（如 `sniffing`/`port-whitelist`、组内 `interface-name`/`routing-mark`、全局 `client-fingerprint`、`fallback-filter.geosite`），新配置应使用新写法。
|
||||||
|
- 官方示例中的服务器/密码/密钥均为占位符，不可直接使用。
|
||||||
|
|
||||||
|
## 失效条件与风险
|
||||||
|
|
||||||
|
- fake-ip 模式下内网/局域网域名（`*.lan`、`*.local`、设备管理页）未加 `fake-ip-filter` 将无法访问。
|
||||||
|
- 节点为域名但未配 `proxy-server-nameserver` 时可能解析失败。
|
||||||
|
- 规则顺序错误（如 MATCH 提前、GEOIP,CN 置于代理规则之前）导致分流错误。
|
||||||
|
- 对外监听（allow-lan / API 绑 0.0.0.0）无认证会暴露代理与 API 控制面。
|
||||||
|
|
||||||
|
## 相关页面
|
||||||
|
|
||||||
|
- [[mihomo-配置编写指南]] - 从零写 config.yaml 的逐步流程、模板与检查清单
|
||||||
|
- [[Obsidian-CLI-Wiki-Maintenance]] - 本仓库 Wiki 维护实践（同属"工具链"语境）
|
||||||
|
- [[Glossary|术语表]] - mihomo、fake-ip、代理组等术语定义
|
||||||
|
|
||||||
|
## 深入阅读
|
||||||
|
|
||||||
|
- raw 摘编：`raw/技术/mihomo/官方文档-架构与核心概念-摘编.md`、`raw/技术/mihomo/官方文档-配置编写-摘编.md`
|
||||||
|
- 官方仓库：https://github.com/MetaCubeX/mihomo ；官方文档：https://wiki.metacubex.one/
|
||||||
@@ -0,0 +1,117 @@
|
|||||||
|
---
|
||||||
|
title: "mihomo 配置编写指南"
|
||||||
|
type: practice
|
||||||
|
last_updated: 2026-08-07
|
||||||
|
tags:
|
||||||
|
- "网络工具"
|
||||||
|
- "mihomo"
|
||||||
|
- "config.yaml"
|
||||||
|
- "代理配置"
|
||||||
|
confidence: high
|
||||||
|
contested: false
|
||||||
|
raw_sources:
|
||||||
|
- path: "raw/技术/mihomo/官方文档-配置编写-摘编.md"
|
||||||
|
hash: "sha256:17ad7664cb257744a3277c1709d15912156a521dcac1f014ccfd335f3880b1cf"
|
||||||
|
- path: "raw/技术/mihomo/官方文档-架构与核心概念-摘编.md"
|
||||||
|
hash: "sha256:d2540a477284aa6b46e1ae6ba8d34b2f909c521a7ed32de9474203dd9301299a"
|
||||||
|
---
|
||||||
|
|
||||||
|
# mihomo 配置编写指南
|
||||||
|
|
||||||
|
## 页面定位
|
||||||
|
|
||||||
|
本页是**实践页**：给出从零编写 mihomo `config.yaml` 的逐步流程、最小可用模板与逐条检查清单，用于"帮用户写配置"这类任务。机制原理见 [[mihomo-内核与配置体系]]；字段级细节与全部节点写法见 `raw/技术/mihomo/` 摘编。
|
||||||
|
|
||||||
|
## 编写目标
|
||||||
|
|
||||||
|
产出一份可运行、分流正确、防污染、易维护的 mihomo 配置。适用场景：客户端（Windows/macOS/Linux 桌面）代理、路由器/网关透明代理、局域网共享代理。
|
||||||
|
|
||||||
|
## 编写流程（分步）
|
||||||
|
|
||||||
|
### 第 1 步：确定需求
|
||||||
|
|
||||||
|
- 使用形态：桌面客户端（用不用 TUN？）、局域网共享（allow-lan）、路由器（tproxy + iptables）。
|
||||||
|
- 节点来源：订阅（机场/自建订阅 URL）、手写节点（自建 ss/vless/trojan/hysteria2 等）。
|
||||||
|
- 分流诉求：代理境外（默认）、直连国内、广告拦截（reject 规则集）、特定域名/进程指定出口。
|
||||||
|
|
||||||
|
### 第 2 步：搭全局骨架
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
mixed-port: 7890
|
||||||
|
allow-lan: false # 局域网共享时 true，并考虑 authentication
|
||||||
|
mode: rule
|
||||||
|
log-level: info
|
||||||
|
ipv6: true
|
||||||
|
external-controller: 127.0.0.1:9090
|
||||||
|
secret: "替换为随机串" # 绑 0.0.0.0 时必设
|
||||||
|
profile:
|
||||||
|
store-selected: true
|
||||||
|
store-fake-ip: true
|
||||||
|
```
|
||||||
|
|
||||||
|
### 第 3 步：配 DNS（fake-ip + 防污染）
|
||||||
|
|
||||||
|
按摘编第 6 节模板：`default-nameserver`（纯 IP）、`nameserver`（国内 DoH）、`fallback`（境外 TLS DoH）、`fallback-filter`（geoip CN）、`fake-ip-filter`（内网域名）。节点为域名时加 `proxy-server-nameserver`。
|
||||||
|
|
||||||
|
### 第 4 步：填节点（proxies）或订阅（proxy-providers）
|
||||||
|
|
||||||
|
- 有订阅：`proxy-providers` 一段即可（type http + url + interval + health-check + override.udp: true）。
|
||||||
|
- 手写节点：按类型填 `type/server/port` + 协议专属字段（ss 的 cipher/password、vmess 的 uuid/alterId、vless-reality 的 flow/servername/reality-opts、hysteria2 的 password/up/down 等），确认 `udp: true`（游戏等场景）。
|
||||||
|
- 节点域名解析：配 `proxy-server-nameserver`。
|
||||||
|
|
||||||
|
### 第 5 步：建代理组
|
||||||
|
|
||||||
|
- `select` 组「PROXY」（默认选中 url-test 组或具体节点）+ `url-test` 组「auto」（自动选优）+ 可选 fallback / load-balance 组。
|
||||||
|
- 健康检查 `url: "https://www.gstatic.com/generate_204"`、`interval: 300`、`expected-status: 204`。
|
||||||
|
|
||||||
|
### 第 6 步：写规则
|
||||||
|
|
||||||
|
自上而下：广告/隐私 reject → 代理规则集（RULE-SET,proxy,PROXY）→ 国内直连（GEOSITE,cn,DIRECT；GEOIP,CN,DIRECT,no-resolve）→ MATCH,PROXY 兜底。注意 `MATCH` 必须在最后。
|
||||||
|
|
||||||
|
### 第 7 步：可选增强
|
||||||
|
|
||||||
|
- TUN（桌面客户端）：`tun: {enable: true, stack: mixed, dns-hijack: ["0.0.0.0:53"], auto-route: true, auto-detect-interface: true}`；内网域名务必进 fake-ip-filter。
|
||||||
|
- 路由器透明代理：`tproxy-port` + `iptables.enable`；或 tun + auto-redirect。
|
||||||
|
- Web 面板：`external-ui` 指向 metacubexd 目录。
|
||||||
|
|
||||||
|
### 第 8 步：验证
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
mihomo -t -f config.yaml # 语法与结构校验
|
||||||
|
mihomo -d . -f config.yaml # 实际启动（或 -d 指定 HomeDir）
|
||||||
|
# 启动后：面板/API 检查节点延迟、规则命中；curl -x http://127.0.0.1:7890 https://www.google.com 验证代理
|
||||||
|
```
|
||||||
|
|
||||||
|
## 检查清单（写完逐条过）
|
||||||
|
|
||||||
|
- [ ] YAML 缩进正确；含特殊字符的节点名/密码已加引号
|
||||||
|
- [ ] 每个节点 name 唯一；组引用名称与节点名一致
|
||||||
|
- [ ] `MATCH` 在规则最底部；GEOIP,CN,DIRECT 之前有代理规则集兜境外域名
|
||||||
|
- [ ] `fake-ip-filter` 覆盖 `*.lan`、`*.local` 及内网管理域名
|
||||||
|
- [ ] 节点为域名时已配 `proxy-server-nameserver`
|
||||||
|
- [ ] 需要 UDP 的场景节点 `udp: true`，组未 `disable-udp`
|
||||||
|
- [ ] allow-lan/API 对外时已配认证或 secret
|
||||||
|
- [ ] provider path 在 HomeDir 内（或已设 SAFE_PATHS）
|
||||||
|
- [ ] 无废弃字段（`sniffing`、组内 `interface-name`/`routing-mark`、全局 `client-fingerprint`）
|
||||||
|
- [ ] `mihomo -t` 通过；实际启动后分流验证通过
|
||||||
|
|
||||||
|
## 常见坑（高发错误）
|
||||||
|
|
||||||
|
1. 规则顺序错误 → 分流错乱（最常见）。
|
||||||
|
2. fake-ip 未过滤内网域名 → TUN 下访问不了 NAS/路由器。
|
||||||
|
3. 订阅节点域名解析污染 → 忘配 `proxy-server-nameserver`。
|
||||||
|
4. url-test/fallback 组不测 `use` 引入的节点 → 集合节点需在 provider 配 health-check。
|
||||||
|
5. rule-provider behavior 与文件格式不匹配 → 加载失败。
|
||||||
|
6. 对外暴露代理/API 无认证 → 被滥用。
|
||||||
|
7. 直接复制官方示例占位符 → 无法连接。
|
||||||
|
|
||||||
|
## 相关页面
|
||||||
|
|
||||||
|
- [[mihomo-内核与配置体系]] - 架构与核心机制
|
||||||
|
- [[Glossary|术语表]] - mihomo、fake-ip、代理组等术语
|
||||||
|
- [[Obsidian-CLI-Wiki-Maintenance]] - 本仓库 Wiki 维护实践
|
||||||
|
|
||||||
|
## 深入阅读
|
||||||
|
|
||||||
|
- raw 摘编：`raw/技术/mihomo/官方文档-配置编写-摘编.md`（字段级参考 + 模板）
|
||||||
|
- 官方文档：https://wiki.metacubex.one/ ；官方示例：https://github.com/MetaCubeX/mihomo/blob/Alpha/docs/config.yaml
|
||||||
@@ -94,3 +94,7 @@ last_updated: 2026-08-07
|
|||||||
## 量化交易框架资料
|
## 量化交易框架资料
|
||||||
|
|
||||||
- [[阿布量化框架架构|阿布量化框架架构]]、[[阿布量化策略开发与回测|阿布量化策略开发与回测]]、[[期货量化回测与位移路程比|期货量化回测与位移路程比]] - GitHub 开源项目 [bbfamily/abu（阿布量化）](https://github.com/bbfamily/abu)（commit d602d84，2026-01-24，v0.4.0，GPL）；源码本体 73MB 未整包入库，摘编与 381 文件哈希清单保存在 `raw/量化/abuquant/`，本地源码在 `raw/量化/abuquant-src/`（不入库），可凭 commit 从 GitHub 重新获取验证
|
- [[阿布量化框架架构|阿布量化框架架构]]、[[阿布量化策略开发与回测|阿布量化策略开发与回测]]、[[期货量化回测与位移路程比|期货量化回测与位移路程比]] - GitHub 开源项目 [bbfamily/abu（阿布量化）](https://github.com/bbfamily/abu)（commit d602d84，2026-01-24，v0.4.0，GPL）；源码本体 73MB 未整包入库，摘编与 381 文件哈希清单保存在 `raw/量化/abuquant/`，本地源码在 `raw/量化/abuquant-src/`（不入库），可凭 commit 从 GitHub 重新获取验证
|
||||||
|
|
||||||
|
## 网络工具资料
|
||||||
|
|
||||||
|
- [[mihomo-内核与配置体系|mihomo（Clash Meta 内核）架构与配置体系]]、[[mihomo-配置编写指南|mihomo 配置编写指南]] - [MetaCubeX/mihomo](https://github.com/MetaCubeX/mihomo)（Clash Meta 内核，GPL-3.0，默认分支 Meta）官方 README、官方文档 [wiki.metacubex.one](https://wiki.metacubex.one/)（虚空终端 Docs）与 Alpha 分支 `docs/config.yaml` 全量示例（2026-08-07 抓取）；中文摘编保存在 `raw/技术/mihomo/`。官方示例中服务器/密码/密钥为占位符，模板未在真实实例上运行验证
|
||||||
|
|||||||
Reference in New Issue
Block a user