Site Tools


advanced-adblock

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
advanced-adblock [2023/08/06 18:05] – [Domain whitelist] -clarity, formatting hogwildadvanced-adblock [2023/08/13 17:03] (current) – [Domain whitelist] -formatting hogwild
Line 3: Line 3:
 This menu contains settings to configure FreshTomato's ad blocker. It is strongly advised that you read the **How Adblock Works** section to understand its functioning, even if you use v2. This menu contains settings to configure FreshTomato's ad blocker. It is strongly advised that you read the **How Adblock Works** section to understand its functioning, even if you use v2.
  
-In this documentation, the function/menu will be spelled capitalized ("Adblock"). The script that executes will be spelled in lower case ("adblock"). \\+In documentation, the function/menu will be spelled capitalized ("Adblock"). The actual script will be spelled "adblock", in lower case. \\ 
  
 ===== v1 and v2 ===== ===== v1 and v2 =====
Line 70: Line 71:
  \\  \\
  
-A good way to view the logs is to go to the [[status-log|Logs]] menu and enter 'adblockin the "Find in syslog" field. This filters the log view to show only adblock entries. At level 7, adblock produces additional debugging files. These files are saved in /tmp/adblock.debug.$now, (where "$now" is the absolute number of seconds elapsed). References to adblock in the the trace file will then be displayed in the Web interface.\\  \\+A good way to view Adblock log entries is to go to the [[status-log|Logs]] menu and type "adblockin the "Find in syslog" field. This filters the view to show only adblock entries. When set to level 7, adblock produces additional debugging files. These files are saved in /tmp/adblock.debug.$now, (where "$now" is the absolute number of seconds elapsed). References to adblock in the the trace file will then be displayed in the Web interface.\\  \\
  
  {{::20230125-163305.png?776x296|Viewing adblock log entries}}\\  \\  {{::20230125-163305.png?776x296|Viewing adblock log entries}}\\  \\
Line 84: Line 85:
  \\  \\
  
-This limit is calculated as 10% of physical RAM (when external storage is set). When no external storage is found, the limit is calculated as 6.5% of RAM. The limit can be also manually configured. However, if your device becomes unstable, it is advised that you revert to the auto-calculated value.+This limit is calculated as 10% of physical RAM (when external storage is set). When no external storage is found, the limit is calculated as 6.5% of RAM. The limit can be also manually configured. However, if your device becomes unstable, you should revert to the auto-calculated value.
  
-To be clear, this is a limit, not a target. There's nothing wrong with having a small blockfile compared to the limit. A larger blockfile will result in longer restart times for the dnsmasq service. This is important because there will be no DHCP/DNS/TFTP functionality until dnsmasq finishes restarting.+This is a limit, not a target. There's nothing wrong with having a small blockfile compared to the limit. A larger blockfile will result in longer restart times for the dnsmasq service. This is important because there will be no DHCP/DNS/TFTP functionality until dnsmasq finishes restarting.
  
  \\  \\
Line 114: Line 115:
 This saves time and resources. This saves time and resources.
  
-Here, configuration means any externally-mapped files where //blacklist_custom// or whitelists are defined (For example: /mnt/USB/my_whitelist.txt). Using a Custom path also allows adblock to load faster on post-(re)boot.+Here, "configurationmeans any externally-mapped files where //blacklist_custom// or whitelists are defined (For example: /mnt/USB/my_whitelist.txt). Using a Custom path also allows adblock to load faster on post-(re)boot.
  
  \\  \\
Line 217: Line 218:
 For example, if you enter "+sub.domain.com", only "sub.domain.com" will be blacklisted. "Sub1.sub.domain.com", "sub2.sub.domain.com" and other subdomains will not be filtered. For example, if you enter "+sub.domain.com", only "sub.domain.com" will be blacklisted. "Sub1.sub.domain.com", "sub2.sub.domain.com" and other subdomains will not be filtered.
  
-Prepending a "+" sign to a domain will also force a pruning of any subdomains found in the final blockfile. Pruning removes duplicate/redundant blocklist entries. +Prepending a "+" sign to a domain will also force a pruning of any subdomains found in the final blockfile. Pruning removes duplicate/redundant blocklist entries. Duplicate entries make for a larger blockfile size, which can increase processor cycles, RAM usage and storage space. Thus, pruning significant number of duplicated entries can reduce CPU, memory and storage needs.
- +
-Duplicate or redundant entries make for a larger blockfile size, which can increase processor cycles, RAM usage and storage space. Thus, pruning significant amounts of redundant entries can reduce CPU, memory and storage needs.+
  
 Any line starting with a "#" or "!" character is considered a comment and will be ignored. Any line starting with a "#" or "!" character is considered a comment and will be ignored.
 +
 + \\
  
 **Sort a-z ↓** **:**  Clicking this button sorts the contents of this field alphabetically.  \\ **Sort a-z ↓** **:**  Clicking this button sorts the contents of this field alphabetically.  \\
Line 248: Line 249:
 If you whitelist: "sub.domain.com", then: If you whitelist: "sub.domain.com", then:
  
-  "sub1.sub.domain.com"+ "sub1.sub.domain.com"
  
-  "sub2.sub.domain.com"+ "sub2.sub.domain.com"
  
 and all other subdomains will be whitelisted. and all other subdomains will be whitelisted.
Line 256: Line 257:
  \\  \\
  
-However, you can prevent subdomains of an entry from being whitelisted by prepending a "%" sign to an entry.+You can prevent subdomains of an entry from being whitelisted by prepending a "%" sign to an entry.
  
-For example, if you enter "%sub.domain.com", only "sub.domain.com" will be whitelisted. Subdomains, such as "Sub1.sub.domain.com", and "sub2.sub.domain.com" will still be blocked.+For example, if you enter "%sub.domain.com":
  
-Prepending a "%" sign to a domain entry will also force a pruning of any subdomains found in the final blockfilePruning removes duplicate/redundant entries from the blocklist fileDuplicate or redundant entries can increase processor and RAM usageThuspruning significant amounts of redundant entries can reduce CPU, memory and storage usage.+"sub.domain.com" will be whitelisted, but; 
 + 
 +"Sub1.sub.domain.com", and "sub2.sub.domain.com" will still be blocked.
  
 Any line starting with a "#" or "!" character is considered a comment and will be ignored. Any line starting with a "#" or "!" character is considered a comment and will be ignored.
  
- \\+ \\ **Sort a-z ↓** :  Clicking this button sorts the field contents alphabetically.
  
-**Sort a-z ↓** :  Clicking this button sorts the field contents alphabetically.+ \\
  
 === Maintaining the Domain whitelist === === Maintaining the Domain whitelist ===
advanced-adblock.1691341540.txt.gz · Last modified: 2023/08/06 18:05 by hogwild