阅读前确认内核版本
脚本捷径属于这里记录的历史用法;旧版中的能力限制不能直接套用于现用程序。修改配置或运行权限前,应先对照当前项目的要求。
在支持该能力的旧版内核中,可以通过脚本条件动态选择请求的处理策略。
可以由完整脚本接管匹配,也可以把命名捷径插入普通规则。两种路径的配置入口不同;完整接管方式另见 脚本。
若希望在 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)