squidguard for Debian
---------------------

*** General ***
 
To use squidGuard, you must 
 * modify /etc/squidguard/squidGuard.conf file, 
 * setup your blacklist files in /var/lib/squidguard/db
 * modify squid.conf file.
 * execute update-squidguard.

*** Squid ***

Modify squid.conf:
The following piece in /etc/squid/squid.conf needs to be set:
     ---
     #  TAG: url_rewrite_program
     #
     url_rewrite_program /usr/bin/squidGuard -c /etc/squidguard/squidGuard.conf

*** Contrib ***

I'm including all the contrib scripts into the main package:

    squidGuardRobot - basically a beta version without documentation 
                 at this time.
    sgclean    - removes redundant entries in domain files and url files. 
    hostbyname - takes a squidGuard domain or url list and does some half
                 harted effort to expand it with the corresponding 
                 IP-addresses

All three scripts are perl scripts. So just take a look at them to find 
out the proper command line arguments and all. I will work on adding 
proper documentation when I can (or when they become available).

There is also a squidGuard.cgi script that you can use.  It's in the
/usr/share/doc/squidguard/examples directory.  I'm leaving it there as
some people may not want to run a separate web server on the same server
as the squid proxy.

*** Blacklists ***

You also need to make sure all your blacklist files are owned by the 
"proxy" user. All these files need to be located under 
/var/lib/squidguard/db.

*** Documentation ***

More (older) documentation can be found in the package squidguard-doc
in the path /usr/share/doc/squidguard-doc/ and also on the web on
http://www.squidguard.org/Doc/.

*** update-squidguard ***

With this script the database for squidguard can be checked and recreated.
Now this script supports a verbose option for testing:

	update-squidguard --verbose

This script also can check for a BDB version change. Then only if the 
BDB version has changed the full database files will be recreated. Use:

	update-squidguard --checkdb

*** squidguard-data ***
 
This new example script (beta version) downloads and extracts the latest
database of www.shallalist.de:

	/usr/share/doc/squidguard/examples/squidguard-data


 -- Joachim Wiedorn <joodebian@joonet.de>  Mon, 30 Aug 2017 23:54:00 +0200
