@ -129,40 +129,41 @@ A lot of people already use adblocker plugins within their desktop browsers, but
#### Further adblock config options
#### Further adblock config options
* Usually the pre-configured adblock setup works quite well and no manual overrides are needed
* Usually the pre-configured adblock setup works quite well and no manual overrides are needed
* The following options apply to the `global` config section:
* The following options apply to the `global` config section:
* `adb\_enabled` => Main switch to enable/disable adblock service (default: `0`, disabled)
* `adb\_dns` => Select the DNS backend for your environment: `dnsmasq`, `unbound`, `named` or `kresd` (default: `dnsmasq`)
* `adb\_dnsvariant` => Select the blocking variant: `nxdomain` (default, supported by all backends), `null (IPv4)` and `null (IPv4/IPv6)` both options are only supported by `dnsmasq`
* `adb\_fetchutil` => Name of the used download utility: `uclient-fetch`, `wget`, `curl`, `aria2c`, `wget-nossl` or `busybox` (default: `uclient-fetch`)
* `adb\_fetchparm` => Special config options for the download utility (default: not set)
* `adb\_trigger` => Set the startup trigger to a certain interface, to `timed` or to `none` (default: `wan`)
* `adb_enabled` => Main switch to enable/disable adblock service (default: `0`, disabled)
* `adb_dns` => Select the DNS backend for your environment: `dnsmasq`, `unbound`, `named` or `kresd` (default: `dnsmasq`)
* `adb_dnsvariant` => Select the blocking variant: `nxdomain` (default, supported by all backends), `null (IPv4)` and `null (IPv4/IPv6)` both options are only supported by `dnsmasq`
* `adb_fetchutil` => Name of the used download utility: `uclient-fetch`, `wget`, `curl`, `aria2c`, `wget-nossl` or `busybox` (default: `uclient-fetch`)
* `adb_fetchparm` => Special config options for the download utility (default: not set)
* `adb_trigger` => Set the startup trigger to a certain interface, to `timed` or to `none` (default: `wan`)
* The following options apply to the `extra` config section:
* The following options apply to the `extra` config section:
* `adb_nice` => Set the nice level of the adblock process and all sub-processes (int/default: `0`, standard priority)
* `adb_forcedns` => Force DNS requests to local resolver (bool/default: `0`, disabled)
* `adb_maxqueue` => Size of the download queue to handle downloads & list processing in parallel (int/default: `8`)
* `adb_dnsfilereset` => The final DNS blockfile will be purged after DNS backend loading to save storage space (bool/default: `false`, disabled)
* `adb_report` => Enable the background tcpdump gathering process to provide a detailed DNS Query Report (bool/default: `0`, disabled)
* `adb_repdir` => Target directory for DNS related report files generated by tcpdump (default: `/tmp`)
* `adb_backupdir` => Target directory for adblock backups (default: `/tmp`)
* `adb_mail` => Send notification emails in case of a processing errors or if the overall domain count is ≤ 0 (bool/default: `0`, disabled)
* `adb_mreceiver` => Receiver address for adblock notification emails (default: not set)
* The following options could be added via "Additional Field" in LuCI and apply to the `extra` config section as well:
* The following options could be added via "Additional Field" in LuCI and apply to the `extra` config section as well:
* `adb\_dnsdir` => Target directory for the generated blocklist `adb_list.overall` (default: not set, use DNS backend default)
* `adb\_blacklist` => Full path to the static blacklist file (default: `/etc/adblock/adblock.blacklist`)
* `adb\_whitelist` => Full path to the static whitelist file (default: `/etc/adblock/adblock.whitelist`)
* `adb\_triggerdelay` => Additional trigger delay in seconds before adblock processing begins (int/default: `2`)
* `adb\_maxtld` => Disable the tld compression, if the number of blocked domains is greater than this value (int/default: `100000`)
* `adb\_portlist` => Space separated list of fw ports which should be redirected locally (default: `53 853 5353`)
* `adb\_dnsinotify` => Disable adblock triggered restarts and the 'DNS File Reset' for DNS backends with autoload features (bool/default: `false`, disabled)
* `adb\_dnsflush` => Flush DNS cache after adblock processing, i.e. enable the old restart behavior (bool/default: `0`, disabled)
* `adb\_repiface` => Reporting interface used by tcpdump, set to `any` for multiple interfaces (default: `br-lan`)
* `adb\_replisten` => Space separated list of reporting port(s) used by tcpdump (default: `53`)
* `adb\_repchunkcnt` => Report chunk count used by tcpdump (default: `5`)
* `adb\_repchunksize` => Report chunk size used by tcpdump in MB (int/default: `1`)
* `adb_dnsdir` => Target directory for the generated blocklist `adb_list.overall` (default: not set, use DNS backend default)
* `adb_dnsinstance` => set the relevant adblock enabled dnsmasq instance (int/default: '0', first dnsmasq instance)
* `adb_blacklist` => Full path to the static blacklist file (default: `/etc/adblock/adblock.blacklist`)
* `adb_whitelist` => Full path to the static whitelist file (default: `/etc/adblock/adblock.whitelist`)
* `adb_triggerdelay` => Additional trigger delay in seconds before adblock processing begins (int/default: `2`)
* `adb_maxtld` => Disable the tld compression, if the number of blocked domains is greater than this value (int/default: `100000`)
* `adb_portlist` => Space separated list of fw ports which should be redirected locally (default: `53 853 5353`)
* `adb_dnsinotify` => Disable adblock triggered restarts and the 'DNS File Reset' for DNS backends with autoload features (bool/default: `false`, disabled)
* `adb_dnsflush` => Flush DNS cache after adblock processing, i.e. enable the old restart behavior (bool/default: `0`, disabled)
* `adb_repiface` => Reporting interface used by tcpdump, set to `any` for multiple interfaces (default: `br-lan`)
* `adb_replisten` => Space separated list of reporting port(s) used by tcpdump (default: `53`)
* `adb_repchunkcnt` => Report chunk count used by tcpdump (default: `5`)
* `adb_repchunksize` => Report chunk size used by tcpdump in MB (int/default: `1`)