Privoxy User Manual

By: Privoxy Developers

$Id: user-manual.sgml,v 1.99 2002/04/28 16:59:05 swa Exp $

The user manual gives users information on how to install, configure and use Privoxy.

Privoxy is a web proxy with advanced filtering capabilities for protecting privacy, filtering web page content, managing cookies, controlling access, and removing ads, banners, pop-ups and other obnoxious Internet junk. Privoxy has a very flexible configuration and can be customized to suit individual needs and tastes. Privoxy has application for both stand-alone systems and multi-user networks.

Privoxy is based on Internet Junkbuster (tm).

You can find the latest version of the user manual at http://www.privoxy.org/user-manual/. Please see the Contact section on how to contact the developers.


Table of Contents
1. Introduction
1.1. Features
3. Installation
3.1. Red Hat and SuSE RPMs
3.2. Debian
3.3. Windows
3.4. Solaris, NetBSD, FreeBSD, HP-UX
3.5. OS/2
3.6. Max OSX
3.7. AmigaOS
4. Note to Upgraders
5. Quickstart to Using Privoxy
6. Starting Privoxy
6.1. RedHat and Debian
6.2. SuSE
6.3. Windows
6.4. Solaris, NetBSD, FreeBSD, HP-UX and others
6.5. OS/2
6.6. MAX OSX
6.7. AmigaOS
6.8. Command Line Options
7. Privoxy Configuration
7.1. Controlling Privoxy with Your Web Browser
7.2. Configuration Files Overview
8. The Main Configuration File
8.1. Configuration and Log File Locations
8.1.1. confdir
8.1.2. logdir
8.1.3. actionsfile
8.1.4. filterfile
8.1.5. logfile
8.1.6. jarfile
8.1.7. trustfile
8.1.8. user-manual
8.2. Local Set-up Documentation
8.2.1. trust-info-url
8.2.2. admin-address
8.2.3. proxy-info-url
8.3. Debugging
8.3.1. debug
8.3.2. single-threaded
8.4. Access Control and Security
8.4.1. listen-address
8.4.2. toggle
8.4.3. enable-remote-toggle
8.4.4. enable-edit-actions
8.4.5. ACLs: permit-access and deny-access
8.4.6. buffer-limit
8.5. Forwarding
8.5.1. forward
8.5.2. forward-socks4 and forward-socks4a
8.5.3. Advanced Forwarding Examples
8.6. Windows GUI Options
9. Actions Files
9.1. Finding the Right Mix
9.2. How to Edit
9.3. How Actions are Applied to URLs
9.4. Patterns
9.4.1. The Domain Pattern
9.4.2. The Path Pattern
9.5. Actions
9.5.1. +add-header
9.5.2. +block
9.5.3. +deanimate-gifs
9.5.4. +downgrade-http-version
9.5.5. +fast-redirects
9.5.6. +filter
9.5.7. +hide-forwarded-for-headers
9.5.8. +hide-from-header
9.5.9. +hide-referer
9.5.10. +hide-user-agent
9.5.11. +handle-as-image
9.5.12. +set-image-blocker
9.5.13. +limit-connect
9.5.14. +prevent-compression
9.5.15. +session-cookies-only
9.5.16. +prevent-reading-cookies
9.5.17. +prevent-setting-cookies
9.5.18. +kill-popups
9.5.19. +send-vanilla-wafer
9.5.20. +send-wafer
9.5.21. Summary
9.5.22. Sample Actions Files
9.6. Aliases
10. The Filter File
10.1. The +filter Action
11. Templates
12. Contacting the Developers, Bug Reporting and Feature Requests
12.1. Get Support
12.2. Report bugs
12.3. Request new features
12.4. Report ads or other filter problems
12.5. Other
13. Copyright and History
13.1. Copyright
13.2. History
14. See Also
15. Appendix
15.1. Regular Expressions
15.2. Privoxy's Internal Pages
15.2.1. Bookmarklets
15.3. Chain of Events
15.4. Anatomy of an Action