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:
88 HREF="https://www.privoxy.org/faq/general.html#PARTICIPATE"
90 >https://www.privoxy.org/faq/general.html#PARTICIPATE</A
97 HREF="https://www.privoxy.org/faq/general.html#DONATE"
99 >https://www.privoxy.org/faq/general.html#DONATE</A
106 > You can find the latest version of the <I
108 >Privoxy User Manual</I
110 HREF="https://www.privoxy.org/user-manual/"
112 >https://www.privoxy.org/user-manual/</A
118 contact the developers.
130 >Table of Contents</B
134 HREF="introduction.html"
141 HREF="introduction.html#FEATURES"
148 HREF="installation.html"
155 HREF="installation.html#INSTALLATION-PACKAGES"
162 HREF="installation.html#INSTALLATION-DEB"
163 >Debian and Ubuntu</A
167 HREF="installation.html#INSTALLATION-PACK-WIN"
172 HREF="installation.html#INSTALLATION-OS2"
177 HREF="installation.html#INSTALLATION-MAC"
182 HREF="installation.html#OS-X-INSTALL-FROM-PACKAGE"
183 >Installation from ready-built package</A
187 HREF="installation.html#OS-X-INSTALL-FROM-SOURCE"
188 >Installation from source</A
192 HREF="installation.html#INSTALLATION-FREEBSD"
199 HREF="installation.html#INSTALLATION-SOURCE"
200 >Building from Source</A
204 HREF="installation.html#INSTALLATION-KEEPUPDATED"
205 >Keeping your Installation Up-to-Date</A
212 >What's New in this Release</A
218 HREF="whatsnew.html#UPGRADERSNOTE"
219 >Note to Upgraders</A
225 HREF="quickstart.html"
226 >Quickstart to Using Privoxy</A
232 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
233 >Quickstart to Ad Blocking</A
246 HREF="startup.html#START-DEBIAN"
251 HREF="startup.html#START-FREEBSD"
252 >FreeBSD and ElectroBSD</A
256 HREF="startup.html#START-WINDOWS"
261 HREF="startup.html#START-UNICES"
262 >Generic instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</A
266 HREF="startup.html#START-OS2"
271 HREF="startup.html#START-MACOSX"
276 HREF="startup.html#CMDOPTIONS"
277 >Command Line Options</A
283 HREF="configuration.html"
284 >Privoxy Configuration</A
290 HREF="configuration.html#CONTROL-WITH-WEBBROWSER"
291 >Controlling Privoxy with Your Web Browser</A
295 HREF="configuration.html#CONFOVERVIEW"
296 >Configuration Files Overview</A
303 >The Main Configuration File</A
309 HREF="config.html#LOCAL-SET-UP"
310 >Local Set-up Documentation</A
316 HREF="config.html#USER-MANUAL"
321 HREF="config.html#TRUST-INFO-URL"
326 HREF="config.html#ADMIN-ADDRESS"
331 HREF="config.html#PROXY-INFO-URL"
338 HREF="config.html#CONF-LOG-LOC"
339 >Configuration and Log File Locations</A
345 HREF="config.html#CONFDIR"
350 HREF="config.html#TEMPLDIR"
355 HREF="config.html#TEMPORARY-DIRECTORY"
356 >temporary-directory</A
360 HREF="config.html#LOGDIR"
365 HREF="config.html#ACTIONSFILE"
370 HREF="config.html#FILTERFILE"
375 HREF="config.html#LOGFILE"
380 HREF="config.html#TRUSTFILE"
387 HREF="config.html#DEBUGGING"
394 HREF="config.html#DEBUG"
399 HREF="config.html#SINGLE-THREADED"
404 HREF="config.html#HOSTNAME"
411 HREF="config.html#ACCESS-CONTROL"
412 >Access Control and Security</A
418 HREF="config.html#LISTEN-ADDRESS"
423 HREF="config.html#TOGGLE"
428 HREF="config.html#ENABLE-REMOTE-TOGGLE"
429 >enable-remote-toggle</A
433 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
434 >enable-remote-http-toggle</A
438 HREF="config.html#ENABLE-EDIT-ACTIONS"
439 >enable-edit-actions</A
443 HREF="config.html#ENFORCE-BLOCKS"
448 HREF="config.html#ACLS"
449 >ACLs: permit-access and deny-access</A
453 HREF="config.html#BUFFER-LIMIT"
458 HREF="config.html#ENABLE-PROXY-AUTHENTICATION-FORWARDING"
459 >enable-proxy-authentication-forwarding</A
463 HREF="config.html#TRUSTED-CGI-REFERER"
464 >trusted-cgi-referer</A
470 HREF="config.html#FORWARDING"
477 HREF="config.html#FORWARD"
482 HREF="config.html#SOCKS"
483 >forward-socks4, forward-socks4a, forward-socks5 and forward-socks5t</A
487 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
488 >Advanced Forwarding Examples</A
492 HREF="config.html#FORWARDED-CONNECT-RETRIES"
493 >forwarded-connect-retries</A
499 HREF="config.html#MISC"
506 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
507 >accept-intercepted-requests</A
511 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
512 >allow-cgi-request-crunching</A
516 HREF="config.html#SPLIT-LARGE-FORMS"
517 >split-large-forms</A
521 HREF="config.html#KEEP-ALIVE-TIMEOUT"
522 >keep-alive-timeout</A
526 HREF="config.html#TOLERATE-PIPELINING"
527 >tolerate-pipelining</A
531 HREF="config.html#DEFAULT-SERVER-TIMEOUT"
532 >default-server-timeout</A
536 HREF="config.html#CONNECTION-SHARING"
537 >connection-sharing</A
541 HREF="config.html#SOCKET-TIMEOUT"
546 HREF="config.html#MAX-CLIENT-CONNECTIONS"
547 >max-client-connections</A
551 HREF="config.html#LISTEN-BACKLOG"
556 HREF="config.html#ENABLE-ACCEPT-FILTER"
557 >enable-accept-filter</A
561 HREF="config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK"
562 >handle-as-empty-doc-returns-ok</A
566 HREF="config.html#ENABLE-COMPRESSION"
567 >enable-compression</A
571 HREF="config.html#COMPRESSION-LEVEL"
572 >compression-level</A
576 HREF="config.html#CLIENT-HEADER-ORDER"
577 >client-header-order</A
581 HREF="config.html#CLIENT-SPECIFIC-TAG"
582 >client-specific-tag</A
586 HREF="config.html#CLIENT-TAG-LIFETIME"
587 >client-tag-lifetime</A
591 HREF="config.html#TRUST-X-FORWARDED-FOR"
592 >trust-x-forwarded-for</A
596 HREF="config.html#RECEIVE-BUFFER-SIZE"
597 >receive-buffer-size</A
603 HREF="config.html#WINDOWS-GUI"
604 >Windows GUI Options</A
610 HREF="actions-file.html"
617 HREF="actions-file.html#RIGHT-MIX"
618 >Finding the Right Mix</A
622 HREF="actions-file.html#HOW-TO-EDIT"
627 HREF="actions-file.html#ACTIONS-APPLY"
628 >How Actions are Applied to Requests</A
632 HREF="actions-file.html#AF-PATTERNS"
639 HREF="actions-file.html#HOST-PATTERN"
644 HREF="actions-file.html#PATH-PATTERN"
649 HREF="actions-file.html#TAG-PATTERN"
650 >The Request Tag Pattern</A
654 HREF="actions-file.html#NEGATIVE-TAG-PATTERNS"
655 >The Negative Request Tag Patterns</A
659 HREF="actions-file.html#CLIENT-TAG-PATTERN"
660 >The Client Tag Pattern</A
666 HREF="actions-file.html#ACTIONS"
673 HREF="actions-file.html#ADD-HEADER"
678 HREF="actions-file.html#BLOCK"
683 HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
684 >change-x-forwarded-for</A
688 HREF="actions-file.html#CLIENT-HEADER-FILTER"
689 >client-header-filter</A
693 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
694 >client-header-tagger</A
698 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
699 >content-type-overwrite</A
703 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
704 >crunch-client-header</A
708 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
709 >crunch-if-none-match</A
713 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
714 >crunch-incoming-cookies</A
718 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
719 >crunch-server-header</A
723 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
724 >crunch-outgoing-cookies</A
728 HREF="actions-file.html#DEANIMATE-GIFS"
733 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
734 >downgrade-http-version</A
738 HREF="actions-file.html#EXTERNAL-FILTER"
743 HREF="actions-file.html#FAST-REDIRECTS"
748 HREF="actions-file.html#FILTER"
753 HREF="actions-file.html#FORCE-TEXT-MODE"
758 HREF="actions-file.html#FORWARD-OVERRIDE"
763 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
764 >handle-as-empty-document</A
768 HREF="actions-file.html#HANDLE-AS-IMAGE"
773 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
774 >hide-accept-language</A
778 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
779 >hide-content-disposition</A
783 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
784 >hide-if-modified-since</A
788 HREF="actions-file.html#HIDE-FROM-HEADER"
793 HREF="actions-file.html#HIDE-REFERRER"
798 HREF="actions-file.html#HIDE-USER-AGENT"
803 HREF="actions-file.html#LIMIT-CONNECT"
808 HREF="actions-file.html#LIMIT-COOKIE-LIFETIME"
809 >limit-cookie-lifetime</A
813 HREF="actions-file.html#PREVENT-COMPRESSION"
814 >prevent-compression</A
818 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
819 >overwrite-last-modified</A
823 HREF="actions-file.html#REDIRECT"
828 HREF="actions-file.html#SERVER-HEADER-FILTER"
829 >server-header-filter</A
833 HREF="actions-file.html#SERVER-HEADER-TAGGER"
834 >server-header-tagger</A
838 HREF="actions-file.html#SESSION-COOKIES-ONLY"
839 >session-cookies-only</A
843 HREF="actions-file.html#SET-IMAGE-BLOCKER"
844 >set-image-blocker</A
848 HREF="actions-file.html#SUMMARY"
855 HREF="actions-file.html#ALIASES"
860 HREF="actions-file.html#ACT-EXAMPLES"
861 >Actions Files Tutorial</A
867 HREF="actions-file.html#MATCH-ALL"
872 HREF="actions-file.html#DEFAULT-ACTION"
877 HREF="actions-file.html#USER-ACTION"
886 HREF="filter-file.html"
893 HREF="filter-file.html#FILTER-FILE-TUT"
894 >Filter File Tutorial</A
898 HREF="filter-file.html#PREDEFINED-FILTERS"
899 >The Pre-defined Filters</A
903 HREF="filter-file.html#EXTERNAL-FILTER-SYNTAX"
904 >External filter syntax</A
910 HREF="templates.html"
911 >Privoxy's Template Files</A
916 >Contacting the Developers, Bug Reporting and Feature
923 HREF="contact.html#SUFFICIENT-INFORMATION"
924 >Please provide sufficient information</A
928 HREF="contact.html#CONTACT-SUPPORT"
933 HREF="contact.html#REPORTING"
934 >Reporting Problems</A
940 HREF="contact.html#CONTACT-ADS"
941 >Reporting Ads or Other Configuration Problems</A
945 HREF="contact.html#CONTACT-BUGS"
952 HREF="contact.html#SECURITY-CONTACT"
953 >Reporting security problems</A
957 HREF="contact.html#MAILING-LISTS"
962 HREF="contact.html#SF-TRACKERS"
963 >SourceForge support trackers</A
969 HREF="copyright.html"
970 >Privoxy Copyright, License and History</A
976 HREF="copyright.html#LICENSE"
981 HREF="copyright.html#HISTORY"
986 HREF="copyright.html#AUTHORS"
1005 HREF="appendix.html#REGEX"
1006 >Regular Expressions</A
1010 HREF="appendix.html#INTERNAL-PAGES"
1011 >Privoxy's Internal Pages</A
1015 HREF="appendix.html#CHAIN"
1020 HREF="appendix.html#ACTIONSANAT"
1021 >Troubleshooting: Anatomy of an Action</A
1033 SUMMARY="Footer navigation table"
1054 HREF="introduction.html"