From: Michael Tremer <michael.tremer@ipfire.org>
Date: Tue, 30 Dec 2025 16:22:04 +0000 (+0000)
Subject: dnsbl: Add some simple instructions on how to use the lists
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c1e3fac4617fc01743ef20ea9f5f4a69f19a0fc3;p=ipfire.org.git

dnsbl: Add some simple instructions on how to use the lists

Signed-off-by: Michael Tremer <michael.tremer@ipfire.org>
---

diff --git a/src/templates/base.html b/src/templates/base.html
index 80fa86ca..6f922b12 100644
--- a/src/templates/base.html
+++ b/src/templates/base.html
@@ -104,12 +104,6 @@
 										{{ _("Lists") }}
 									</a>
 
-									<a class="navbar-item is-tab
-											{% if request.path.startswith("/dnsbl/how-to-use") %}is-active{% end %}"
-											href="/dnsbl/how-to-use">
-										{{ _("How To Use?") }}
-									</a>
-
 									<a class="navbar-item is-tab
 											{% if request.path.startswith("/dnsbl/report") %}is-active{% end %}"
 											href="/dnsbl/report">
diff --git a/src/templates/dnsbl/lists/show.html b/src/templates/dnsbl/lists/show.html
index e773a864..551e0f6b 100644
--- a/src/templates/dnsbl/lists/show.html
+++ b/src/templates/dnsbl/lists/show.html
@@ -80,11 +80,125 @@
 		</div>
 	</section>
 
+	{# How To Use? #}
+	<section class="section">
+		<div class="container">
+			<h5 class="title is-5">
+				{{ _("How To Use?") }}
+			</h5>
+
+			<div class="tabs">
+				<ul>
+					<li class="is-active" data-tab="ipfire">
+						<a>{% module IPFireLogo() %}</a>
+					</li>
+
+					<li data-tab="rpz">
+						<a>{{ _("Request Policy Zone (RPZ)") }}</a>
+					</li>
+
+					<li data-tab="alternative">
+						<a>{{ _("Alternative Formats") }}</a>
+					</li>
+				</ul>
+			</div>
+
+			<div id="ipfire" class="tab-content">
+				<div class="content">
+					<p>
+						In IPFire, all blocklists are already included and integrated into the following features:
+					</p>
+
+					<ul>
+						<li>
+							{{ _("URL Filter")}}
+						</li>
+
+						<li>
+							{{ _("Intrusion Prevention System") }}
+						</li>
+					</ul>
+				</div>
+			</div>
+
+			<div id="rpz" class="tab-content is-hidden">
+				<div class="content">
+					<p>
+						The IPFire DNSBL is published as a Response Policy Zone (RPZ) and
+						can be consumed by many popular recursive DNS resolvers.
+					</p>
+
+					<p>
+						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.
+					</p>
+
+					<h6>PowerDNS Recursor</h6>
+
+					<pre>
+recursor:
+&nbsp;&nbsp;rpzs:
+&nbsp;&nbsp;- name: {{ list.slug }}.rpz.ipfire.org
+&nbsp;&nbsp;&nbsp;&nbsp;addresses:
+&nbsp;&nbsp;&nbsp;&nbsp;- 'primary.dnsbl.ipfire.org'</pre>
+
+					<h6>Unbound</h6>
+
+					<pre>
+server:
+&nbsp;&nbsp;module-config: "respip validator iterator"
+
+rpz:
+&nbsp;&nbsp;name: {{ list.slug }}.rpz.ipfire.org
+&nbsp;&nbsp;primary: primary.dnsbl.ipfire.org
+&nbsp;&nbsp;zonefile: /var/cache/unbound/{{ list.slug }}.rpz.ipfire.org.zone</pre>
+				</div>
+			</div>
+
+			<div id="alternative" class="tab-content is-hidden">
+				<div class="content">
+					<p>
+						All IPFire DNSBL lists are also available as downloadable domain and hosts files.
+					</p>
+
+					<p>
+						These formats are intended for setups where the lists are consumed directly,
+						for example by firewalls, filtering proxies, custom tooling, or systems using
+						hosts-file based blocking. The files can be fetched periodically and applied locally.
+					</p>
+				</div>
+
+				<div class="buttons are-small">
+					<a class="button is-primary" href="https://dnsbl.ipfire.org/lists/{{ list.slug }}/domains.txt">
+						<span class="icon">
+							 <i class="fas fa-download"></i>
+						</span>
+
+						<span>
+							{{ _("Domains") }}
+						</span>
+					</a>
+
+					<a class="button is-primary" href="https://dnsbl.ipfire.org/lists/{{ list.slug }}/hosts.txt">
+						<span class="icon">
+							 <i class="fas fa-download"></i>
+						</span>
+
+						<span>
+							{{ _("Hosts") }}
+						</span>
+					</a>
+				</div>
+			</div>
+		</div>
+	</section>
+
 	{# Sources #}
 	{% if sources %}
 		<section class="section">
 			<div class="container">
-				<h3 class="title is-3">{{ _("Sources") }}</h3>
+				<h5 class="title is-5">{{ _("Sources") }}</h5>
 
 				<table class="table is-fullwidth is-striped is-hoverable is-narrow">
 					<thead>