1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
2 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
6 Privoxy 3.0.26 User Manual
8 <meta name="GENERATOR" content=
9 "Modular DocBook HTML Stylesheet Version 1.79">
10 <link rel="NEXT" title="Introduction" href="introduction.html">
11 <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
12 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
13 <link rel="STYLESHEET" type="text/css" href="p_doc.css">
15 <body class="ARTICLE" bgcolor="#EEEEEE" text="#000000" link="#0000FF"
16 vlink="#840084" alink="#0000FF">
18 <div class="TITLEPAGE">
20 <a name="AEN2">Privoxy 3.0.26 User Manual</a>
23 <sub><a href="copyright.html">Copyright</a> © 2001-2016 by <a
24 href="https://www.privoxy.org/" target="_top">Privoxy
25 Developers</a></sub><br>
28 $Id: user-manual.sgml,v 2.214 2016/07/26 10:46:19 fabiankeil Exp
32 <div class="ABSTRACT">
35 The <i class="CITETITLE">Privoxy User Manual</i> gives users
36 information on how to install, configure and use <a href=
37 "https://www.privoxy.org/" target="_top">Privoxy</a>.
40 Privoxy is a non-caching web proxy with advanced filtering
41 capabilities for enhancing privacy, modifying web page data and
42 HTTP headers, controlling access, and removing ads and other
43 obnoxious Internet junk. Privoxy has a flexible configuration
44 and can be customized to suit individual needs and tastes. It
45 has application for both stand-alone systems and multi-user
49 Privoxy is Free Software and licensed under the GNU GPLv2.
52 Privoxy is an associated project of Software in the Public
56 Helping hands and donations are welcome:
62 "https://www.privoxy.org/faq/general.html#PARTICIPATE"
64 "_top">https://www.privoxy.org/faq/general.html#PARTICIPATE</a>
69 <a href="https://www.privoxy.org/faq/general.html#DONATE"
71 "_top">https://www.privoxy.org/faq/general.html#DONATE</a>
77 You can find the latest version of the <i class=
78 "CITETITLE">Privoxy User Manual</i> at <a href=
79 "https://www.privoxy.org/user-manual/" target=
80 "_top">https://www.privoxy.org/user-manual/</a>. Please see the
81 <a href="contact.html">Contact section</a> on how to contact
91 <b>Table of Contents</b>
94 1. <a href="introduction.html">Introduction</a>
99 1.1. <a href="introduction.html#FEATURES">Features</a>
104 2. <a href="installation.html">Installation</a>
109 2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary
116 "installation.html#INSTALLATION-DEB">Debian and
121 "installation.html#INSTALLATION-PACK-WIN">Windows</a>
125 "installation.html#INSTALLATION-OS2">OS/2</a>
128 2.1.4. <a href="installation.html#INSTALLATION-MAC">Mac
133 "installation.html#OS-X-INSTALL-FROM-PACKAGE">Installation
134 from ready-built package</a>
138 "installation.html#OS-X-INSTALL-FROM-SOURCE">Installation
143 "installation.html#INSTALLATION-FREEBSD">FreeBSD</a>
148 2.2. <a href="installation.html#INSTALLATION-SOURCE">Building
153 "installation.html#INSTALLATION-KEEPUPDATED">Keeping your
154 Installation Up-to-Date</a>
159 3. <a href="whatsnew.html">What's New in this Release</a>
164 3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to
170 4. <a href="quickstart.html">Quickstart to Using Privoxy</a>
176 "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad
182 5. <a href="startup.html">Starting Privoxy</a>
187 5.1. <a href="startup.html#START-DEBIAN">Debian</a>
190 5.2. <a href="startup.html#START-FREEBSD">FreeBSD and
194 5.3. <a href="startup.html#START-WINDOWS">Windows</a>
197 5.4. <a href="startup.html#START-UNICES">Generic instructions
198 for Unix derivates (Solaris, NetBSD, HP-UX etc.)</a>
201 5.5. <a href="startup.html#START-OS2">OS/2</a>
204 5.6. <a href="startup.html#START-MACOSX">Mac OS X</a>
207 5.7. <a href="startup.html#CMDOPTIONS">Command Line
213 6. <a href="configuration.html">Privoxy Configuration</a>
219 "configuration.html#CONTROL-WITH-WEBBROWSER">Controlling
220 Privoxy with Your Web Browser</a>
223 6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
229 7. <a href="config.html">The Main Configuration File</a>
234 7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up
240 7.1.1. <a href="config.html#USER-MANUAL">user-manual</a>
244 "config.html#TRUST-INFO-URL">trust-info-url</a>
248 "config.html#ADMIN-ADDRESS">admin-address</a>
252 "config.html#PROXY-INFO-URL">proxy-info-url</a>
257 7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log
263 7.2.1. <a href="config.html#CONFDIR">confdir</a>
266 7.2.2. <a href="config.html#TEMPLDIR">templdir</a>
270 "config.html#TEMPORARY-DIRECTORY">temporary-directory</a>
273 7.2.4. <a href="config.html#LOGDIR">logdir</a>
276 7.2.5. <a href="config.html#ACTIONSFILE">actionsfile</a>
279 7.2.6. <a href="config.html#FILTERFILE">filterfile</a>
282 7.2.7. <a href="config.html#LOGFILE">logfile</a>
285 7.2.8. <a href="config.html#TRUSTFILE">trustfile</a>
290 7.3. <a href="config.html#DEBUGGING">Debugging</a>
295 7.3.1. <a href="config.html#DEBUG">debug</a>
299 "config.html#SINGLE-THREADED">single-threaded</a>
302 7.3.3. <a href="config.html#HOSTNAME">hostname</a>
307 7.4. <a href="config.html#ACCESS-CONTROL">Access Control and
314 "config.html#LISTEN-ADDRESS">listen-address</a>
317 7.4.2. <a href="config.html#TOGGLE">toggle</a>
321 "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>
325 "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>
329 "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>
333 "config.html#ENFORCE-BLOCKS">enforce-blocks</a>
336 7.4.7. <a href="config.html#ACLS">ACLs: permit-access and
341 "config.html#BUFFER-LIMIT">buffer-limit</a>
345 "config.html#ENABLE-PROXY-AUTHENTICATION-FORWARDING">enable-proxy-authentication-forwarding</a>
350 7.5. <a href="config.html#FORWARDING">Forwarding</a>
355 7.5.1. <a href="config.html#FORWARD">forward</a>
358 7.5.2. <a href="config.html#SOCKS">forward-socks4,
359 forward-socks4a, forward-socks5 and forward-socks5t</a>
363 "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
364 Forwarding Examples</a>
368 "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a>
373 7.6. <a href="config.html#MISC">Miscellaneous</a>
379 "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a>
383 "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a>
387 "config.html#SPLIT-LARGE-FORMS">split-large-forms</a>
391 "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a>
395 "config.html#TOLERATE-PIPELINING">tolerate-pipelining</a>
399 "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a>
403 "config.html#CONNECTION-SHARING">connection-sharing</a>
407 "config.html#SOCKET-TIMEOUT">socket-timeout</a>
411 "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a>
415 "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a>
419 "config.html#ENABLE-COMPRESSION">enable-compression</a>
423 "config.html#COMPRESSION-LEVEL">compression-level</a>
427 "config.html#CLIENT-HEADER-ORDER">client-header-order</a>
431 "config.html#CLIENT-SPECIFIC-TAG">client-specific-tag</a>
435 "config.html#CLIENT-TAG-LIFETIME">client-tag-lifetime</a>
439 "config.html#TRUST-X-FORWARDED-FOR">trust-x-forwarded-for</a>
444 7.7. <a href="config.html#WINDOWS-GUI">Windows GUI
450 8. <a href="actions-file.html">Actions Files</a>
455 8.1. <a href="actions-file.html#RIGHT-MIX">Finding the Right
459 8.2. <a href="actions-file.html#HOW-TO-EDIT">How to Edit</a>
462 8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
463 are Applied to Requests</a>
466 8.4. <a href="actions-file.html#AF-PATTERNS">Patterns</a>
471 8.4.1. <a href="actions-file.html#HOST-PATTERN">The Host
475 8.4.2. <a href="actions-file.html#PATH-PATTERN">The Path
479 8.4.3. <a href="actions-file.html#TAG-PATTERN">The
480 Request Tag Pattern</a>
484 "actions-file.html#NEGATIVE-TAG-PATTERNS">The Negative
485 Request Tag Patterns</a>
488 8.4.5. <a href="actions-file.html#CLIENT-TAG-PATTERN">The
489 Client Tag Pattern</a>
494 8.5. <a href="actions-file.html#ACTIONS">Actions</a>
500 "actions-file.html#ADD-HEADER">add-header</a>
503 8.5.2. <a href="actions-file.html#BLOCK">block</a>
507 "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a>
511 "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a>
515 "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a>
519 "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a>
523 "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a>
527 "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a>
531 "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a>
535 "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a>
539 "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a>
543 "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a>
547 "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a>
551 "actions-file.html#EXTERNAL-FILTER">external-filter</a>
555 "actions-file.html#FAST-REDIRECTS">fast-redirects</a>
558 8.5.16. <a href="actions-file.html#FILTER">filter</a>
562 "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a>
566 "actions-file.html#FORWARD-OVERRIDE">forward-override</a>
570 "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a>
574 "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a>
578 "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a>
582 "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a>
586 "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a>
590 "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a>
594 "actions-file.html#HIDE-REFERRER">hide-referrer</a>
598 "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a>
602 "actions-file.html#LIMIT-CONNECT">limit-connect</a>
606 "actions-file.html#LIMIT-COOKIE-LIFETIME">limit-cookie-lifetime</a>
610 "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a>
614 "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a>
617 8.5.31. <a href="actions-file.html#REDIRECT">redirect</a>
621 "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a>
625 "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a>
629 "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a>
633 "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a>
636 8.5.36. <a href="actions-file.html#SUMMARY">Summary</a>
641 8.6. <a href="actions-file.html#ALIASES">Aliases</a>
644 8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files
651 "actions-file.html#MATCH-ALL">match-all.action</a>
655 "actions-file.html#DEFAULT-ACTION">default.action</a>
659 "actions-file.html#USER-ACTION">user.action</a>
666 9. <a href="filter-file.html">Filter Files</a>
671 9.1. <a href="filter-file.html#FILTER-FILE-TUT">Filter File
675 9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
676 Pre-defined Filters</a>
680 "filter-file.html#EXTERNAL-FILTER-SYNTAX">External filter
686 10. <a href="templates.html">Privoxy's Template Files</a>
689 11. <a href="contact.html">Contacting the Developers, Bug
690 Reporting and Feature Requests</a>
695 11.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please
696 provide sufficient information</a>
699 11.2. <a href="contact.html#CONTACT-SUPPORT">Get Support</a>
702 11.3. <a href="contact.html#REPORTING">Reporting Problems</a>
707 11.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
708 or Other Configuration Problems</a>
711 11.3.2. <a href="contact.html#CONTACT-BUGS">Reporting
717 11.4. <a href="contact.html#SECURITY-CONTACT">Reporting
718 security problems</a>
721 11.5. <a href="contact.html#MAILING-LISTS">Mailing Lists</a>
724 11.6. <a href="contact.html#SF-TRACKERS">SourceForge support
730 12. <a href="copyright.html">Privoxy Copyright, License and
736 12.1. <a href="copyright.html#LICENSE">License</a>
739 12.2. <a href="copyright.html#HISTORY">History</a>
742 12.3. <a href="copyright.html#AUTHORS">Authors</a>
747 13. <a href="seealso.html">See Also</a>
750 14. <a href="appendix.html">Appendix</a>
755 14.1. <a href="appendix.html#REGEX">Regular Expressions</a>
758 14.2. <a href="appendix.html#INTERNAL-PAGES">Privoxy's
762 14.3. <a href="appendix.html#CHAIN">Chain of Events</a>
765 14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting:
766 Anatomy of an Action</a>
773 <div class="NAVFOOTER">
774 <hr align="LEFT" width="100%">
775 <table summary="Footer navigation table" width="100%" border="0"
776 cellpadding="0" cellspacing="0">
778 <td width="33%" align="left" valign="top">
781 <td width="34%" align="center" valign="top">
784 <td width="33%" align="right" valign="top">
785 <a href="introduction.html" accesskey="N">Next</a>
789 <td width="33%" align="left" valign="top">
792 <td width="34%" align="center" valign="top">
795 <td width="33%" align="right" valign="top">