文件与规则 · 技术说明

配置快速入手:找到启动时实际读取的文件

配置文件的路径由启动方式决定。先区分目录参数 -d 和文件参数 -f,再检查地址括号、域名引号与通配符的覆盖范围。

  • config.yaml
  • -d
  • -f
  • IPv6
  • DOMAIN-SUFFIX
章节索引

旧版行为与适用边界

旧配置中的功能限制与内核代际有关。迁移到其他实现时,应重新确认字段支持情况;旧版的能力边界不能直接套用到正在运行的软件。

不同实现的字段差异可查阅 现用内核配置说明;涉及界面操作、安装步骤或权限时,另查 所用程序的使用指引 中的适用条件。

动手填写参数前,可从配置流程概览理清接收连接、查找规则与选择出口的关系,再回头确定文件位置。

定位主配置

程序读取的主文件使用名称 config.yaml。未另行指定路径时,读取位置为 默认配置目录;此目录尚未建立时,会在该处创建基础配置。

要更换读取目录,可把目标路径(如 指定配置目录)交给参数 -d;下方分别展示当前目录与指定目录的写法。

shell
/path/to/program -d . # current directory
/path/to/program -d /path/to/config

若要直接选定某份文件,则使用 -f,后面接文件路径。

shell
/path/to/program -f ./config.yaml
/path/to/program -f /path/to/config/config.yaml

检查书写规则

文件能够被找到之后,还应核对地址与域名的写法。

IPv6 字面地址

填写 IPv6 字面地址时,在两侧加上 [],不要省略这对括号。

txt
[aaaa::a8aa:ff:fe09:57d8]

DNS 域名覆盖范围

给某个域名及其下级名称设置解析行为时,可以在 DNS 解析设置中使用通配表达式。例如,针对 localdomain 的下级名称,可按需要选择覆盖层级。

先明确是否包含根域,再选择相应符号;不同写法的覆盖范围并不相同。

书写提醒

带通配符的名称需要使用单引号 '。例如 '*.example.com'。发生重叠时,先看精确名称,再看星号写法,最后看点号写法:foo.example.com > *.example.com > .example.com。

只覆盖下一层名称时,采用 *;根域不在它的覆盖范围中。

写法示例覆盖范围排除范围
*.example.comwww.example.comexample.com
*.bar.example.comfoo.bar.example.combar.example.com
*.*.example.comthoughtful.sandbox.example.comone.two.three.example.com

需要跨层覆盖下级名称而排除根域时,采用 .,示例列出了不同深度的名称。

写法示例覆盖范围排除范围
.example.comwww.example.comexample.com
.example.comthoughtful.sandbox.example.comexample.com
.example.comone.two.three.example.comexample.com

根域也需要纳入范围时,采用 +;下级名称同样会被覆盖。

+ 的覆盖方式可参照 DOMAIN-SUFFIX:根域与不同深度的下级名称可使用同一写法处理。

写法示例覆盖范围
+.example.comexample.com
+.example.comwww.example.com
+.example.comthoughtful.sandbox.example.com
+.example.comone.two.three.example.com