1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Privoxy 3.0.16 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.16 User Manual</A
45 HREF="http://www.privoxy.org/"
47 >Privoxy Developers</A
53 >$Id: user-manual.sgml,v 2.116 2009/11/15 14:24:12 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#AEN839"
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#DEFAULT-SERVER-TIMEOUT"
515 >default-server-timeout</A
519 HREF="config.html#CONNECTION-SHARING"
520 >connection-sharing</A
524 HREF="config.html#SOCKET-TIMEOUT"
529 HREF="config.html#MAX-CLIENT-CONNECTIONS"
530 >max-client-connections</A
536 HREF="config.html#WINDOWS-GUI"
537 >Windows GUI Options</A
543 HREF="actions-file.html"
550 HREF="actions-file.html#AEN2518"
551 >Finding the Right Mix</A
555 HREF="actions-file.html#AEN2525"
560 HREF="actions-file.html#ACTIONS-APPLY"
561 >How Actions are Applied to Requests</A
565 HREF="actions-file.html#AF-PATTERNS"
572 HREF="actions-file.html#AEN2632"
573 >The Domain Pattern</A
577 HREF="actions-file.html#AEN2708"
582 HREF="actions-file.html#TAG-PATTERN"
589 HREF="actions-file.html#ACTIONS"
596 HREF="actions-file.html#ADD-HEADER"
601 HREF="actions-file.html#BLOCK"
606 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
607 >change-x-forwarded-for</A
611 HREF="actions-file.html#CLIENT-HEADER-FILTER"
612 >client-header-filter</A
616 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
617 >client-header-tagger</A
621 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
622 >content-type-overwrite</A
626 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
627 >crunch-client-header</A
631 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
632 >crunch-if-none-match</A
636 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
637 >crunch-incoming-cookies</A
641 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
642 >crunch-server-header</A
646 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
647 >crunch-outgoing-cookies</A
651 HREF="actions-file.html#DEANIMATE-GIFS"
656 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
657 >downgrade-http-version</A
661 HREF="actions-file.html#FAST-REDIRECTS"
666 HREF="actions-file.html#FILTER"
671 HREF="actions-file.html#FORCE-TEXT-MODE"
676 HREF="actions-file.html#FORWARD-OVERRIDE"
681 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
682 >handle-as-empty-document</A
686 HREF="actions-file.html#HANDLE-AS-IMAGE"
691 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
692 >hide-accept-language</A
696 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
697 >hide-content-disposition</A
701 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
702 >hide-if-modified-since</A
706 HREF="actions-file.html#HIDE-FROM-HEADER"
711 HREF="actions-file.html#HIDE-REFERRER"
716 HREF="actions-file.html#HIDE-USER-AGENT"
721 HREF="actions-file.html#LIMIT-CONNECT"
726 HREF="actions-file.html#PREVENT-COMPRESSION"
727 >prevent-compression</A
731 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
732 >overwrite-last-modified</A
736 HREF="actions-file.html#REDIRECT"
741 HREF="actions-file.html#SERVER-HEADER-FILTER"
742 >server-header-filter</A
746 HREF="actions-file.html#SERVER-HEADER-TAGGER"
747 >server-header-tagger</A
751 HREF="actions-file.html#SESSION-COOKIES-ONLY"
752 >session-cookies-only</A
756 HREF="actions-file.html#SET-IMAGE-BLOCKER"
757 >set-image-blocker</A
761 HREF="actions-file.html#AEN4339"
768 HREF="actions-file.html#ALIASES"
773 HREF="actions-file.html#ACT-EXAMPLES"
774 >Actions Files Tutorial</A
780 HREF="actions-file.html#AEN4403"
785 HREF="actions-file.html#AEN4425"
790 HREF="actions-file.html#AEN4538"
799 HREF="filter-file.html"
806 HREF="filter-file.html#AEN4693"
807 >Filter File Tutorial</A
811 HREF="filter-file.html#PREDEFINED-FILTERS"
812 >The Pre-defined Filters</A
818 HREF="templates.html"
819 >Privoxy's Template Files</A
824 >Contacting the Developers, Bug Reporting and Feature
831 HREF="contact.html#CONTACT-SUPPORT"
836 HREF="contact.html#REPORTING"
837 >Reporting Problems</A
843 HREF="contact.html#CONTACT-ADS"
844 >Reporting Ads or Other Configuration Problems</A
848 HREF="contact.html#CONTACT-BUGS"
855 HREF="contact.html#CONTACT-FEATURE"
856 >Request New Features</A
860 HREF="contact.html#CONTACT-OTHER"
867 HREF="copyright.html"
868 >Privoxy Copyright, License and History</A
874 HREF="copyright.html#AEN5171"
879 HREF="copyright.html#HISTORY"
884 HREF="copyright.html#AUTHORS"
903 HREF="appendix.html#REGEX"
904 >Regular Expressions</A
908 HREF="appendix.html#AEN5424"
909 >Privoxy's Internal Pages</A
915 HREF="appendix.html#BOOKMARKLETS"
922 HREF="appendix.html#CHAIN"
927 HREF="appendix.html#ACTIONSANAT"
928 >Troubleshooting: Anatomy of an Action</A
940 SUMMARY="Footer navigation table"
961 HREF="introduction.html"