AdGuard DNS Filter
Since sing-box 1.10.0
sing-box supports some rule-set formats from other projects which cannot be fully translated to sing-box, currently only AdGuard DNS Filter.
These formats are not directly supported as source formats, instead you need to convert them to binary rule-set.
Convert
Use sing-box rule-set convert --type adguard [--output <file-name>.srs] <file-name>.txt to convert to binary rule-set.
Performance
AdGuard keeps all rules in memory and matches them sequentially, while sing-box chooses high performance and smaller memory usage. As a trade-off, you cannot know which rule item is matched.
Compatibility
Almost all rules in AdGuardSDNSFilter and rules in rule-sets listed in adguard-filter-list are supported.
Supported formats
AdGuard Filter
Basic rule syntax
| Syntax | Supported |
|---|---|
@@ |
|
\|\| |
|
\| |
|
^ |
|
* |
Host syntax
| Syntax | Example | Supported |
|---|---|---|
| Scheme | https:// |
Ignored |
| Domain Host | example.org |
|
| IP Host | 1.1.1.1, 10.0.0. |
|
| Regexp | /regexp/ |
|
| Port | example.org:80 |
|
| Path | example.org/path/ad.js |
Modifier syntax
| Modifier | Supported |
|---|---|
$important |
|
$dnsrewrite=0.0.0.0 |
Ignored |
| Any other modifiers |
Hosts
Only items with 0.0.0.0 IP addresses will be accepted.
Simple
When all rule lines are valid domains, they are treated as simple line-by-line domain rules which, like hosts, only match the exact same domain.