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
62 >Privoxy User Manual</I
63 > gives users information on how to
64 install, configure and use <A
65 HREF="https://www.privoxy.org/"
71 > Privoxy is a non-caching web proxy with advanced filtering capabilities
72 for enhancing privacy, modifying web page data and HTTP headers, controlling
73 access, and removing ads and other obnoxious Internet junk. Privoxy has a
74 flexible configuration and can be customized to suit individual needs and tastes.
75 It has application for both stand-alone systems and multi-user networks.</P
77 > Privoxy is Free Software and licensed under the GNU GPLv2.</P
79 > Privoxy is an associated project of Software in the Public Interest (SPI).</P
81 > Helping hands and donations are welcome:</P
89 HREF="https://www.privoxy.org/faq/general.html#PARTICIPATE"
91 > https://www.privoxy.org/faq/general.html#PARTICIPATE</A
98 HREF="https://www.privoxy.org/faq/general.html#DONATE"
100 > https://www.privoxy.org/faq/general.html#DONATE</A
107 > You can find the latest version of the <I
109 >Privoxy User Manual</I
111 HREF="https://www.privoxy.org/user-manual/"
113 >https://www.privoxy.org/user-manual/</A
119 contact the developers.
131 >Table of Contents</B
135 HREF="introduction.html"
142 HREF="introduction.html#FEATURES"
149 HREF="installation.html"
156 HREF="installation.html#INSTALLATION-PACKAGES"
163 HREF="installation.html#INSTALLATION-DEB"
164 >Debian and Ubuntu</A
168 HREF="installation.html#INSTALLATION-PACK-WIN"
173 HREF="installation.html#INSTALLATION-OS2"
178 HREF="installation.html#INSTALLATION-MAC"
183 HREF="installation.html#OS-X-INSTALL-FROM-PACKAGE"
184 >Installation from ready-built package</A
188 HREF="installation.html#OS-X-INSTALL-FROM-SOURCE"
189 >Installation from source</A
193 HREF="installation.html#INSTALLATION-FREEBSD"
200 HREF="installation.html#INSTALLATION-SOURCE"
201 >Building from Source</A
207 HREF="installation.html#WINBUILD-CYGWIN"
214 HREF="installation.html#INSTALLATION-KEEPUPDATED"
215 >Keeping your Installation Up-to-Date</A
222 >What's New in this Release</A
228 HREF="whatsnew.html#UPGRADERSNOTE"
229 >Note to Upgraders</A
235 HREF="quickstart.html"
236 >Quickstart to Using Privoxy</A
242 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
243 >Quickstart to Ad Blocking</A
256 HREF="startup.html#START-DEBIAN"
261 HREF="startup.html#START-FREEBSD"
262 >FreeBSD and ElectroBSD</A
266 HREF="startup.html#START-WINDOWS"
271 HREF="startup.html#START-UNICES"
272 >Generic instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</A
276 HREF="startup.html#START-OS2"
281 HREF="startup.html#START-MACOSX"
286 HREF="startup.html#CMDOPTIONS"
287 >Command Line Options</A
293 HREF="configuration.html"
294 >Privoxy Configuration</A
300 HREF="configuration.html#CONTROL-WITH-WEBBROWSER"
301 >Controlling Privoxy with Your Web Browser</A
305 HREF="configuration.html#CONFOVERVIEW"
306 >Configuration Files Overview</A
313 >The Main Configuration File</A
319 HREF="config.html#LOCAL-SET-UP"
320 >Local Set-up Documentation</A
326 HREF="config.html#USER-MANUAL"
331 HREF="config.html#TRUST-INFO-URL"
336 HREF="config.html#ADMIN-ADDRESS"
341 HREF="config.html#PROXY-INFO-URL"
348 HREF="config.html#CONF-LOG-LOC"
349 >Configuration and Log File Locations</A
355 HREF="config.html#CONFDIR"
360 HREF="config.html#TEMPLDIR"
365 HREF="config.html#TEMPORARY-DIRECTORY"
366 >temporary-directory</A
370 HREF="config.html#LOGDIR"
375 HREF="config.html#ACTIONSFILE"
380 HREF="config.html#FILTERFILE"
385 HREF="config.html#LOGFILE"
390 HREF="config.html#TRUSTFILE"
397 HREF="config.html#DEBUGGING"
404 HREF="config.html#DEBUG"
409 HREF="config.html#SINGLE-THREADED"
414 HREF="config.html#HOSTNAME"
421 HREF="config.html#ACCESS-CONTROL"
422 >Access Control and Security</A
428 HREF="config.html#LISTEN-ADDRESS"
433 HREF="config.html#TOGGLE"
438 HREF="config.html#ENABLE-REMOTE-TOGGLE"
439 >enable-remote-toggle</A
443 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
444 >enable-remote-http-toggle</A
448 HREF="config.html#ENABLE-EDIT-ACTIONS"
449 >enable-edit-actions</A
453 HREF="config.html#ENFORCE-BLOCKS"
458 HREF="config.html#ACLS"
459 >ACLs: permit-access and deny-access</A
463 HREF="config.html#BUFFER-LIMIT"
468 HREF="config.html#ENABLE-PROXY-AUTHENTICATION-FORWARDING"
469 >enable-proxy-authentication-forwarding</A
473 HREF="config.html#TRUSTED-CGI-REFERER"
474 >trusted-cgi-referer</A
480 HREF="config.html#FORWARDING"
487 HREF="config.html#FORWARD"
492 HREF="config.html#SOCKS"
493 >forward-socks4, forward-socks4a, forward-socks5 and forward-socks5t</A
497 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
498 >Advanced Forwarding Examples</A
502 HREF="config.html#FORWARDED-CONNECT-RETRIES"
503 >forwarded-connect-retries</A
509 HREF="config.html#MISC"
516 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
517 >accept-intercepted-requests</A
521 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
522 >allow-cgi-request-crunching</A
526 HREF="config.html#SPLIT-LARGE-FORMS"
527 >split-large-forms</A
531 HREF="config.html#KEEP-ALIVE-TIMEOUT"
532 >keep-alive-timeout</A
536 HREF="config.html#TOLERATE-PIPELINING"
537 >tolerate-pipelining</A
541 HREF="config.html#DEFAULT-SERVER-TIMEOUT"
542 >default-server-timeout</A
546 HREF="config.html#CONNECTION-SHARING"
547 >connection-sharing</A
551 HREF="config.html#SOCKET-TIMEOUT"
556 HREF="config.html#MAX-CLIENT-CONNECTIONS"
557 >max-client-connections</A
561 HREF="config.html#LISTEN-BACKLOG"
566 HREF="config.html#ENABLE-ACCEPT-FILTER"
567 >enable-accept-filter</A
571 HREF="config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK"
572 >handle-as-empty-doc-returns-ok</A
576 HREF="config.html#ENABLE-COMPRESSION"
577 >enable-compression</A
581 HREF="config.html#COMPRESSION-LEVEL"
582 >compression-level</A
586 HREF="config.html#CLIENT-HEADER-ORDER"
587 >client-header-order</A
591 HREF="config.html#CLIENT-SPECIFIC-TAG"
592 >client-specific-tag</A
596 HREF="config.html#CLIENT-TAG-LIFETIME"
597 >client-tag-lifetime</A
601 HREF="config.html#TRUST-X-FORWARDED-FOR"
602 >trust-x-forwarded-for</A
606 HREF="config.html#RECEIVE-BUFFER-SIZE"
607 >receive-buffer-size</A
613 HREF="config.html#WINDOWS-GUI"
614 >Windows GUI Options</A
620 HREF="actions-file.html"
627 HREF="actions-file.html#RIGHT-MIX"
628 >Finding the Right Mix</A
632 HREF="actions-file.html#HOW-TO-EDIT"
637 HREF="actions-file.html#ACTIONS-APPLY"
638 >How Actions are Applied to Requests</A
642 HREF="actions-file.html#AF-PATTERNS"
649 HREF="actions-file.html#HOST-PATTERN"
654 HREF="actions-file.html#PATH-PATTERN"
659 HREF="actions-file.html#TAG-PATTERN"
660 >The Request Tag Pattern</A
664 HREF="actions-file.html#NEGATIVE-TAG-PATTERNS"
665 >The Negative Request Tag Patterns</A
669 HREF="actions-file.html#CLIENT-TAG-PATTERN"
670 >The Client Tag Pattern</A
676 HREF="actions-file.html#ACTIONS"
683 HREF="actions-file.html#ADD-HEADER"
688 HREF="actions-file.html#BLOCK"
693 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
694 >change-x-forwarded-for</A
698 HREF="actions-file.html#CLIENT-HEADER-FILTER"
699 >client-header-filter</A
703 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
704 >client-header-tagger</A
708 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
709 >content-type-overwrite</A
713 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
714 >crunch-client-header</A
718 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
719 >crunch-if-none-match</A
723 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
724 >crunch-incoming-cookies</A
728 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
729 >crunch-server-header</A
733 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
734 >crunch-outgoing-cookies</A
738 HREF="actions-file.html#DEANIMATE-GIFS"
743 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
744 >downgrade-http-version</A
748 HREF="actions-file.html#EXTERNAL-FILTER"
753 HREF="actions-file.html#FAST-REDIRECTS"
758 HREF="actions-file.html#FILTER"
763 HREF="actions-file.html#FORCE-TEXT-MODE"
768 HREF="actions-file.html#FORWARD-OVERRIDE"
773 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
774 >handle-as-empty-document</A
778 HREF="actions-file.html#HANDLE-AS-IMAGE"
783 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
784 >hide-accept-language</A
788 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
789 >hide-content-disposition</A
793 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
794 >hide-if-modified-since</A
798 HREF="actions-file.html#HIDE-FROM-HEADER"
803 HREF="actions-file.html#HIDE-REFERRER"
808 HREF="actions-file.html#HIDE-USER-AGENT"
813 HREF="actions-file.html#LIMIT-CONNECT"
818 HREF="actions-file.html#LIMIT-COOKIE-LIFETIME"
819 >limit-cookie-lifetime</A
823 HREF="actions-file.html#PREVENT-COMPRESSION"
824 >prevent-compression</A
828 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
829 >overwrite-last-modified</A
833 HREF="actions-file.html#REDIRECT"
838 HREF="actions-file.html#SERVER-HEADER-FILTER"
839 >server-header-filter</A
843 HREF="actions-file.html#SERVER-HEADER-TAGGER"
844 >server-header-tagger</A
848 HREF="actions-file.html#SESSION-COOKIES-ONLY"
849 >session-cookies-only</A
853 HREF="actions-file.html#SET-IMAGE-BLOCKER"
854 >set-image-blocker</A
858 HREF="actions-file.html#SUMMARY"
865 HREF="actions-file.html#ALIASES"
870 HREF="actions-file.html#ACT-EXAMPLES"
871 >Actions Files Tutorial</A
877 HREF="actions-file.html#MATCH-ALL"
882 HREF="actions-file.html#DEFAULT-ACTION"
887 HREF="actions-file.html#USER-ACTION"
896 HREF="filter-file.html"
903 HREF="filter-file.html#FILTER-FILE-TUT"
904 >Filter File Tutorial</A
908 HREF="filter-file.html#PREDEFINED-FILTERS"
909 >The Pre-defined Filters</A
913 HREF="filter-file.html#EXTERNAL-FILTER-SYNTAX"
914 >External filter syntax</A
920 HREF="templates.html"
921 >Privoxy's Template Files</A
926 >Contacting the Developers, Bug Reporting and Feature
933 HREF="contact.html#SUFFICIENT-INFORMATION"
934 >Please provide sufficient information</A
938 HREF="contact.html#CONTACT-SUPPORT"
943 HREF="contact.html#REPORTING"
944 >Reporting Problems</A
950 HREF="contact.html#CONTACT-ADS"
951 >Reporting Ads or Other Configuration Problems</A
955 HREF="contact.html#CONTACT-BUGS"
962 HREF="contact.html#SECURITY-CONTACT"
963 >Reporting security problems</A
967 HREF="contact.html#MAILING-LISTS"
972 HREF="contact.html#SF-TRACKERS"
973 >SourceForge support trackers</A
979 HREF="copyright.html"
980 >Privoxy Copyright, License and History</A
986 HREF="copyright.html#LICENSE"
991 HREF="copyright.html#HISTORY"
996 HREF="copyright.html#AUTHORS"
1008 HREF="appendix.html"
1015 HREF="appendix.html#REGEX"
1016 >Regular Expressions</A
1020 HREF="appendix.html#INTERNAL-PAGES"
1021 >Privoxy's Internal Pages</A
1025 HREF="appendix.html#CHAIN"
1030 HREF="appendix.html#ACTIONSANAT"
1031 >Troubleshooting: Anatomy of an Action</A
1043 SUMMARY="Footer navigation table"
1064 HREF="introduction.html"