1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Privoxy 3.0.12 User Manual</TITLE
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
11 HREF="introduction.html"><LINK
14 HREF="../p_doc.css"><META
15 HTTP-EQUIV="Content-Type"
18 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
35 >Privoxy 3.0.12 User Manual</A
45 HREF="http://www.privoxy.org/"
47 >Privoxy Developers</A
53 >$Id: user-manual.sgml,v 2.103 2009/03/21 10:49:05 fabiankeil Exp $<BR></P
65 >Privoxy User Manual</I
66 > gives users information on how to
67 install, configure and use <A
68 HREF="http://www.privoxy.org/"
74 > Privoxy is a non-caching web proxy with advanced filtering capabilities
75 for enhancing privacy, modifying web page data and HTTP headers, controlling
76 access, and removing ads and other obnoxious Internet junk. Privoxy has a
77 flexible configuration and can be customized to suit individual needs and tastes.
78 It has application for both stand-alone systems and multi-user networks.</P
80 > Privoxy is Free Software and licensed under the GPL2.</P
82 > You can find the latest version of the <I
84 >Privoxy User Manual</I
86 HREF="http://www.privoxy.org/user-manual/"
88 >http://www.privoxy.org/user-manual/</A
94 contact the developers.
106 >Table of Contents</B
110 HREF="introduction.html"
117 HREF="introduction.html#FEATURES"
124 HREF="installation.html"
131 HREF="installation.html#INSTALLATION-PACKAGES"
138 HREF="installation.html#INSTALLATION-PACK-RPM"
139 >Red Hat and Fedora RPMs</A
143 HREF="installation.html#INSTALLATION-DEB"
144 >Debian and Ubuntu</A
148 HREF="installation.html#INSTALLATION-PACK-WIN"
153 HREF="installation.html#INSTALLATION-PACK-BINTGZ"
158 HREF="installation.html#INSTALLATION-OS2"
163 HREF="installation.html#INSTALLATION-MAC"
168 HREF="installation.html#INSTALLATION-AMIGA"
173 HREF="installation.html#INSTALLATION-TBZ"
178 HREF="installation.html#INSTALLATTION-GENTOO"
185 HREF="installation.html#INSTALLATION-SOURCE"
186 >Building from Source</A
190 HREF="installation.html#INSTALLATION-KEEPUPDATED"
191 >Keeping your Installation Up-to-Date</A
198 >What's New in this Release</A
204 HREF="whatsnew.html#UPGRADERSNOTE"
205 >Note to Upgraders</A
211 HREF="quickstart.html"
212 >Quickstart to Using Privoxy</A
218 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
219 >Quickstart to Ad Blocking</A
232 HREF="startup.html#START-REDHAT"
233 >Red Hat and Fedora</A
237 HREF="startup.html#START-DEBIAN"
242 HREF="startup.html#START-WINDOWS"
247 HREF="startup.html#START-UNICES"
248 >Solaris, NetBSD, FreeBSD, HP-UX and others</A
252 HREF="startup.html#START-OS2"
257 HREF="startup.html#START-MACOSX"
262 HREF="startup.html#START-AMIGAOS"
267 HREF="startup.html#START-GENTOO"
272 HREF="startup.html#CMDOPTIONS"
273 >Command Line Options</A
279 HREF="configuration.html"
280 >Privoxy Configuration</A
286 HREF="configuration.html#AEN774"
287 >Controlling Privoxy with Your Web Browser</A
291 HREF="configuration.html#CONFOVERVIEW"
292 >Configuration Files Overview</A
299 >The Main Configuration File</A
305 HREF="config.html#LOCAL-SET-UP"
306 >Local Set-up Documentation</A
312 HREF="config.html#USER-MANUAL"
317 HREF="config.html#TRUST-INFO-URL"
322 HREF="config.html#ADMIN-ADDRESS"
327 HREF="config.html#PROXY-INFO-URL"
334 HREF="config.html#CONF-LOG-LOC"
335 >Configuration and Log File Locations</A
341 HREF="config.html#CONFDIR"
346 HREF="config.html#TEMPLDIR"
351 HREF="config.html#LOGDIR"
356 HREF="config.html#ACTIONSFILE"
361 HREF="config.html#FILTERFILE"
366 HREF="config.html#LOGFILE"
371 HREF="config.html#TRUSTFILE"
378 HREF="config.html#DEBUGGING"
385 HREF="config.html#DEBUG"
390 HREF="config.html#SINGLE-THREADED"
395 HREF="config.html#HOSTNAME"
402 HREF="config.html#ACCESS-CONTROL"
403 >Access Control and Security</A
409 HREF="config.html#LISTEN-ADDRESS"
414 HREF="config.html#TOGGLE"
419 HREF="config.html#ENABLE-REMOTE-TOGGLE"
420 >enable-remote-toggle</A
424 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
425 >enable-remote-http-toggle</A
429 HREF="config.html#ENABLE-EDIT-ACTIONS"
430 >enable-edit-actions</A
434 HREF="config.html#ENFORCE-BLOCKS"
439 HREF="config.html#ACLS"
440 >ACLs: permit-access and deny-access</A
444 HREF="config.html#BUFFER-LIMIT"
451 HREF="config.html#FORWARDING"
458 HREF="config.html#FORWARD"
463 HREF="config.html#SOCKS"
464 >forward-socks4, forward-socks4a and forward-socks5</A
468 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
469 >Advanced Forwarding Examples</A
473 HREF="config.html#FORWARDED-CONNECT-RETRIES"
474 >forwarded-connect-retries</A
478 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
479 >accept-intercepted-requests</A
483 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
484 >allow-cgi-request-crunching</A
488 HREF="config.html#SPLIT-LARGE-FORMS"
489 >split-large-forms</A
493 HREF="config.html#KEEP-ALIVE-TIMEOUT"
494 >keep-alive-timeout</A
498 HREF="config.html#SOCKET-TIMEOUT"
505 HREF="config.html#WINDOWS-GUI"
506 >Windows GUI Options</A
512 HREF="actions-file.html"
519 HREF="actions-file.html#AEN2286"
520 >Finding the Right Mix</A
524 HREF="actions-file.html#AEN2293"
529 HREF="actions-file.html#ACTIONS-APPLY"
530 >How Actions are Applied to Requests</A
534 HREF="actions-file.html#AF-PATTERNS"
541 HREF="actions-file.html#AEN2384"
542 >The Domain Pattern</A
546 HREF="actions-file.html#AEN2460"
551 HREF="actions-file.html#TAG-PATTERN"
558 HREF="actions-file.html#ACTIONS"
565 HREF="actions-file.html#ADD-HEADER"
570 HREF="actions-file.html#BLOCK"
575 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
576 >change-x-forwarded-for</A
580 HREF="actions-file.html#CLIENT-HEADER-FILTER"
581 >client-header-filter</A
585 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
586 >client-header-tagger</A
590 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
591 >content-type-overwrite</A
595 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
596 >crunch-client-header</A
600 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
601 >crunch-if-none-match</A
605 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
606 >crunch-incoming-cookies</A
610 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
611 >crunch-server-header</A
615 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
616 >crunch-outgoing-cookies</A
620 HREF="actions-file.html#DEANIMATE-GIFS"
625 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
626 >downgrade-http-version</A
630 HREF="actions-file.html#FAST-REDIRECTS"
635 HREF="actions-file.html#FILTER"
640 HREF="actions-file.html#FORCE-TEXT-MODE"
645 HREF="actions-file.html#FORWARD-OVERRIDE"
650 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
651 >handle-as-empty-document</A
655 HREF="actions-file.html#HANDLE-AS-IMAGE"
660 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
661 >hide-accept-language</A
665 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
666 >hide-content-disposition</A
670 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
671 >hide-if-modified-since</A
675 HREF="actions-file.html#HIDE-FROM-HEADER"
680 HREF="actions-file.html#HIDE-REFERRER"
685 HREF="actions-file.html#HIDE-USER-AGENT"
690 HREF="actions-file.html#LIMIT-CONNECT"
695 HREF="actions-file.html#PREVENT-COMPRESSION"
696 >prevent-compression</A
700 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
701 >overwrite-last-modified</A
705 HREF="actions-file.html#REDIRECT"
710 HREF="actions-file.html#SERVER-HEADER-FILTER"
711 >server-header-filter</A
715 HREF="actions-file.html#SERVER-HEADER-TAGGER"
716 >server-header-tagger</A
720 HREF="actions-file.html#SESSION-COOKIES-ONLY"
721 >session-cookies-only</A
725 HREF="actions-file.html#SET-IMAGE-BLOCKER"
726 >set-image-blocker</A
730 HREF="actions-file.html#AEN4091"
737 HREF="actions-file.html#ALIASES"
742 HREF="actions-file.html#ACT-EXAMPLES"
743 >Actions Files Tutorial</A
749 HREF="actions-file.html#AEN4155"
754 HREF="actions-file.html#AEN4177"
759 HREF="actions-file.html#AEN4290"
768 HREF="filter-file.html"
775 HREF="filter-file.html#AEN4445"
776 >Filter File Tutorial</A
780 HREF="filter-file.html#PREDEFINED-FILTERS"
781 >The Pre-defined Filters</A
787 HREF="templates.html"
788 >Privoxy's Template Files</A
793 >Contacting the Developers, Bug Reporting and Feature
800 HREF="contact.html#CONTACT-SUPPORT"
805 HREF="contact.html#REPORTING"
806 >Reporting Problems</A
812 HREF="contact.html#CONTACT-ADS"
813 >Reporting Ads or Other Configuration Problems</A
817 HREF="contact.html#CONTACT-BUGS"
824 HREF="contact.html#CONTACT-FEATURE"
825 >Request New Features</A
829 HREF="contact.html#CONTACT-OTHER"
836 HREF="copyright.html"
837 >Privoxy Copyright, License and History</A
843 HREF="copyright.html#AEN4919"
848 HREF="copyright.html#HISTORY"
853 HREF="copyright.html#AUTHORS"
872 HREF="appendix.html#REGEX"
873 >Regular Expressions</A
877 HREF="appendix.html#AEN5172"
878 >Privoxy's Internal Pages</A
884 HREF="appendix.html#BOOKMARKLETS"
891 HREF="appendix.html#CHAIN"
896 HREF="appendix.html#ACTIONSANAT"
897 >Troubleshooting: Anatomy of an Action</A
909 SUMMARY="Footer navigation table"
930 HREF="introduction.html"