第 3 章:配置文件规范与通用指令

首页 > Maoge 技术手册 > 第 3 章:配置文件规范与通用指令

第 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