Elektrine DNS lists

The blocklists Elektrine's DNS filter serves, in one format. Elektrine resolvers read only this repository, so they never depend on upstream curators being reachable, keeping their URLs, or keeping their formats.

Format

lists/<id>.txt holds one lowercase domain per line, sorted and unique. A listed domain also blocks its subdomains. Lines starting with # are a short provenance header (source, license, domain count). The id matches the list id in Elektrine's filter catalog.

Updating

Upstream curators are contacted only when someone runs the importer:

./import.sh               # every list in sources.tsv
./import.sh hagezi-pro    # one list
git diff --stat lists/    # review the changes before committing

The importer normalizes hosts files, Adblock ||domain^ rules, *.domain wildcards, and plain domain lists into the format above, using the same hostname rules as the resolver. A list whose download fails, or that shrinks below half its current size, keeps its current copy and is reported.

Commit and push, and resolvers pick the new copy up on their next sync. Sources live in sources.tsv; add a row to import a new list.

Sources and licenses

List	Upstream	License
hagezi-multi, hagezi-pro, native-apple, native-windows, native-samsung, native-xiaomi, native-huawei, native-amazon, native-roku	HaGeZi dns-blocklists	GPL-3.0
oisd	oisd big	GPL-3.0
ads-trackers	StevenBlack hosts	MIT
cname-cloaking	AdGuard cname-trackers	MIT
native-sonos	NextDNS native-tracking-domains	MIT

Each list is redistributed under its upstream license; the texts are in LICENSES/. The GPL-3.0 lists are modified only by reformatting.