diff --git a/threat_shield_dns.rst b/threat_shield_dns.rst index 1f8cd7be..a27ecc58 100644 --- a/threat_shield_dns.rst +++ b/threat_shield_dns.rst @@ -150,6 +150,52 @@ 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) + +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