第 3 章:配置文件规范与通用指令
Maoge 的配置文件采用与 Surge 相同的 INI 分段格式组织。一个标准配置文件由若干以方括号包裹的节(Section)构成,每个节负责控制引擎某一子系统的运作逻辑。
一、 配置文件标准分段全景
| 段名 (Section) |
主要功能 |
在 Maoge 中的对应界面 |
[General] |
全局通用参数(监听端口、跳过代理白名单、DNS、IPv6 等)。 |
通用设置 (⌘,) |
[Proxy] |
单个出站代理节点的声明与加密连接参数定义。 |
节点列表 (⇧⌘N) |
[Proxy Group] |
策略组定义(手动选择、自动测速、故障转移、SSID 条件分流等)。 |
策略组管理 (⌘P) |
[Rule] |
流量分流与规则匹配链定义(自上而下逐行求值)。 |
分流规则 (⇧⌘R) |
[Host] |
本地静态 DNS 解析映射与域名别名定义。 |
DNS 与 Hosts 面板 |
[URL Rewrite] |
HTTP/HTTPS URL 路径重定向与重写规则。 |
高级重写面板 |
[MITM] |
HTTPS 中间人解密证书声明与目标解密主机名白名单。 |
MITM 证书配置 |
二、 [General] 常用关键指令详解
| 指令参数 |
默认值 |
说明与取值建议 |
port |
6152 |
本机 HTTP 代理服务监听端口。 |
socks-port |
6153 |
本机 SOCKS5 代理服务监听端口。 |
allow-wifi-access |
false |
是否允许局域网内的其他设备连接本机 HTTP/SOCKS 端口(开启后常用于手机调试)。 |
skip-proxy |
127.0.0.1, 192.168.0.0/16, *.local |
绝对不经过代理直连的目标地址/域名列表,多个条目以英文逗号分隔。 |
dns-server |
223.5.5.5, 119.29.29.29 |
上游标准 DNS 服务器列表,支持 UDP / TCP 解析。 |
encrypted-dns-server |
https://dns.alidns.com/dns-query |
加密 DNS 服务器,支持 DoH(DNS over HTTPS)与 DoQ(DNS over QUIC),防篡改与污染。 |
ipv6 |
true |
是否启用 IPv6 流量分流支持。 |
loglevel |
notify |
日志输出级别:verbose, info, notify, warning。 |
三、 标准配置文件示范模板
[General]
loglevel = notify
port = 6152
socks-port = 6153
allow-wifi-access = false
skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, localhost, *.local, e.crashlytics.com
dns-server = 223.5.5.5, 119.29.29.29, 8.8.8.8
encrypted-dns-server = https://dns.alidns.com/dns-query
[Proxy]
DIRECT = direct
HK-01 = ss, 1.2.3.4, 8388, encrypt-method=aes-256-gcm, password=SecretKey
US-01 = vless, us.example.com, 443, username=uuid-here, tls=true, ws=true, ws-path=/vless
[Proxy Group]
Proxy = select, Auto-Test, HK-01, US-01, DIRECT
Auto-Test = url-test, HK-01, US-01, url=http://cp.cloudflare.com/generate_204, interval=300, tolerance=50
[Rule]
# 苹果本地云端直连
DOMAIN-SUFFIX,apple.com,DIRECT
DOMAIN-SUFFIX,icloud.com,DIRECT
# 局域网与本地地址直连
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
# 国际服务分流
DOMAIN-SUFFIX,google.com,Proxy
DOMAIN-SUFFIX,github.com,Proxy
GEOIP,CN,DIRECT
# 最终默认兜底
FINAL,Proxy