You will need a recent version of Python to run adzapper; I have only tested it on version 1.5.2, but any recent version should work. adzapper has only been tested on Linux (RedHat 6.0), and Windows NT 4.0 (SP3), but it should run on Windows 95/98 and also on any Unix variant that can run Python. Please let me know if you have any problems, and if you get adzapper running on a platform not listed here.
Before installing adzapper, you will need to install Python; get it from the Python website download page.
On Windows platforms, you will also need to install Mark Hammond's win32all package. Get Python for Windows and the win32all package at the Python website Windows download page.
To start adzapper, simply type 'adzapper' at a command prompt (or double-click the adzapper.py file if you use Windows). The default port adzapper runs on is 51966; you can set this to a different port by using the command line options. (type 'adzapper -h' to see what options are available.)
Now set your browser's preferences to use a proxy server to connect to the Internet. set the address to the IP address or DNS name of the machine that you are running adzapper on, and set the port for HTTP protocol to port 51966. adzapper does not yet filter HTTPS or FTP.
If you need more detailed instructions on setting your web browser to use a proxy server, see the hints below.
If you want adzapper to re-read the zaplets (because you have edited them), you will need to stop it, then start it again. Under Unix you can also send adzapper a SIGHUP, which accomplishes the same thing.
Under Internet Explorer 4.x, this is set under Internet Options. Select "Internet Options" from the "View" pop-down menu. proxy configuration is done in the "Connection" tab. Make sure the "Access the Internet using a proxy server" checkbox is checked, and fill in the "Address:" field with the IP number or domain name of the computer that adzapper is running on (usually this is the same machine you are surfing the web from, in which case you would enter "localhost" or "127.0.0.1"). enter the port adzapper is running on (normally 51966) in the "Port:" field.
If you use a web browser not mentioned here and would like to contribute directions for using a proxy server, please send them to me at the address below!
PYTHON='/path/to/your/python'
If you get the error 'Address already in use', either adzapper is already running, or the port is in use by another server. To use adzapper with a different port, type "adzapper <port>". For example:
% adzapper 9999adzapper has it's own DNS resolver, since the one inside adzapper is a lot faster than just using the built-in resolver. Because it has its own resolver, adzapper needs to know your local DNS server. It tries to guess this on its own (under Unix by looking in /etc/resolv.conf, and under Windows by looking in the Registry), and if it fails, it uses localhost (127.0.0.1) as a default.
Using localhost as a DNS resolver sometimes works under Unix, but doesn't under Windows, so if you are having problems, this might it. The symptom: you can only contact web sites that you specify using their IP address instead of their DNS name. (i.e., http://10.10.2.3/)
if you encounter problems, try setting the DNS server manually. For example:
% adzapper -n 216.39.128.6zaplets usually live in the zaplets/ directory in the directory where you installed adzapper. If you want to put the zaplets somewhere else, use the -z option to specify another directory. The adzapper configuration file lives in the zaplet directory; to specify a filename other than the default "adzapper.conf", use the -f option.
For information on other options, type "adzapper -h" for help.
http_proxy http://my_proxy_server:9999/If you don't include the port, it will default to 8080.
replacement_gif blue.gif
pid_file /var/run/adzapperd.pid
The syntax for these commands is similar to apache's access control syntax. for instance, to block all requests except from your own machine, use these statements:
order deny,allow deny from all allow from 127.0.0.1
use partial IP addresses to denote network numbers:
order deny, allow deny from all allow from 127. 192.168. 10.
You can change the way that adzapper will check addresses-- by default it is "all that is not expressly permitted is denied". to allow just from some networks, but deny some specific hosts from those networks, use something like this:
order allow,deny allow from 192.168. deny from 192.168.8.55 192.168.7.This would allow access only from any computer in the 192.168.x.y group of addresses, except the host 192.168.8.55 and all computers on the 192.168.7 network.
There is a System-V-style startup script in the 'scripts' directory; you can move this to your /etc/rc.d/init.d directory and use it to add adzapperd to your startup scripts. Note: this script was written for RedHat 6.0, and hasn't been thoroughly tested.
Last Modified: Sat Oct 09 21:21:48 1999