How To Use IPFire DBL

IPFire DBL works with virtually any network security tool or DNS resolver. Choose the integration method that fits your infrastructure and start blocking malicious domains in minutes.

DNS Response Policy Zone (RPZ)

The IPFire DBL is published as a Response Policy Zone (RPZ) and can be consumed by many popular recursive DNS resolvers. Every listed domain blocks all of its subdomains, too.

Resolvers fetch the list via AXFR/IXFR, store it locally, and only transfer updates when the zone changes — keeping bandwidth usage low and resolution fast. The server to fetch the zones from is hosted at xfr.dbl.ipfire.org. Zone transfers are also available over TLS (XoT) on port 853.

If your DNS software cannot fetch the lists using AXFR/IXFR, the zones can also be downloaded over HTTPS.

Configuration Examples

Replace NAME with the list you want to block:

List Zone Download
Advertising ads.rpz.ipfire.org Download
Dating dating.rpz.ipfire.org Download
DNS-over-HTTPS doh.rpz.ipfire.org Download
Gambling gambling.rpz.ipfire.org Download
Games games.rpz.ipfire.org Download
Malware malware.rpz.ipfire.org Download
Phishing phishing.rpz.ipfire.org Download
Piracy piracy.rpz.ipfire.org Download
Pornography porn.rpz.ipfire.org Download
Shopping shopping.rpz.ipfire.org Download
Smart TV smart-tv.rpz.ipfire.org Download
Social Networks social.rpz.ipfire.org Download
Streaming streaming.rpz.ipfire.org Download
Violence violence.rpz.ipfire.org Download
BIND
options {
  response-policy {
    zone "NAME.rpz.ipfire.org";
  };
};

zone "NAME.rpz.ipfire.org" {
  type secondary;
  primaries { 81.3.27.55; };
  file "NAME.rpz.ipfire.org.zone";
};

BIND needs the IP address of xfr.dbl.ipfire.org. To transfer the zone over TLS, use these primaries instead:

tls ipfire-dbl {
  remote-hostname "xfr.dbl.ipfire.org";
};

zone "NAME.rpz.ipfire.org" {
  ...
  primaries { 81.3.27.55 port 853 tls ipfire-dbl; };
};
Unbound
server:
  module-config: "respip validator iterator"

rpz:
  name: NAME.rpz.ipfire.org
  primary: xfr.dbl.ipfire.org
  zonefile: /var/cache/unbound/NAME.rpz.ipfire.org.zone

To transfer the zone over TLS, use primary: 81.3.27.55@853#xfr.dbl.ipfire.org.

PowerDNS Recursor
recursor:
  rpzs:
  - name: NAME.rpz.ipfire.org
    addresses:
    - 'xfr.dbl.ipfire.org'
Knot Resolver

Knot Resolver reads RPZ from a file and reloads it automatically whenever it changes. Download the zone regularly over HTTPS, for example using a timer:

policy.add(policy.rpz(policy.DENY,
  '/var/lib/knot-resolver/NAME.rpz.ipfire.org.zone', true))
Allowing Domains

If a domain is blocked that you need, you can allow it locally with a small zone of your own which is loaded before IPFire DBL. Resolvers use the first policy zone that matches. Please also report the domain so that we can fix it for everyone.

$TTL 60
@ IN SOA localhost. root.localhost. 1 3600 600 86400 60
@ IN NS localhost.

example.com   CNAME rpz-passthru.
*.example.com CNAME rpz-passthru.

Query the list using DNS

IPFire DBL lists are also available as a regular blocklist in DNS. That way, you can quickly check if a domain is listed in a specific category without fetching the entire list.

# dig +short A example.tld.NAME.dbl.ipfire.org
127.0.0.2

The response will be 127.0.0.2 for any listed domains, and NXDOMAIN otherwise. Use DNSSEC to ensure the authenticity of the data.

Zones
List Zone
Advertising ads.dbl.ipfire.org
Dating dating.dbl.ipfire.org
DNS-over-HTTPS doh.dbl.ipfire.org
Gambling gambling.dbl.ipfire.org
Games games.dbl.ipfire.org
Malware malware.dbl.ipfire.org
Phishing phishing.dbl.ipfire.org
Piracy piracy.dbl.ipfire.org
Pornography porn.dbl.ipfire.org
Shopping shopping.dbl.ipfire.org
Smart TV smart-tv.dbl.ipfire.org
Social Networks social.dbl.ipfire.org
Streaming streaming.dbl.ipfire.org
Violence violence.dbl.ipfire.org

Plaintext Formats

All IPFire DBL lists are also available as downloadable files. They are intended for setups where the lists are consumed directly, for example by firewalls, filtering proxies, custom scripts, or systems using hosts-file based blocking.

  • Domains: one domain per line
  • Hosts: one 0.0.0.0 domain entry per line
  • Adblock Plus: for software that understands the Adblock Plus filter syntax

Lines starting with # are comments which tell you when the list has been updated and where the data comes from.

Hosts files can only block the exact domains that are listed, but not any of their subdomains. If your software supports it, prefer the RPZ or the domains format with a filter that matches subdomains as well.

Please don't fetch the lists more often than once an hour. The server supports compression and conditional requests (If-Modified-Since and If-None-Match), so you will only download a list when it has changed.

Suricata

IPFire DBL lists are available as a ruleset for Suricata which can filter:

  • DNS Queries
  • TLS and QUIC connections using SNI
  • HTTP Requests

The ruleset contains a separate file for each list, so you can choose which categories you want to use.

If you are using suricata-update, you can add IPFire DBL as a rule source like so:

# suricata-update add-source "IPFire DBL" https://dbl.ipfire.org/lists/suricata.tar.gz

All rules only raise an alert by default. To block any traffic, Suricata must run in IPS mode and the rules have to be changed to drop. With suricata-update, add the lists you want to block to /etc/suricata/drop.conf and run it again:

# Drop everything on the Malware and Phishing lists
re:IPFire DBL \[Malware\]
re:IPFire DBL \[Phishing\]

Or you can manually download the rules:

Download Suricata Ruleset

Browser Extensions

Click on the button below and right-click on your desired list to select "Subscribe to filter list..." with your favourite extension.

IPFire_

IPFire DBL is natively integrated into IPFire in the following features:

OpenWrt

OpenWrt users can enable IPFire DBL directly through the Adblock package by adding it as an external blocklist feed.

In LuCI, navigate to Services → Adblock → Feed Selection, activate the IPFire DBL feed and select the necessary categories. Finally hit Save & Reload to trigger an Adblock reload so the list is downloaded and included in the active blocklist.

IPFire DBL will be automatically updated according to your Adblock refresh schedule.