EBL Squid Redirector 0.1

EBL Squid Redirector project is a very fast and light weight language that is available on every GNU/Linux distribution and BSDs

  Add it to your Download Basket!

 Add it to your Watch List!


Rate it!
send us
an update
GPL (GNU General Public License) 
3.0/5 1
Enterprise Blacklist Project
ROOT \ Utilities
EBL Squid Redirector project is a very fast and light weight language that is available on every GNU/Linux distribution and BSDs.

Querying EBL's server for blacklisted domains and URLs is very convenient: changes on the blacklist entries are immediately available when they happen, including new entries or category changes. It is not necessary any more to worry if your files are updated with the latest release of a big compressed file.
There is a small document that describes how to use the API here.

Although, the added delay for the requests are minimum and not even noticeable. Using a small cache for the requests, EBL Squid redirector will not impact at all, and your users will not notice any difference.


After extracting the files, run this commands, as root:

# python setup.py install --install-scripts /usr/sbin --install-data /etc/squid
. (installation running)

If you got this error: invalid Python installation: unable to open /usr/lib/python2.3/config/Makefile (No such file or directory), on some Linux systems, notably Debian Sarge and older Debian based systems, you'll need to have the python-dev package installed in order to be able to install.
Use the install parameters to choose the best location on your file system:
The --install-scripts parameter is used to copy the main executable.
The --install-data parameter is used to copy the configuration file.
We recommend use /usr/sbin and /etc/squid.
Make sure that the main executable is in a location listed by the $PATH environment variable.
Now we have to setup your authentication key, without it you will not be able to query EBL.
Open the file ebl-redirector.conf with your favorite editor, set the variable username with the username that you have registered on EBL.
Run the following command:
# ebl-redirector.py -p password

The program will print on screen your authentication key, get it and set the variable authkey in ebl-redirector.conf. Make sure that your password is correct, otherwise the authkey will be wrong. Check the other variables and adjust them for your needs. Notice that your password is just used to generate the authentication key and not stored or sent over the network.

By default, the configuration file will be searched on /etc/squid/ebl-redirector.conf. If you are using a different location, you have to provide the path using the parameter -c /path/to/config.file .

Make sure that you have correctly set the logging parameters on the configuration file, otherwise you will not see any log, and diagnosing problems will be very hard.

Configuring Squid

Squid version 2.6 changed the parameters for configuring redirectors, although it is very similar to previous version 2.5. We do not support the new multi-thread protocol for redirectors/rewriters yet, so do not change the parameter url_rewrite_concurrency from its default value of 0.

For Squid 2.5:

redirect_program /usr/sbin/ebl-redirector.py
redirect_children 5

For Squid 2.6
url_rewrite_program /usr/sbin/ebl-redirector.py
url_rewrite_children 5

Remember that the redirector will look for /etc/squid/ebl-redirector.conf by default, if you are using a different location, specify it with the -c parameter.
Restart Squid and you are ready to go! Follow the logs and in case of any problem, contact us on our forum.


For a better experience, it is fundamental that you use the whitelist feature that our redirector offers. Put in the whitelist the most common domains that your users browse. It is a fact that users go to the same web sites every day, so doing that you will save yourself a lot of useless queries, and not overload the server with repetitive requests.

Make sure to effectively use the cache system too, setting it to at least 1000 entries and an expiration time of 4 hours.

Last updated on June 8th, 2007

#squid redirector #blacklisted domains #blacklisted URLs #EBL #squid #redirector #blacklisted

Add your review!