From c614a3950bd55f2b4aacef9def0f70d965178f10 Mon Sep 17 00:00:00 2001 From: Giacomo Sanchietti Date: Thu, 28 May 2026 16:37:16 +0200 Subject: [PATCH 1/4] docs: add adblock troubleshooting guidance --- threat_shield_dns.rst | 46 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/threat_shield_dns.rst b/threat_shield_dns.rst index 1f8cd7be..20a5a8e1 100644 --- a/threat_shield_dns.rst +++ b/threat_shield_dns.rst @@ -24,6 +24,10 @@ When the service is enabled, the ``Blocklist sources`` tab will display all avai You can enable or disable each blocklist by using the switch on the right side of the list. Enabled blocklists will be automatically updated at regular intervals. +.. note:: + + Changes to Adblock feeds and settings can take up to 30 seconds to be applied. + To specify on which zones the service should be active, select them in the ``Force DNS redirection on these zones`` combobox. ``Redirected ports`` allows you to specify which ports should be redirected to Threat shield DNS service. @@ -150,6 +154,48 @@ The output might look like this: This output shows if the domain is currently blocked by any active blocklists. In this specific example, the domain `baddomain.com` is part of the category **adult**, as indicated by ``adb_list.adult.gz``. This helps you identify which category or list caused the domain to be blocked. +.. _adblock_troubleshooting-section: + +Troubleshooting +=============== + +After enabling Adblock or changing its configuration, wait up to 30 seconds for the changes to be applied. +During boot, Adblock also waits around 30 seconds for the network to come up before loading the feeds. + +Use the following command to check whether Adblock is running:: + + /etc/init.d/adblock status + +If the output shows zero blocked domains and no active feeds, Adblock has not loaded anything yet. In that case the status may look like this:: + + ::: adblock runtime information + + adblock_status : enabled + + frontend_ver : 4.5.5-r2 + + backend_ver : 4.5.5-r3 + + blocked_domains : 0 + + active_feeds : - + + dns_backend : dnsmasq (2.91-r3), /tmp/dnsmasq.d, 3.39 MB + + run_ifaces : trigger: -, report: br-lan + + run_information : base: /tmp, dns: /tmp/dnsmasq.d, backup: /tmp/adblock-backup, report: /tmp/adblock-report, error: /tmp/adb_error.log + + run_flags : shift: ✘, custom feed: ✔, ext. DNS (std/prot/remote/bridge): ✘/✘/✘/✘, force: ✔, flush: ✘, tld: ✔, search: ✘, report: ✔, mail: ✘, jail: ✘, debug: ✔ + + last_run : mode: reload, date / time: 28/05/2026 13:44:31, duration: 0m 5s, memory: 3450.30 MB available + + system_info : cores: 2, fetch: wget, Nethesis NethBox Z1+, x86/64, NethSecurity 8.8.0-nethsecurity-8.8.20260528105131.094c098 (r32933-4ccb782af7) + +A correctly loaded system should look like this:: + + ::: adblock runtime information + + adblock_status : enabled + + frontend_ver : 4.5.5-r2 + + backend_ver : 4.5.5-r3 + + blocked_domains : 237 974 + + active_feeds : doh_vpn_tor_proxy gambling, + + dns_backend : dnsmasq (2.91-r3), /tmp/dnsmasq.ns_dnsmasq.d, 19.74 MB + + run_ifaces : trigger: -, report: - + + run_information : base: /tmp, dns: /tmp/dnsmasq.ns_dnsmasq.d, backup: /tmp/adblock-backup, report: /tmp/adblock-report, error: /dev/null + + run_flags : shift: ✘, custom feed: ✔, ext. DNS (std/prot/remote/bridge): ✘/✘/✘/✘, force: ✔, flush: ✘, tld: ✔, search: ✘, report: ✘, mail: ✘, jail: ✘, debug: ✘ + + last_run : mode: reload, date / time: 28/05/2026 14:30:37, duration: 0m 2s, memory: 708.93 MB available + + system_info : cores: 2, fetch: curl, QEMU Standard PC (Q35 + ICH9, 2009), x86/64, NethSecurity 8.8.0-nethsecurity-8.8.20260527151745.8ae1ddcc9 (r32933-4ccb782af7) + .. _advanced_configuration-section: Advanced configuration From 4382b5a519c4abd081ca7994b86a82c0bec562af Mon Sep 17 00:00:00 2001 From: Giacomo Sanchietti Date: Fri, 29 May 2026 07:49:43 +0200 Subject: [PATCH 2/4] Apply suggestion from @gsanchietti --- threat_shield_dns.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/threat_shield_dns.rst b/threat_shield_dns.rst index 20a5a8e1..8eaa5542 100644 --- a/threat_shield_dns.rst +++ b/threat_shield_dns.rst @@ -24,10 +24,6 @@ When the service is enabled, the ``Blocklist sources`` tab will display all avai You can enable or disable each blocklist by using the switch on the right side of the list. Enabled blocklists will be automatically updated at regular intervals. -.. note:: - - Changes to Adblock feeds and settings can take up to 30 seconds to be applied. - To specify on which zones the service should be active, select them in the ``Force DNS redirection on these zones`` combobox. ``Redirected ports`` allows you to specify which ports should be redirected to Threat shield DNS service. From 5e46d4c13db78f685e7f4773014446eeca77b7ba Mon Sep 17 00:00:00 2001 From: Giacomo Sanchietti Date: Fri, 29 May 2026 07:50:53 +0200 Subject: [PATCH 3/4] Apply suggestion from @gsanchietti --- threat_shield_dns.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/threat_shield_dns.rst b/threat_shield_dns.rst index 8eaa5542..87385af6 100644 --- a/threat_shield_dns.rst +++ b/threat_shield_dns.rst @@ -192,6 +192,9 @@ A correctly loaded system should look like this:: + last_run : mode: reload, date / time: 28/05/2026 14:30:37, duration: 0m 2s, memory: 708.93 MB available + system_info : cores: 2, fetch: curl, QEMU Standard PC (Q35 + ICH9, 2009), x86/64, NethSecurity 8.8.0-nethsecurity-8.8.20260527151745.8ae1ddcc9 (r32933-4ccb782af7) +If there were network problems and Adblock could not download any feed, just restart it:: + + /etc/init.d/adblock restart .. _advanced_configuration-section: Advanced configuration From 27ef8cb55805ac7393739b190d2d651447cc352e Mon Sep 17 00:00:00 2001 From: Giacomo Sanchietti Date: Fri, 29 May 2026 07:51:14 +0200 Subject: [PATCH 4/4] Apply suggestion from @gsanchietti --- threat_shield_dns.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/threat_shield_dns.rst b/threat_shield_dns.rst index 87385af6..a27ecc58 100644 --- a/threat_shield_dns.rst +++ b/threat_shield_dns.rst @@ -195,6 +195,7 @@ A correctly loaded system should look like this:: If there were network problems and Adblock could not download any feed, just restart it:: /etc/init.d/adblock restart + .. _advanced_configuration-section: Advanced configuration