1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Privoxy 3.0.17 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.17 User Manual</A
45 HREF="http://www.privoxy.org/"
47 >Privoxy Developers</A
53 >$Id: user-manual.sgml,v 2.128 2010/11/10 22:00:13 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 GNU GPLv2.</P
82 > Privoxy is an associated project of Software in the Public Interest (SPI).</P
84 > Helping hands and donations are welcome:
91 HREF="http://www.privoxy.org/faq/general.html#PARTICIPATE"
93 >http://www.privoxy.org/faq/general.html#PARTICIPATE</A
100 HREF="http://www.privoxy.org/faq/general.html#DONATE"
102 >http://www.privoxy.org/faq/general.html#DONATE</A
109 > You can find the latest version of the <I
111 >Privoxy User Manual</I
113 HREF="http://www.privoxy.org/user-manual/"
115 >http://www.privoxy.org/user-manual/</A
121 contact the developers.
133 >Table of Contents</B
137 HREF="introduction.html"
144 HREF="introduction.html#FEATURES"
151 HREF="installation.html"
158 HREF="installation.html#INSTALLATION-PACKAGES"
165 HREF="installation.html#INSTALLATION-PACK-RPM"
166 >Red Hat and Fedora RPMs</A
170 HREF="installation.html#INSTALLATION-DEB"
171 >Debian and Ubuntu</A
175 HREF="installation.html#INSTALLATION-PACK-WIN"
180 HREF="installation.html#INSTALLATION-PACK-BINTGZ"
185 HREF="installation.html#INSTALLATION-OS2"
190 HREF="installation.html#INSTALLATION-MAC"
195 HREF="installation.html#INSTALLATION-AMIGA"
200 HREF="installation.html#INSTALLATION-TBZ"
205 HREF="installation.html#INSTALLATTION-GENTOO"
212 HREF="installation.html#INSTALLATION-SOURCE"
213 >Building from Source</A
217 HREF="installation.html#INSTALLATION-KEEPUPDATED"
218 >Keeping your Installation Up-to-Date</A
225 >What's New in this Release</A
231 HREF="whatsnew.html#UPGRADERSNOTE"
232 >Note to Upgraders</A
238 HREF="quickstart.html"
239 >Quickstart to Using Privoxy</A
245 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
246 >Quickstart to Ad Blocking</A
259 HREF="startup.html#START-REDHAT"
260 >Red Hat and Fedora</A
264 HREF="startup.html#START-DEBIAN"
269 HREF="startup.html#START-WINDOWS"
274 HREF="startup.html#START-UNICES"
275 >Solaris, NetBSD, FreeBSD, HP-UX and others</A
279 HREF="startup.html#START-OS2"
284 HREF="startup.html#START-MACOSX"
289 HREF="startup.html#START-AMIGAOS"
294 HREF="startup.html#START-GENTOO"
299 HREF="startup.html#CMDOPTIONS"
300 >Command Line Options</A
306 HREF="configuration.html"
307 >Privoxy Configuration</A
313 HREF="configuration.html#AEN921"
314 >Controlling Privoxy with Your Web Browser</A
318 HREF="configuration.html#CONFOVERVIEW"
319 >Configuration Files Overview</A
326 >The Main Configuration File</A
332 HREF="config.html#LOCAL-SET-UP"
333 >Local Set-up Documentation</A
339 HREF="config.html#USER-MANUAL"
344 HREF="config.html#TRUST-INFO-URL"
349 HREF="config.html#ADMIN-ADDRESS"
354 HREF="config.html#PROXY-INFO-URL"
361 HREF="config.html#CONF-LOG-LOC"
362 >Configuration and Log File Locations</A
368 HREF="config.html#CONFDIR"
373 HREF="config.html#TEMPLDIR"
378 HREF="config.html#LOGDIR"
383 HREF="config.html#ACTIONSFILE"
388 HREF="config.html#FILTERFILE"
393 HREF="config.html#LOGFILE"
398 HREF="config.html#TRUSTFILE"
405 HREF="config.html#DEBUGGING"
412 HREF="config.html#DEBUG"
417 HREF="config.html#SINGLE-THREADED"
422 HREF="config.html#HOSTNAME"
429 HREF="config.html#ACCESS-CONTROL"
430 >Access Control and Security</A
436 HREF="config.html#LISTEN-ADDRESS"
441 HREF="config.html#TOGGLE"
446 HREF="config.html#ENABLE-REMOTE-TOGGLE"
447 >enable-remote-toggle</A
451 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
452 >enable-remote-http-toggle</A
456 HREF="config.html#ENABLE-EDIT-ACTIONS"
457 >enable-edit-actions</A
461 HREF="config.html#ENFORCE-BLOCKS"
466 HREF="config.html#ACLS"
467 >ACLs: permit-access and deny-access</A
471 HREF="config.html#BUFFER-LIMIT"
478 HREF="config.html#FORWARDING"
485 HREF="config.html#FORWARD"
490 HREF="config.html#SOCKS"
491 >forward-socks4, forward-socks4a and forward-socks5</A
495 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
496 >Advanced Forwarding Examples</A
500 HREF="config.html#FORWARDED-CONNECT-RETRIES"
501 >forwarded-connect-retries</A
507 HREF="config.html#MISC"
514 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
515 >accept-intercepted-requests</A
519 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
520 >allow-cgi-request-crunching</A
524 HREF="config.html#SPLIT-LARGE-FORMS"
525 >split-large-forms</A
529 HREF="config.html#KEEP-ALIVE-TIMEOUT"
530 >keep-alive-timeout</A
534 HREF="config.html#DEFAULT-SERVER-TIMEOUT"
535 >default-server-timeout</A
539 HREF="config.html#CONNECTION-SHARING"
540 >connection-sharing</A
544 HREF="config.html#SOCKET-TIMEOUT"
549 HREF="config.html#MAX-CLIENT-CONNECTIONS"
550 >max-client-connections</A
554 HREF="config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK"
555 >handle-as-empty-doc-returns-ok</A
561 HREF="config.html#WINDOWS-GUI"
562 >Windows GUI Options</A
568 HREF="actions-file.html"
575 HREF="actions-file.html#AEN2633"
576 >Finding the Right Mix</A
580 HREF="actions-file.html#AEN2640"
585 HREF="actions-file.html#ACTIONS-APPLY"
586 >How Actions are Applied to Requests</A
590 HREF="actions-file.html#AF-PATTERNS"
597 HREF="actions-file.html#AEN2752"
598 >The Domain Pattern</A
602 HREF="actions-file.html#AEN2828"
607 HREF="actions-file.html#TAG-PATTERN"
614 HREF="actions-file.html#ACTIONS"
621 HREF="actions-file.html#ADD-HEADER"
626 HREF="actions-file.html#BLOCK"
631 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
632 >change-x-forwarded-for</A
636 HREF="actions-file.html#CLIENT-HEADER-FILTER"
637 >client-header-filter</A
641 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
642 >client-header-tagger</A
646 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
647 >content-type-overwrite</A
651 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
652 >crunch-client-header</A
656 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
657 >crunch-if-none-match</A
661 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
662 >crunch-incoming-cookies</A
666 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
667 >crunch-server-header</A
671 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
672 >crunch-outgoing-cookies</A
676 HREF="actions-file.html#DEANIMATE-GIFS"
681 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
682 >downgrade-http-version</A
686 HREF="actions-file.html#FAST-REDIRECTS"
691 HREF="actions-file.html#FILTER"
696 HREF="actions-file.html#FORCE-TEXT-MODE"
701 HREF="actions-file.html#FORWARD-OVERRIDE"
706 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
707 >handle-as-empty-document</A
711 HREF="actions-file.html#HANDLE-AS-IMAGE"
716 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
717 >hide-accept-language</A
721 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
722 >hide-content-disposition</A
726 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
727 >hide-if-modified-since</A
731 HREF="actions-file.html#HIDE-FROM-HEADER"
736 HREF="actions-file.html#HIDE-REFERRER"
741 HREF="actions-file.html#HIDE-USER-AGENT"
746 HREF="actions-file.html#LIMIT-CONNECT"
751 HREF="actions-file.html#PREVENT-COMPRESSION"
752 >prevent-compression</A
756 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
757 >overwrite-last-modified</A
761 HREF="actions-file.html#REDIRECT"
766 HREF="actions-file.html#SERVER-HEADER-FILTER"
767 >server-header-filter</A
771 HREF="actions-file.html#SERVER-HEADER-TAGGER"
772 >server-header-tagger</A
776 HREF="actions-file.html#SESSION-COOKIES-ONLY"
777 >session-cookies-only</A
781 HREF="actions-file.html#SET-IMAGE-BLOCKER"
782 >set-image-blocker</A
786 HREF="actions-file.html#AEN4460"
793 HREF="actions-file.html#ALIASES"
798 HREF="actions-file.html#ACT-EXAMPLES"
799 >Actions Files Tutorial</A
805 HREF="actions-file.html#AEN4524"
810 HREF="actions-file.html#AEN4546"
815 HREF="actions-file.html#AEN4659"
824 HREF="filter-file.html"
831 HREF="filter-file.html#AEN4814"
832 >Filter File Tutorial</A
836 HREF="filter-file.html#PREDEFINED-FILTERS"
837 >The Pre-defined Filters</A
843 HREF="templates.html"
844 >Privoxy's Template Files</A
849 >Contacting the Developers, Bug Reporting and Feature
856 HREF="contact.html#CONTACT-SUPPORT"
861 HREF="contact.html#REPORTING"
862 >Reporting Problems</A
868 HREF="contact.html#CONTACT-ADS"
869 >Reporting Ads or Other Configuration Problems</A
873 HREF="contact.html#CONTACT-BUGS"
880 HREF="contact.html#CONTACT-FEATURE"
881 >Request New Features</A
885 HREF="contact.html#MAILING-LISTS"
892 HREF="copyright.html"
893 >Privoxy Copyright, License and History</A
899 HREF="copyright.html#AEN5293"
904 HREF="copyright.html#HISTORY"
909 HREF="copyright.html#AUTHORS"
928 HREF="appendix.html#REGEX"
929 >Regular Expressions</A
933 HREF="appendix.html#AEN5546"
934 >Privoxy's Internal Pages</A
940 HREF="appendix.html#BOOKMARKLETS"
947 HREF="appendix.html#CHAIN"
952 HREF="appendix.html#ACTIONSANAT"
953 >Troubleshooting: Anatomy of an Action</A
965 SUMMARY="Footer navigation table"
986 HREF="introduction.html"