Premium 版本 · 配置文档

外部匹配条件的引用功能怎样按内容选用行为类型

把匹配条件独立管理,主配置负责声明来源与引用关系;域名、网段和完整规则分别选用合适的行为类型。

  • RULE-SET
  • rule-providers
  • behavior
  • interval
  • path
章节索引

旧配置的版本边界

旧版内核的功能限制只适用于相应版本,不能据此判断现用程序。迁移配置、安装或调整运行权限前,应重新核对当前项目的说明。

配置语法应查阅 当前配置说明;界面操作、安装步骤及权限要求,则查看 客户端项目说明。

将匹配条目独立存放,再由规则集载入,可以减少主配置中重复的内容;使用前须确认当前内核具备相应能力。

主配置通过 rule-providers 声明这些来源,并由规则引用相应名称。下例同时展示远程读取与本地文件的写法。

yaml
rule-providers:
  sample_a:
    behavior: "domain" # domain, ipcidr or classical (仅限 扩展版本 内核)
    type: http
    url: "url"
    # format: 'yaml' # or 'text'
    interval: 3600
    path: ./sample_a.yaml
  sample_b:
    behavior: "domain"
    type: file
    path: /sample_b.yaml

rules:
  - RULE-SET,sample_a,REJECT
  - RULE-SET,sample_b,policy

behavior 决定条目的解释方式,可按域名、IP 网段或完整规则分别组织。

domain:按域名组织

YAML 写法:条目放入 payload 列表。

yaml
payload:
  - '.example.com'
  - '*.*.example.net'
  - 'docs.example.org'

文本写法:每行列出域名匹配内容。

txt
# comment
.example.com
*.*.example.net
docs.example.org

ipcidr:按地址范围组织

YAML 写法:在 payload 内逐项写入网段。

yaml
payload:
  - '192.168.1.0/24'
  - '127.0.0.0/8'

文本写法:按行列出需要匹配的 IP 范围。

txt
# comment
192.168.1.0/24
127.0.0.0/8

classical:保留规则类型

YAML 写法:在条目前保留匹配类型。

yaml
payload:
  - DOMAIN-SUFFIX,example.com
  - DOMAIN-KEYWORD,example
  - DOMAIN,ad.com
  - SRC-IP-CIDR,192.168.1.201/32
  - IP-CIDR,127.0.0.0/8
  - GEOIP,CN
  - DST-PORT,80
  - SRC-PORT,7777
  # MATCH 在这里并不是必须的

文本写法:逐行填写类型及对应参数。

txt
# comment
DOMAIN-SUFFIX,example.com
DOMAIN-KEYWORD,example
DOMAIN,ad.com
SRC-IP-CIDR,192.168.1.201/32
IP-CIDR,127.0.0.0/8
GEOIP,CN
DST-PORT,80
SRC-PORT,7777