Skip to content

@ 符号用法

当您希望将规则存放在远程服务器或本地项目文件中,并让 Whistle 自动同步更新时;或当服务端要求双向认证(mTLS)时,可以利用规则里面的 @ 符号实现。

引入规则文件 (@path)

功能: 动态加载外部规则文件内容(支持自动刷新)

使用格式: @文件路径或URL

支持类型:

  • 远程 URL:@https://example.com/rules.txt
  • 本地文件:@~/projects/rules.txt(支持所有操作系统路径)
  • 插件接口:@whistle.nohost/api/rules(需插件实现接口)

    Windows 路径可混用 / 和 \:

    txt
    @C:/whistle/rules.txt
    @D:\config\proxy.rules

配置客户端证书 (@clientCert://)

功能: 为双向认证(mTLS)请求指定客户端证书

使用格式:

txt
@clientCert://key=私钥路径&cert=cert或pem证书路径

@clientCert://pwd=passphrase&cert=pfx或p12证书路径

支持类型:

txt
# cert 格式证书
pattern @clientCert://key=/User/xxx/test.key&cert=/User/xxx/test.crt

# pem 格式证书
pattern @clientCert://key=E:\test.pem&cert=E:\test.pem

# pfx 格式证书
pattern @clientCert://pwd=passphrase&pfx=/User/xxx/test.pfx

# p12 格式证书
pattern @clientCert://pwd=passphrase&pfx=E:/test.p12

Windows 路径可混用 /\