1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Privoxy 3.0.14 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.14 User Manual</A
45 HREF="http://www.privoxy.org/"
47 >Privoxy Developers</A
53 >$Id: user-manual.sgml,v 2.111 2009/07/18 18:11:11 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#AEN802"
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
487 HREF="config.html#MISC"
494 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
495 >accept-intercepted-requests</A
499 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
500 >allow-cgi-request-crunching</A
504 HREF="config.html#SPLIT-LARGE-FORMS"
505 >split-large-forms</A
509 HREF="config.html#KEEP-ALIVE-TIMEOUT"
510 >keep-alive-timeout</A
514 HREF="config.html#CONNECTION-SHARING"
515 >connection-sharing</A
519 HREF="config.html#SOCKET-TIMEOUT"
524 HREF="config.html#MAX-CLIENT-CONNECTIONS"
525 >max-client-connections</A
531 HREF="config.html#WINDOWS-GUI"
532 >Windows GUI Options</A
538 HREF="actions-file.html"
545 HREF="actions-file.html#AEN2442"
546 >Finding the Right Mix</A
550 HREF="actions-file.html#AEN2449"
555 HREF="actions-file.html#ACTIONS-APPLY"
556 >How Actions are Applied to Requests</A
560 HREF="actions-file.html#AF-PATTERNS"
567 HREF="actions-file.html#AEN2556"
568 >The Domain Pattern</A
572 HREF="actions-file.html#AEN2632"
577 HREF="actions-file.html#TAG-PATTERN"
584 HREF="actions-file.html#ACTIONS"
591 HREF="actions-file.html#ADD-HEADER"
596 HREF="actions-file.html#BLOCK"
601 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
602 >change-x-forwarded-for</A
606 HREF="actions-file.html#CLIENT-HEADER-FILTER"
607 >client-header-filter</A
611 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
612 >client-header-tagger</A
616 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
617 >content-type-overwrite</A
621 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
622 >crunch-client-header</A
626 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
627 >crunch-if-none-match</A
631 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
632 >crunch-incoming-cookies</A
636 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
637 >crunch-server-header</A
641 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
642 >crunch-outgoing-cookies</A
646 HREF="actions-file.html#DEANIMATE-GIFS"
651 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
652 >downgrade-http-version</A
656 HREF="actions-file.html#FAST-REDIRECTS"
661 HREF="actions-file.html#FILTER"
666 HREF="actions-file.html#FORCE-TEXT-MODE"
671 HREF="actions-file.html#FORWARD-OVERRIDE"
676 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
677 >handle-as-empty-document</A
681 HREF="actions-file.html#HANDLE-AS-IMAGE"
686 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
687 >hide-accept-language</A
691 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
692 >hide-content-disposition</A
696 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
697 >hide-if-modified-since</A
701 HREF="actions-file.html#HIDE-FROM-HEADER"
706 HREF="actions-file.html#HIDE-REFERRER"
711 HREF="actions-file.html#HIDE-USER-AGENT"
716 HREF="actions-file.html#LIMIT-CONNECT"
721 HREF="actions-file.html#PREVENT-COMPRESSION"
722 >prevent-compression</A
726 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
727 >overwrite-last-modified</A
731 HREF="actions-file.html#REDIRECT"
736 HREF="actions-file.html#SERVER-HEADER-FILTER"
737 >server-header-filter</A
741 HREF="actions-file.html#SERVER-HEADER-TAGGER"
742 >server-header-tagger</A
746 HREF="actions-file.html#SESSION-COOKIES-ONLY"
747 >session-cookies-only</A
751 HREF="actions-file.html#SET-IMAGE-BLOCKER"
752 >set-image-blocker</A
756 HREF="actions-file.html#AEN4263"
763 HREF="actions-file.html#ALIASES"
768 HREF="actions-file.html#ACT-EXAMPLES"
769 >Actions Files Tutorial</A
775 HREF="actions-file.html#AEN4327"
780 HREF="actions-file.html#AEN4349"
785 HREF="actions-file.html#AEN4462"
794 HREF="filter-file.html"
801 HREF="filter-file.html#AEN4617"
802 >Filter File Tutorial</A
806 HREF="filter-file.html#PREDEFINED-FILTERS"
807 >The Pre-defined Filters</A
813 HREF="templates.html"
814 >Privoxy's Template Files</A
819 >Contacting the Developers, Bug Reporting and Feature
826 HREF="contact.html#CONTACT-SUPPORT"
831 HREF="contact.html#REPORTING"
832 >Reporting Problems</A
838 HREF="contact.html#CONTACT-ADS"
839 >Reporting Ads or Other Configuration Problems</A
843 HREF="contact.html#CONTACT-BUGS"
850 HREF="contact.html#CONTACT-FEATURE"
851 >Request New Features</A
855 HREF="contact.html#CONTACT-OTHER"
862 HREF="copyright.html"
863 >Privoxy Copyright, License and History</A
869 HREF="copyright.html#AEN5091"
874 HREF="copyright.html#HISTORY"
879 HREF="copyright.html#AUTHORS"
898 HREF="appendix.html#REGEX"
899 >Regular Expressions</A
903 HREF="appendix.html#AEN5344"
904 >Privoxy's Internal Pages</A
910 HREF="appendix.html#BOOKMARKLETS"
917 HREF="appendix.html#CHAIN"
922 HREF="appendix.html#ACTIONSANAT"
923 >Troubleshooting: Anatomy of an Action</A
935 SUMMARY="Footer navigation table"
956 HREF="introduction.html"