Dansguardian

From miki
Jump to navigation Jump to search

Reference

Documentation
Install tutorials

Install

Configuration

To reload dansguardian configuration:

sudo service dansguardian force-reload


Fix banned url regex. Edit /etc/dansguardian/lists/bannedregexpurllist
-(sex|fuck|boob|...)+.*(\.jpg|\.wmv|\.mpg|\.mpeg|\.gif|\.mov)
+(sex|fuck|boob|...)+.*(\.jpg|\.wmv|\.mpg|\.mpeg|\.gif|\.mov)$
Hide error message when blocked. Edit file /etc/dansguardian/languages/ukenglish/template.html (or any other language in use)
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html><head>
<title>404 Not Found</title>
</head><body>
<h1>Not Found</h1>
<p>The requested URL was not found on this server.</p>
<hr>
<address>Apache/2.2.22 Server</address>
</body></html>
Disable anti-virus
  • dansguardian can filter content for viruses using clamav.To enable it (see [1], [2])
In dansguardian.conf, uncomment
#contentscanner = '/etc/dansguardian/contentscanners/clamdscan.conf'
In dansguardianf1.conf, adapt line as follow:
disablecontentscan = off
  • To disable it, do the opposite, i.e., comment first line, and set disablecontentscan = on.
Adapt naughtyness_limit if necessary
White-list some sites
  • Add them to /etc/dansguardian/lists/exceptionsitelist (see[4])
  • Site to white-list:
mail.yahoo.com 
mail.yimg.com
... or grey-list some sites
  • There are sites that are still keyword filtered
  • Add them to /etc/dansguardian/lists/greysitelist
Fetch up-to-date black-list
  • From urlblacklist.com
  • Requires to explicit allow / forbid some categories (see [5])
  • ... note that even though list can be easily downloaded, urlblacklist.com is a commercial service (and quite expensive in fact).

Troubleshooting

See log files
  • View /var/log/dansguardian/access.log
  • Search for keywords like *DENIED* — these explains in detail why a page is denied access.
  • More information here
Advanced troubleshooting