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 > Privoxy is an associated project of Software in the Public Interest (SPI).
84 HREF="http://www.privoxy.org/faq/general.html#DONATE"
86 >Donations are welcome</A
89 > You can find the latest version of the <I
91 >Privoxy User Manual</I
93 HREF="http://www.privoxy.org/user-manual/"
95 >http://www.privoxy.org/user-manual/</A
101 contact the developers.
113 >Table of Contents</B
117 HREF="introduction.html"
124 HREF="introduction.html#FEATURES"
131 HREF="installation.html"
138 HREF="installation.html#INSTALLATION-PACKAGES"
145 HREF="installation.html#INSTALLATION-PACK-RPM"
146 >Red Hat and Fedora RPMs</A
150 HREF="installation.html#INSTALLATION-DEB"
151 >Debian and Ubuntu</A
155 HREF="installation.html#INSTALLATION-PACK-WIN"
160 HREF="installation.html#INSTALLATION-PACK-BINTGZ"
165 HREF="installation.html#INSTALLATION-OS2"
170 HREF="installation.html#INSTALLATION-MAC"
175 HREF="installation.html#INSTALLATION-AMIGA"
180 HREF="installation.html#INSTALLATION-TBZ"
185 HREF="installation.html#INSTALLATTION-GENTOO"
192 HREF="installation.html#INSTALLATION-SOURCE"
193 >Building from Source</A
197 HREF="installation.html#INSTALLATION-KEEPUPDATED"
198 >Keeping your Installation Up-to-Date</A
205 >What's New in this Release</A
211 HREF="whatsnew.html#UPGRADERSNOTE"
212 >Note to Upgraders</A
218 HREF="quickstart.html"
219 >Quickstart to Using Privoxy</A
225 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
226 >Quickstart to Ad Blocking</A
239 HREF="startup.html#START-REDHAT"
240 >Red Hat and Fedora</A
244 HREF="startup.html#START-DEBIAN"
249 HREF="startup.html#START-WINDOWS"
254 HREF="startup.html#START-UNICES"
255 >Solaris, NetBSD, FreeBSD, HP-UX and others</A
259 HREF="startup.html#START-OS2"
264 HREF="startup.html#START-MACOSX"
269 HREF="startup.html#START-AMIGAOS"
274 HREF="startup.html#START-GENTOO"
279 HREF="startup.html#CMDOPTIONS"
280 >Command Line Options</A
286 HREF="configuration.html"
287 >Privoxy Configuration</A
293 HREF="configuration.html#AEN776"
294 >Controlling Privoxy with Your Web Browser</A
298 HREF="configuration.html#CONFOVERVIEW"
299 >Configuration Files Overview</A
306 >The Main Configuration File</A
312 HREF="config.html#LOCAL-SET-UP"
313 >Local Set-up Documentation</A
319 HREF="config.html#USER-MANUAL"
324 HREF="config.html#TRUST-INFO-URL"
329 HREF="config.html#ADMIN-ADDRESS"
334 HREF="config.html#PROXY-INFO-URL"
341 HREF="config.html#CONF-LOG-LOC"
342 >Configuration and Log File Locations</A
348 HREF="config.html#CONFDIR"
353 HREF="config.html#TEMPLDIR"
358 HREF="config.html#LOGDIR"
363 HREF="config.html#ACTIONSFILE"
368 HREF="config.html#FILTERFILE"
373 HREF="config.html#LOGFILE"
378 HREF="config.html#TRUSTFILE"
385 HREF="config.html#DEBUGGING"
392 HREF="config.html#DEBUG"
397 HREF="config.html#SINGLE-THREADED"
402 HREF="config.html#HOSTNAME"
409 HREF="config.html#ACCESS-CONTROL"
410 >Access Control and Security</A
416 HREF="config.html#LISTEN-ADDRESS"
421 HREF="config.html#TOGGLE"
426 HREF="config.html#ENABLE-REMOTE-TOGGLE"
427 >enable-remote-toggle</A
431 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
432 >enable-remote-http-toggle</A
436 HREF="config.html#ENABLE-EDIT-ACTIONS"
437 >enable-edit-actions</A
441 HREF="config.html#ENFORCE-BLOCKS"
446 HREF="config.html#ACLS"
447 >ACLs: permit-access and deny-access</A
451 HREF="config.html#BUFFER-LIMIT"
458 HREF="config.html#FORWARDING"
465 HREF="config.html#FORWARD"
470 HREF="config.html#SOCKS"
471 >forward-socks4, forward-socks4a and forward-socks5</A
475 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
476 >Advanced Forwarding Examples</A
480 HREF="config.html#FORWARDED-CONNECT-RETRIES"
481 >forwarded-connect-retries</A
485 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
486 >accept-intercepted-requests</A
490 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
491 >allow-cgi-request-crunching</A
495 HREF="config.html#SPLIT-LARGE-FORMS"
496 >split-large-forms</A
500 HREF="config.html#KEEP-ALIVE-TIMEOUT"
501 >keep-alive-timeout</A
505 HREF="config.html#SOCKET-TIMEOUT"
512 HREF="config.html#WINDOWS-GUI"
513 >Windows GUI Options</A
519 HREF="actions-file.html"
526 HREF="actions-file.html#AEN2288"
527 >Finding the Right Mix</A
531 HREF="actions-file.html#AEN2295"
536 HREF="actions-file.html#ACTIONS-APPLY"
537 >How Actions are Applied to Requests</A
541 HREF="actions-file.html#AF-PATTERNS"
548 HREF="actions-file.html#AEN2386"
549 >The Domain Pattern</A
553 HREF="actions-file.html#AEN2462"
558 HREF="actions-file.html#TAG-PATTERN"
565 HREF="actions-file.html#ACTIONS"
572 HREF="actions-file.html#ADD-HEADER"
577 HREF="actions-file.html#BLOCK"
582 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
583 >change-x-forwarded-for</A
587 HREF="actions-file.html#CLIENT-HEADER-FILTER"
588 >client-header-filter</A
592 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
593 >client-header-tagger</A
597 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
598 >content-type-overwrite</A
602 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
603 >crunch-client-header</A
607 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
608 >crunch-if-none-match</A
612 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
613 >crunch-incoming-cookies</A
617 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
618 >crunch-server-header</A
622 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
623 >crunch-outgoing-cookies</A
627 HREF="actions-file.html#DEANIMATE-GIFS"
632 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
633 >downgrade-http-version</A
637 HREF="actions-file.html#FAST-REDIRECTS"
642 HREF="actions-file.html#FILTER"
647 HREF="actions-file.html#FORCE-TEXT-MODE"
652 HREF="actions-file.html#FORWARD-OVERRIDE"
657 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
658 >handle-as-empty-document</A
662 HREF="actions-file.html#HANDLE-AS-IMAGE"
667 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
668 >hide-accept-language</A
672 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
673 >hide-content-disposition</A
677 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
678 >hide-if-modified-since</A
682 HREF="actions-file.html#HIDE-FROM-HEADER"
687 HREF="actions-file.html#HIDE-REFERRER"
692 HREF="actions-file.html#HIDE-USER-AGENT"
697 HREF="actions-file.html#LIMIT-CONNECT"
702 HREF="actions-file.html#PREVENT-COMPRESSION"
703 >prevent-compression</A
707 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
708 >overwrite-last-modified</A
712 HREF="actions-file.html#REDIRECT"
717 HREF="actions-file.html#SERVER-HEADER-FILTER"
718 >server-header-filter</A
722 HREF="actions-file.html#SERVER-HEADER-TAGGER"
723 >server-header-tagger</A
727 HREF="actions-file.html#SESSION-COOKIES-ONLY"
728 >session-cookies-only</A
732 HREF="actions-file.html#SET-IMAGE-BLOCKER"
733 >set-image-blocker</A
737 HREF="actions-file.html#AEN4093"
744 HREF="actions-file.html#ALIASES"
749 HREF="actions-file.html#ACT-EXAMPLES"
750 >Actions Files Tutorial</A
756 HREF="actions-file.html#AEN4157"
761 HREF="actions-file.html#AEN4179"
766 HREF="actions-file.html#AEN4292"
775 HREF="filter-file.html"
782 HREF="filter-file.html#AEN4447"
783 >Filter File Tutorial</A
787 HREF="filter-file.html#PREDEFINED-FILTERS"
788 >The Pre-defined Filters</A
794 HREF="templates.html"
795 >Privoxy's Template Files</A
800 >Contacting the Developers, Bug Reporting and Feature
807 HREF="contact.html#CONTACT-SUPPORT"
812 HREF="contact.html#REPORTING"
813 >Reporting Problems</A
819 HREF="contact.html#CONTACT-ADS"
820 >Reporting Ads or Other Configuration Problems</A
824 HREF="contact.html#CONTACT-BUGS"
831 HREF="contact.html#CONTACT-FEATURE"
832 >Request New Features</A
836 HREF="contact.html#CONTACT-OTHER"
843 HREF="copyright.html"
844 >Privoxy Copyright, License and History</A
850 HREF="copyright.html#AEN4921"
855 HREF="copyright.html#HISTORY"
860 HREF="copyright.html#AUTHORS"
879 HREF="appendix.html#REGEX"
880 >Regular Expressions</A
884 HREF="appendix.html#AEN5174"
885 >Privoxy's Internal Pages</A
891 HREF="appendix.html#BOOKMARKLETS"
898 HREF="appendix.html#CHAIN"
903 HREF="appendix.html#ACTIONSANAT"
904 >Troubleshooting: Anatomy of an Action</A
916 SUMMARY="Footer navigation table"
937 HREF="introduction.html"