hBlock项目中allow.list文件不支持通配符问题的分析与解决方案

问题背景

hBlock是一款流行的DNS广告拦截工具，它通过整合多个来源的域名黑名单来生成统一的拦截规则。在实际使用过程中，用户发现了一个重要问题：当在allow.list文件中添加顶级域名（如nextdns.io）时，该工具无法自动过滤掉该域名的所有子域名（如dns.nextdns.io、edge.nextdns.io等）。

技术分析

hBlock默认的allow.list匹配机制是精确匹配，这意味着：

1. 如果allow.list中包含"example.com"，它只会允许"example.com"，而不会自动包含"www.example.com"或"api.example.com"
2. 这种设计在大多数情况下是合理的，因为它提供了更精确的控制
3. 但对于需要批量允许整个域名及其所有子域名的场景，这种机制就显得不够灵活

解决方案

hBlock提供了正则表达式支持来解决这个问题。具体实现方式有两种：

方法一：通过命令行参数

在执行hBlock命令时添加-r或--regex参数：

hblock -O hblock.txt -p 10 -H none -F none -T 'address /%D/#' -r

方法二：通过环境变量

设置HBLOCK_REGEX环境变量：

export HBLOCK_REGEX=1
hblock -O hblock.txt -p 10 -H none -F none -T 'address /%D/#'

正则表达式写法

在启用正则表达式支持后，allow.list中的条目可以使用POSIX基本正则表达式。要匹配域名及其所有子域名，可以使用以下模式：

^\(.*\.\)*nextdns\.io$

这个正则表达式的含义是：

• ^ 表示字符串开始
• \(.*\.\)* 匹配任意数量的任意子域名（包括零个）
• nextdns\.io 匹配目标域名
• $ 表示字符串结束

实际应用示例

假设我们需要允许nextdns.io及其所有子域名通过，同时保持其他拦截规则不变，可以这样操作：

1. 编辑allow.list文件：

sudo nano /etc/hblock/allow.list

2. 添加正则表达式（确保已启用正则表达式支持）：

^\(.*\.\)*nextdns\.io$

3. 保存后重新生成规则：

hblock -O hblock.txt -p 10 -H none -F none -T 'address /%D/#' -r

注意事项

1. 正则表达式语法必须符合POSIX BRE标准
2. 特殊字符如点号(.)需要使用反斜杠()转义
3. 启用正则表达式支持后，allow.list中的所有条目都将被视为正则表达式
4. 对于简单的精确匹配，可以直接写域名而不使用正则表达式

总结

hBlock通过正则表达式支持提供了灵活的域名过滤机制。虽然默认情况下不支持通配符匹配，但通过启用正则表达式功能并使用适当的模式，用户可以轻松实现批量允许顶级域名及其所有子域名的需求。这种方法既保持了工具的精确性，又提供了必要的灵活性，是处理复杂过滤需求的理想解决方案。