1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Privoxy 3.0.27 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.27 User Manual</A
45 HREF="https://www.privoxy.org/"
47 >Privoxy Developers</A
53 >$Id: user-manual.sgml,v 2.221 2017/05/20 09:27:54 fabiankeil Exp $<BR></P
65 >Privoxy User Manual</I
66 > gives users information on how to
67 install, configure and use <A
68 HREF="https://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="https://www.privoxy.org/faq/general.html#PARTICIPATE"
93 >https://www.privoxy.org/faq/general.html#PARTICIPATE</A
100 HREF="https://www.privoxy.org/faq/general.html#DONATE"
102 >https://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="https://www.privoxy.org/user-manual/"
115 >https://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-DEB"
166 >Debian and Ubuntu</A
170 HREF="installation.html#INSTALLATION-PACK-WIN"
175 HREF="installation.html#INSTALLATION-OS2"
180 HREF="installation.html#INSTALLATION-MAC"
185 HREF="installation.html#OS-X-INSTALL-FROM-PACKAGE"
186 >Installation from ready-built package</A
190 HREF="installation.html#OS-X-INSTALL-FROM-SOURCE"
191 >Installation from source</A
195 HREF="installation.html#INSTALLATION-FREEBSD"
202 HREF="installation.html#INSTALLATION-SOURCE"
203 >Building from Source</A
207 HREF="installation.html#INSTALLATION-KEEPUPDATED"
208 >Keeping your Installation Up-to-Date</A
215 >What's New in this Release</A
221 HREF="whatsnew.html#UPGRADERSNOTE"
222 >Note to Upgraders</A
228 HREF="quickstart.html"
229 >Quickstart to Using Privoxy</A
235 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
236 >Quickstart to Ad Blocking</A
249 HREF="startup.html#START-DEBIAN"
254 HREF="startup.html#START-FREEBSD"
255 >FreeBSD and ElectroBSD</A
259 HREF="startup.html#START-WINDOWS"
264 HREF="startup.html#START-UNICES"
265 >Generic instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</A
269 HREF="startup.html#START-OS2"
274 HREF="startup.html#START-MACOSX"
279 HREF="startup.html#CMDOPTIONS"
280 >Command Line Options</A
286 HREF="configuration.html"
287 >Privoxy Configuration</A
293 HREF="configuration.html#CONTROL-WITH-WEBBROWSER"
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#TEMPORARY-DIRECTORY"
359 >temporary-directory</A
363 HREF="config.html#LOGDIR"
368 HREF="config.html#ACTIONSFILE"
373 HREF="config.html#FILTERFILE"
378 HREF="config.html#LOGFILE"
383 HREF="config.html#TRUSTFILE"
390 HREF="config.html#DEBUGGING"
397 HREF="config.html#DEBUG"
402 HREF="config.html#SINGLE-THREADED"
407 HREF="config.html#HOSTNAME"
414 HREF="config.html#ACCESS-CONTROL"
415 >Access Control and Security</A
421 HREF="config.html#LISTEN-ADDRESS"
426 HREF="config.html#TOGGLE"
431 HREF="config.html#ENABLE-REMOTE-TOGGLE"
432 >enable-remote-toggle</A
436 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
437 >enable-remote-http-toggle</A
441 HREF="config.html#ENABLE-EDIT-ACTIONS"
442 >enable-edit-actions</A
446 HREF="config.html#ENFORCE-BLOCKS"
451 HREF="config.html#ACLS"
452 >ACLs: permit-access and deny-access</A
456 HREF="config.html#BUFFER-LIMIT"
461 HREF="config.html#ENABLE-PROXY-AUTHENTICATION-FORWARDING"
462 >enable-proxy-authentication-forwarding</A
466 HREF="config.html#TRUSTED-CGI-REFERER"
467 >trusted-cgi-referer</A
473 HREF="config.html#FORWARDING"
480 HREF="config.html#FORWARD"
485 HREF="config.html#SOCKS"
486 >forward-socks4, forward-socks4a, forward-socks5 and forward-socks5t</A
490 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
491 >Advanced Forwarding Examples</A
495 HREF="config.html#FORWARDED-CONNECT-RETRIES"
496 >forwarded-connect-retries</A
502 HREF="config.html#MISC"
509 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
510 >accept-intercepted-requests</A
514 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
515 >allow-cgi-request-crunching</A
519 HREF="config.html#SPLIT-LARGE-FORMS"
520 >split-large-forms</A
524 HREF="config.html#KEEP-ALIVE-TIMEOUT"
525 >keep-alive-timeout</A
529 HREF="config.html#TOLERATE-PIPELINING"
530 >tolerate-pipelining</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#LISTEN-BACKLOG"
559 HREF="config.html#ENABLE-ACCEPT-FILTER"
560 >enable-accept-filter</A
564 HREF="config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK"
565 >handle-as-empty-doc-returns-ok</A
569 HREF="config.html#ENABLE-COMPRESSION"
570 >enable-compression</A
574 HREF="config.html#COMPRESSION-LEVEL"
575 >compression-level</A
579 HREF="config.html#CLIENT-HEADER-ORDER"
580 >client-header-order</A
584 HREF="config.html#CLIENT-SPECIFIC-TAG"
585 >client-specific-tag</A
589 HREF="config.html#CLIENT-TAG-LIFETIME"
590 >client-tag-lifetime</A
594 HREF="config.html#TRUST-X-FORWARDED-FOR"
595 >trust-x-forwarded-for</A
599 HREF="config.html#RECEIVE-BUFFER-SIZE"
600 >receive-buffer-size</A
606 HREF="config.html#WINDOWS-GUI"
607 >Windows GUI Options</A
613 HREF="actions-file.html"
620 HREF="actions-file.html#RIGHT-MIX"
621 >Finding the Right Mix</A
625 HREF="actions-file.html#HOW-TO-EDIT"
630 HREF="actions-file.html#ACTIONS-APPLY"
631 >How Actions are Applied to Requests</A
635 HREF="actions-file.html#AF-PATTERNS"
642 HREF="actions-file.html#HOST-PATTERN"
647 HREF="actions-file.html#PATH-PATTERN"
652 HREF="actions-file.html#TAG-PATTERN"
653 >The Request Tag Pattern</A
657 HREF="actions-file.html#NEGATIVE-TAG-PATTERNS"
658 >The Negative Request Tag Patterns</A
662 HREF="actions-file.html#CLIENT-TAG-PATTERN"
663 >The Client Tag Pattern</A
669 HREF="actions-file.html#ACTIONS"
676 HREF="actions-file.html#ADD-HEADER"
681 HREF="actions-file.html#BLOCK"
686 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
687 >change-x-forwarded-for</A
691 HREF="actions-file.html#CLIENT-HEADER-FILTER"
692 >client-header-filter</A
696 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
697 >client-header-tagger</A
701 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
702 >content-type-overwrite</A
706 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
707 >crunch-client-header</A
711 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
712 >crunch-if-none-match</A
716 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
717 >crunch-incoming-cookies</A
721 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
722 >crunch-server-header</A
726 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
727 >crunch-outgoing-cookies</A
731 HREF="actions-file.html#DEANIMATE-GIFS"
736 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
737 >downgrade-http-version</A
741 HREF="actions-file.html#EXTERNAL-FILTER"
746 HREF="actions-file.html#FAST-REDIRECTS"
751 HREF="actions-file.html#FILTER"
756 HREF="actions-file.html#FORCE-TEXT-MODE"
761 HREF="actions-file.html#FORWARD-OVERRIDE"
766 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
767 >handle-as-empty-document</A
771 HREF="actions-file.html#HANDLE-AS-IMAGE"
776 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
777 >hide-accept-language</A
781 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
782 >hide-content-disposition</A
786 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
787 >hide-if-modified-since</A
791 HREF="actions-file.html#HIDE-FROM-HEADER"
796 HREF="actions-file.html#HIDE-REFERRER"
801 HREF="actions-file.html#HIDE-USER-AGENT"
806 HREF="actions-file.html#LIMIT-CONNECT"
811 HREF="actions-file.html#LIMIT-COOKIE-LIFETIME"
812 >limit-cookie-lifetime</A
816 HREF="actions-file.html#PREVENT-COMPRESSION"
817 >prevent-compression</A
821 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
822 >overwrite-last-modified</A
826 HREF="actions-file.html#REDIRECT"
831 HREF="actions-file.html#SERVER-HEADER-FILTER"
832 >server-header-filter</A
836 HREF="actions-file.html#SERVER-HEADER-TAGGER"
837 >server-header-tagger</A
841 HREF="actions-file.html#SESSION-COOKIES-ONLY"
842 >session-cookies-only</A
846 HREF="actions-file.html#SET-IMAGE-BLOCKER"
847 >set-image-blocker</A
851 HREF="actions-file.html#SUMMARY"
858 HREF="actions-file.html#ALIASES"
863 HREF="actions-file.html#ACT-EXAMPLES"
864 >Actions Files Tutorial</A
870 HREF="actions-file.html#MATCH-ALL"
875 HREF="actions-file.html#DEFAULT-ACTION"
880 HREF="actions-file.html#USER-ACTION"
889 HREF="filter-file.html"
896 HREF="filter-file.html#FILTER-FILE-TUT"
897 >Filter File Tutorial</A
901 HREF="filter-file.html#PREDEFINED-FILTERS"
902 >The Pre-defined Filters</A
906 HREF="filter-file.html#EXTERNAL-FILTER-SYNTAX"
907 >External filter syntax</A
913 HREF="templates.html"
914 >Privoxy's Template Files</A
919 >Contacting the Developers, Bug Reporting and Feature
926 HREF="contact.html#SUFFICIENT-INFORMATION"
927 >Please provide sufficient information</A
931 HREF="contact.html#CONTACT-SUPPORT"
936 HREF="contact.html#REPORTING"
937 >Reporting Problems</A
943 HREF="contact.html#CONTACT-ADS"
944 >Reporting Ads or Other Configuration Problems</A
948 HREF="contact.html#CONTACT-BUGS"
955 HREF="contact.html#SECURITY-CONTACT"
956 >Reporting security problems</A
960 HREF="contact.html#MAILING-LISTS"
965 HREF="contact.html#SF-TRACKERS"
966 >SourceForge support trackers</A
972 HREF="copyright.html"
973 >Privoxy Copyright, License and History</A
979 HREF="copyright.html#LICENSE"
984 HREF="copyright.html#HISTORY"
989 HREF="copyright.html#AUTHORS"
1001 HREF="appendix.html"
1008 HREF="appendix.html#REGEX"
1009 >Regular Expressions</A
1013 HREF="appendix.html#INTERNAL-PAGES"
1014 >Privoxy's Internal Pages</A
1018 HREF="appendix.html#CHAIN"
1023 HREF="appendix.html#ACTIONSANAT"
1024 >Troubleshooting: Anatomy of an Action</A
1036 SUMMARY="Footer navigation table"
1057 HREF="introduction.html"