# Arremes Max 规则语法说明 (小白友好版) > 这份文档只讲两件事:**怎么写规则**、**写了会发生什么**。 > 不需要懂编程,照着例子抄就行。 --- ## 一、一分钟上手 (先看这 4 个例子) | 你想干什么 | 就写这一行 | 效果 | |---|---|---| | 拦掉某个域名 | `||example.com^` | example.com 和它的所有子域名都会被拦 | | 放行某个域名 | `@@||example.com^` | 明确放行 (哪怕别的规则想拦它) | | 拦掉所有 443 端口 | `||*:443^$network` | 任何 IP 的 443 端口 (HTTPS)都拦 | | 写一句注释 | `! 这是注释` 或 `# 这是注释` | 不生效,只是给自己看的 | **三条铁律**:拦截规则是"黑名单",放行规则**必须带 `@@`**,没命中的自动"直通"。 --- ## 二、三种结果,一次说清 引擎对每一条数据只会给出三种判定之一: | 判定 | 什么时候出现 | 结果 | |---|---|---| | **拦截** | 命中了拦截规则 (黑名单) | 数据被丢弃,连不上 | | **放行** | 命中了 `@@` 放行规则 (白名单) | 数据正常通过 | | **直通** | 谁都没命中 (默认状态) | 数据正常通过 | > 大白话:门口保安拿两个名单。 > 黑名单上有的 → 拦下;白名单 (`@@`)上有的 → 直接放; > 两个名单都没有 → 默认通行 (直通)。 > > **注意**:活动页只会把"命中 `@@` 的"标记成"放行";其余没命中的都叫"直通"。这是正常的,不是 bug。 --- ## 三、定制符号语法 (推荐写法) | 语法 | 含义 | 示例 | |---|---|---| | `||域名^` | 拦截域名及其子域 | `||behaviorlog.qq.com^` | | `||*关键字*^` | 通配符匹配 | `||*anticheat*^` | | `||IP^$ip` | 拦截指定 IP | `||180.97.219.4^$ip` | | `||:端口^$prot` | 拦截端口 | `||:443^$prot` (等价 `*:443`) | | `||IP:端口^$ip_port` | 拦截 IP:端口 | `||180.97.219.4:49155^$ip_port` | | `||IP:*^$network` | 拦截该 IP 的全部端口 | `||180.97.219.4:*^$network` | | `||*:端口^$network` | 拦截任意 IP 的指定端口 | `||*:49155^$network` | | `@@||域名^` | 放行 (白名单) | `@@||pay.qq.com^` | | `!` / `#` | 注释行 | `# 这是注释` | ### 修饰符速查 | 修饰符 | 意思 | |---|---| | `$ip` | 这条是 IP | | `$prot` / `$port` | 这条是端口 | | `$ip_port` | 这条是 IP:端口 | | `$network` | 这条是"IP:*"或"*:端口" | --- ## 四、传统写法还能用吗?能。 | 传统写法 | 等于 | |---|---| | `> 域名` | `||域名^` (拦) | | `+ 域名` | `@@||域名^` (放) | | `= 域名` | 精确匹配 | | `$443` | `*:443` (拦端口) | | `0.0.0.0 域名` (hosts 格式) | `||域名^` (拦) | | 中文:`拦 x` / `只拦 x` / `放 x` / `拦端口 x` | 同上,兼容保留 | > 新旧语法可以混着写,一行一条,别写在同一行里。 --- ## 五、常见问题 (最容易踩的坑) **Q1:为什么我的规则不生效?** - 检查前缀:拦截要 `||` 开头、放行必须是 `@@||` 开头; - 检查端口规则:端口写法必须是 `*:443` 这种格式 (或 `||*:443^$network`); - 检查是不是被 `@@` 放行规则"盖过了" (放行优先)。 **Q2:为什么开了之后所有网站都打不开?** - 十有八九写了 `||*:443^$network` (拦所有 443)或 `||*:80^$network` (拦所有 80)。 - 这**不是 bug**,是规则本来的意思:拦"任意 IP 的 443/80 端口"。 - 想只拦特定目标:把 `*` 换成具体 IP,例如 `||180.97.219.4:443^$ip_port`。 **Q3:勾了"拦截应用"后,别的应用会受影响吗?** - 不会。只有勾选的应用 (被 VPN 接管),其余应用完全不受影响。 **Q4:内置规则现在是什么?** - 当前内置 2 条端口规则 (下面第六节),旧版 163 万条已备份可回滚。 **Q5:拦了会不会误伤我自己的 App?** - 本应用自己的流量永远不进拦截引擎 (自动排除自身)。 **Q6 如果都正常还是没办法拦截,感觉自己没搞错。** - 检查是不是傻到把''也当场规则用了,''只是md文档用来标注高亮,当成规则的我建议去医院看看脑科。 --- ## 六、内置规则现状 ```text ||*:443^$network ||*:80^$network ``` - 含义:拦截"任意 IP 的 443 端口 / 80 端口"。 - 旧版 163 万条全量表已备份 (work/hosts_backup_1635528.txt)。 - 改表后必须同步更新 `assets/rules/stamp.txt` (格式 `行数|字节数|日期`),以触发端上重建。 --- ## 七、加载链 (了解即可) ```text assets/rules/hosts.txt └─ 构建时加密并重命名为随机名 └─ 运行时解密 → files/net_hosts └─ 服务启动后逐行解析 (RuleX 语法归一) └─ 进表:域名表 / IP:端口表 └─ 详情页显示"内置规则数 / 成功加载数" ``` --- ## 八、活动页分类口径 - 「放行」= 命中 `@@` 放行规则; - 「拦截」= 命中拦截规则; - 「直通」= 未命中任何规则 (照常转发)。