1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
6 <title>Privoxy 3.0.20 User Manual</title>
7 <meta name="GENERATOR" content=
8 "Modular DocBook HTML Stylesheet Version 1.79">
9 <link rel="NEXT" title="Introduction" href="introduction.html">
10 <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
11 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
12 <link rel="STYLESHEET" type="text/css" href="p_doc.css">
13 <style type="text/css">
15 background-color: #EEEEEE;
18 :link { color: #0000FF }
19 :visited { color: #840084 }
20 :active { color: #0000FF }
21 hr.c2 {text-align: left}
22 dt.c1 {font-weight: bold}
26 <body class="ARTICLE">
28 <div class="TITLEPAGE">
29 <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.20 User
32 <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> ©
33 2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy
34 Developers</a></sub><br></p>
36 <p class="PUBDATE">$Id: user-manual.sgml,v 2.147 2012/03/11 19:03:42
39 <div class="ABSTRACT">
40 <a name="AEN9" id="AEN9"></a>
42 <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users
43 information on how to install, configure and use <a href=
44 "http://www.privoxy.org/" target="_top">Privoxy</a>.</p>
46 <p>Privoxy is a non-caching web proxy with advanced filtering
47 capabilities for enhancing privacy, modifying web page data and HTTP
48 headers, controlling access, and removing ads and other obnoxious
49 Internet junk. Privoxy has a flexible configuration and can be
50 customized to suit individual needs and tastes. It has application
51 for both stand-alone systems and multi-user networks.</p>
53 <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>
55 <p>Privoxy is an associated project of Software in the Public
58 <p>Helping hands and donations are welcome:</p>
62 <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE"
64 "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
68 <p><a href="http://www.privoxy.org/faq/general.html#DONATE"
70 "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p>
74 <p>You can find the latest version of the <i class=
75 "CITETITLE">Privoxy User Manual</i> at <a href=
76 "http://www.privoxy.org/user-manual/" target=
77 "_top">http://www.privoxy.org/user-manual/</a>. Please see the
78 <a href="contact.html">Contact section</a> on how to contact the
86 <dt class="c1">Table of Contents</dt>
88 <dt>1. <a href="introduction.html">Introduction</a></dt>
92 <dt>1.1. <a href="introduction.html#FEATURES">Features</a></dt>
96 <dt>2. <a href="installation.html">Installation</a></dt>
100 <dt>2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary
106 "installation.html#INSTALLATION-PACK-RPM">Red Hat and Fedora
110 "installation.html#INSTALLATION-DEB">Debian and
114 "installation.html#INSTALLATION-PACK-WIN">Windows</a></dt>
117 "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a></dt>
120 "installation.html#INSTALLATION-OS2">OS/2</a></dt>
122 <dt>2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac
126 "installation.html#OS-X-INSTALL-FROM-PACKAGE">Installation
127 from ready-built package</a></dt>
130 "installation.html#OS-X-INSTALL-FROM-SOURCE">Installation
134 "installation.html#INSTALLATION-AMIGA">AmigaOS</a></dt>
137 "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>
140 "installation.html#INSTALLATTION-GENTOO">Gentoo</a></dt>
144 <dt>2.2. <a href="installation.html#INSTALLATION-SOURCE">Building
148 "installation.html#INSTALLATION-KEEPUPDATED">Keeping your
149 Installation Up-to-Date</a></dt>
153 <dt>3. <a href="whatsnew.html">What's New in this Release</a></dt>
157 <dt>3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to
162 <dt>4. <a href="quickstart.html">Quickstart to Using Privoxy</a></dt>
167 "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad
172 <dt>5. <a href="startup.html">Starting Privoxy</a></dt>
176 <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and
179 <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt>
181 <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>
183 <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
184 FreeBSD, HP-UX and others</a></dt>
186 <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>
188 <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
190 <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt>
192 <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt>
194 <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line
199 <dt>6. <a href="configuration.html">Privoxy Configuration</a></dt>
203 <dt>6.1. <a href="configuration.html#AEN1107">Controlling Privoxy
204 with Your Web Browser</a></dt>
206 <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
207 Files Overview</a></dt>
211 <dt>7. <a href="config.html">The Main Configuration File</a></dt>
215 <dt>7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up
216 Documentation</a></dt>
221 "config.html#USER-MANUAL">user-manual</a></dt>
224 "config.html#TRUST-INFO-URL">trust-info-url</a></dt>
227 "config.html#ADMIN-ADDRESS">admin-address</a></dt>
230 "config.html#PROXY-INFO-URL">proxy-info-url</a></dt>
234 <dt>7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log
235 File Locations</a></dt>
239 <dt>7.2.1. <a href="config.html#CONFDIR">confdir</a></dt>
241 <dt>7.2.2. <a href="config.html#TEMPLDIR">templdir</a></dt>
243 <dt>7.2.3. <a href="config.html#LOGDIR">logdir</a></dt>
246 "config.html#ACTIONSFILE">actionsfile</a></dt>
249 "config.html#FILTERFILE">filterfile</a></dt>
251 <dt>7.2.6. <a href="config.html#LOGFILE">logfile</a></dt>
253 <dt>7.2.7. <a href="config.html#TRUSTFILE">trustfile</a></dt>
257 <dt>7.3. <a href="config.html#DEBUGGING">Debugging</a></dt>
261 <dt>7.3.1. <a href="config.html#DEBUG">debug</a></dt>
264 "config.html#SINGLE-THREADED">single-threaded</a></dt>
266 <dt>7.3.3. <a href="config.html#HOSTNAME">hostname</a></dt>
270 <dt>7.4. <a href="config.html#ACCESS-CONTROL">Access Control and
276 "config.html#LISTEN-ADDRESS">listen-address</a></dt>
278 <dt>7.4.2. <a href="config.html#TOGGLE">toggle</a></dt>
281 "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a></dt>
284 "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a></dt>
287 "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a></dt>
290 "config.html#ENFORCE-BLOCKS">enforce-blocks</a></dt>
292 <dt>7.4.7. <a href="config.html#ACLS">ACLs: permit-access and
296 "config.html#BUFFER-LIMIT">buffer-limit</a></dt>
300 <dt>7.5. <a href="config.html#FORWARDING">Forwarding</a></dt>
304 <dt>7.5.1. <a href="config.html#FORWARD">forward</a></dt>
306 <dt>7.5.2. <a href="config.html#SOCKS">forward-socks4,
307 forward-socks4a and forward-socks5</a></dt>
310 "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
311 Forwarding Examples</a></dt>
314 "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a></dt>
318 <dt>7.6. <a href="config.html#MISC">Miscellaneous</a></dt>
323 "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a></dt>
326 "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a></dt>
329 "config.html#SPLIT-LARGE-FORMS">split-large-forms</a></dt>
332 "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a></dt>
335 "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt>
338 "config.html#CONNECTION-SHARING">connection-sharing</a></dt>
341 "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt>
344 "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt>
347 "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt>
350 "config.html#ENABLE-COMPRESSION">enable-compression</a></dt>
353 "config.html#COMPRESSION-LEVEL">compression-level</a></dt>
357 <dt>7.7. <a href="config.html#WINDOWS-GUI">Windows GUI
362 <dt>8. <a href="actions-file.html">Actions Files</a></dt>
366 <dt>8.1. <a href="actions-file.html#AEN2898">Finding the Right
369 <dt>8.2. <a href="actions-file.html#AEN2905">How to Edit</a></dt>
371 <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
372 are Applied to Requests</a></dt>
375 "actions-file.html#AF-PATTERNS">Patterns</a></dt>
379 <dt>8.4.1. <a href="actions-file.html#AEN3017">The Domain
382 <dt>8.4.2. <a href="actions-file.html#AEN3093">The Path
385 <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
390 <dt>8.5. <a href="actions-file.html#ACTIONS">Actions</a></dt>
395 "actions-file.html#ADD-HEADER">add-header</a></dt>
397 <dt>8.5.2. <a href="actions-file.html#BLOCK">block</a></dt>
400 "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a></dt>
403 "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></dt>
406 "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt>
409 "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt>
412 "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt>
415 "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt>
418 "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt>
421 "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt>
424 "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt>
427 "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt>
430 "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt>
433 "actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt>
436 "actions-file.html#FILTER">filter</a></dt>
439 "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt>
442 "actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt>
445 "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt>
448 "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt>
451 "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt>
454 "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt>
457 "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt>
460 "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt>
463 "actions-file.html#HIDE-REFERRER">hide-referrer</a></dt>
466 "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt>
469 "actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>
472 "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
475 "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
478 "actions-file.html#REDIRECT">redirect</a></dt>
481 "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
484 "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
487 "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
490 "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
493 "actions-file.html#AEN4725">Summary</a></dt>
497 <dt>8.6. <a href="actions-file.html#ALIASES">Aliases</a></dt>
499 <dt>8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files
505 "actions-file.html#AEN4789">match-all.action</a></dt>
508 "actions-file.html#AEN4811">default.action</a></dt>
511 "actions-file.html#AEN4924">user.action</a></dt>
517 <dt>9. <a href="filter-file.html">Filter Files</a></dt>
521 <dt>9.1. <a href="filter-file.html#AEN5079">Filter File
524 <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
525 Pre-defined Filters</a></dt>
529 <dt>10. <a href="templates.html">Privoxy's Template Files</a></dt>
531 <dt>11. <a href="contact.html">Contacting the Developers, Bug
532 Reporting and Feature Requests</a></dt>
536 <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get
539 <dt>11.2. <a href="contact.html#REPORTING">Reporting
544 <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
545 or Other Configuration Problems</a></dt>
547 <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
552 <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New
555 <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing
560 <dt>12. <a href="copyright.html">Privoxy Copyright, License and
565 <dt>12.1. <a href="copyright.html#AEN5561">License</a></dt>
567 <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
569 <dt>12.3. <a href="copyright.html#AUTHORS">Authors</a></dt>
573 <dt>13. <a href="seealso.html">See Also</a></dt>
575 <dt>14. <a href="appendix.html">Appendix</a></dt>
579 <dt>14.1. <a href="appendix.html#REGEX">Regular
582 <dt>14.2. <a href="appendix.html#AEN5814">Privoxy's Internal
588 "appendix.html#BOOKMARKLETS">Bookmarklets</a></dt>
592 <dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>
594 <dt>14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting:
595 Anatomy of an Action</a></dt>
602 <div class="NAVFOOTER">
603 <hr class="c2" width="100%">
605 <table summary="Footer navigation table" width="100%" border="0"
606 cellpadding="0" cellspacing="0">
608 <td width="33%" align="left" valign="top"> </td>
610 <td width="34%" align="center" valign="top"> </td>
612 <td width="33%" align="right" valign="top"><a href=
613 "introduction.html" accesskey="N">Next</a></td>
617 <td width="33%" align="left" valign="top"> </td>
619 <td width="34%" align="center" valign="top"> </td>
621 <td width="33%" align="right" valign="top">Introduction</td>