Premium 版本 · 配置文档

复用规则条件的功能怎样选择表达式并读取连接属性

把可复用的脚本条件命名后接入普通规则;解释器、连接属性、辅助函数与 DNS 查询行为需要分别核对。

  • Script Shortcuts
  • Expr
  • Starlark
  • no-resolve
  • SCRIPT
章节索引

阅读前确认内核版本

脚本捷径属于这里记录的历史用法;旧版中的能力限制不能直接套用于现用程序。修改配置或运行权限前,应先对照当前项目的要求。

现用内核的语法可查 当前配置说明;安装、界面与授权操作应参考 客户端项目说明。

在支持该能力的旧版内核中,可以通过脚本条件动态选择请求的处理策略。

可以由完整脚本接管匹配,也可以把命名捷径插入普通规则。两种路径的配置入口不同;完整接管方式另见 脚本。

若希望在 rules 模式中复用条件,可用 SCRIPT 引用捷径;它默认触发 DNS 查询,追加 no-resolve 即可避免主动解析,例如 SCRIPT,quic,DIRECT,no-resolve。

yaml
mode: Rule

script:
  engine: expr # or starlark
  shortcuts:
    quic: network == 'udp' and dst_port == 443
    curl: resolve_process_name() == 'curl'
    # curl: resolve_process_path() == '/usr/bin/curl'

rules:
  - SCRIPT,quic,REJECT

选择表达式解释器

Expr 是所列示例的默认解释器;是否改用其他解释器,应按表达式语法与兼容性决定。

Starlark 的语法接近 Python,也可用于定义捷径条件。

可读取的连接属性

  • network: string(连接使用的网络类型)
  • type: string(连接类型)
  • src_ip: string(来源 IP)
  • dst_ip: string(目标 IP)
  • src_port: uint16(来源端口)
  • dst_port: uint16(目标端口)
  • inbound_port: uint16(入站端口)
  • host: string(请求主机名)
  • process_path: string(来源程序路径)

兼容性提示

旧版 Starlark 的变量列表里没有 process_path,使用前需区分解释器。

可调用的辅助函数

ts
type resolve_ip = (host: string) => string // ip string
type in_cidr = (ip: string, cidr: string) => boolean // ip in cidr
type in_ipset = (name: string, ip: string) => boolean // ip in ipset
type geoip = (ip: string) => string // country code
type match_provider = (name: string) => boolean // in rule provider
type resolve_process_name = () => string // find process name (curl .e.g)
type resolve_process_path = () => string // find process path (/usr/bin/curl .e.g)