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">
15 <body class="ARTICLE" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
16 "#840084" alink="#0000FF">
18 <div class="TITLEPAGE">
19 <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.20 User
22 <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> ©
23 2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy
24 Developers</a></sub><br></p>
26 <p class="PUBDATE">$Id: user-manual.sgml,v 2.157 2013/01/05 23:50:35
30 <div class="ABSTRACT">
31 <a name="AEN9" id="AEN9"></a>
33 <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users
34 information on how to install, configure and use <a href=
35 "http://www.privoxy.org/" target="_top">Privoxy</a>.</p>
37 <p>Privoxy is a non-caching web proxy with advanced filtering
38 capabilities for enhancing privacy, modifying web page data and
39 HTTP headers, controlling access, and removing ads and other
40 obnoxious Internet junk. Privoxy has a flexible configuration and
41 can be customized to suit individual needs and tastes. It has
42 application for both stand-alone systems and multi-user
45 <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>
47 <p>Privoxy is an associated project of Software in the Public
50 <p>Helping hands and donations are welcome:</p>
55 "http://www.privoxy.org/faq/general.html#PARTICIPATE" target=
56 "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
60 <p><a href="http://www.privoxy.org/faq/general.html#DONATE"
62 "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p>
66 <p>You can find the latest version of the <i class=
67 "CITETITLE">Privoxy User Manual</i> at <a href=
68 "http://www.privoxy.org/user-manual/" target=
69 "_top">http://www.privoxy.org/user-manual/</a>. Please see the
70 <a href="contact.html">Contact section</a> on how to contact the
79 <dt><b>Table of Contents</b></dt>
81 <dt>1. <a href="introduction.html">Introduction</a></dt>
85 <dt>1.1. <a href="introduction.html#FEATURES">Features</a></dt>
89 <dt>2. <a href="installation.html">Installation</a></dt>
93 <dt>2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary
99 "installation.html#INSTALLATION-PACK-RPM">Red Hat and Fedora
103 "installation.html#INSTALLATION-DEB">Debian and
107 "installation.html#INSTALLATION-PACK-WIN">Windows</a></dt>
110 "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a></dt>
113 "installation.html#INSTALLATION-OS2">OS/2</a></dt>
115 <dt>2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac
119 "installation.html#OS-X-INSTALL-FROM-PACKAGE">Installation
120 from ready-built package</a></dt>
123 "installation.html#OS-X-INSTALL-FROM-SOURCE">Installation
127 "installation.html#INSTALLATION-AMIGA">AmigaOS</a></dt>
130 "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>
133 "installation.html#INSTALLATTION-GENTOO">Gentoo</a></dt>
137 <dt>2.2. <a href="installation.html#INSTALLATION-SOURCE">Building
141 "installation.html#INSTALLATION-KEEPUPDATED">Keeping your
142 Installation Up-to-Date</a></dt>
146 <dt>3. <a href="whatsnew.html">What's New in this Release</a></dt>
150 <dt>3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to
155 <dt>4. <a href="quickstart.html">Quickstart to Using Privoxy</a></dt>
160 "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad
165 <dt>5. <a href="startup.html">Starting Privoxy</a></dt>
169 <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and
172 <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt>
174 <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>
176 <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
177 FreeBSD, HP-UX and others</a></dt>
179 <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>
181 <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
183 <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt>
185 <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt>
187 <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line
192 <dt>6. <a href="configuration.html">Privoxy Configuration</a></dt>
196 <dt>6.1. <a href="configuration.html#AEN1114">Controlling Privoxy
197 with Your Web Browser</a></dt>
199 <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
200 Files Overview</a></dt>
204 <dt>7. <a href="config.html">The Main Configuration File</a></dt>
208 <dt>7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up
209 Documentation</a></dt>
214 "config.html#USER-MANUAL">user-manual</a></dt>
217 "config.html#TRUST-INFO-URL">trust-info-url</a></dt>
220 "config.html#ADMIN-ADDRESS">admin-address</a></dt>
223 "config.html#PROXY-INFO-URL">proxy-info-url</a></dt>
227 <dt>7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log
228 File Locations</a></dt>
232 <dt>7.2.1. <a href="config.html#CONFDIR">confdir</a></dt>
234 <dt>7.2.2. <a href="config.html#TEMPLDIR">templdir</a></dt>
236 <dt>7.2.3. <a href="config.html#LOGDIR">logdir</a></dt>
239 "config.html#ACTIONSFILE">actionsfile</a></dt>
242 "config.html#FILTERFILE">filterfile</a></dt>
244 <dt>7.2.6. <a href="config.html#LOGFILE">logfile</a></dt>
246 <dt>7.2.7. <a href="config.html#TRUSTFILE">trustfile</a></dt>
250 <dt>7.3. <a href="config.html#DEBUGGING">Debugging</a></dt>
254 <dt>7.3.1. <a href="config.html#DEBUG">debug</a></dt>
257 "config.html#SINGLE-THREADED">single-threaded</a></dt>
259 <dt>7.3.3. <a href="config.html#HOSTNAME">hostname</a></dt>
263 <dt>7.4. <a href="config.html#ACCESS-CONTROL">Access Control and
269 "config.html#LISTEN-ADDRESS">listen-address</a></dt>
271 <dt>7.4.2. <a href="config.html#TOGGLE">toggle</a></dt>
274 "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a></dt>
277 "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a></dt>
280 "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a></dt>
283 "config.html#ENFORCE-BLOCKS">enforce-blocks</a></dt>
285 <dt>7.4.7. <a href="config.html#ACLS">ACLs: permit-access and
289 "config.html#BUFFER-LIMIT">buffer-limit</a></dt>
293 <dt>7.5. <a href="config.html#FORWARDING">Forwarding</a></dt>
297 <dt>7.5.1. <a href="config.html#FORWARD">forward</a></dt>
299 <dt>7.5.2. <a href="config.html#SOCKS">forward-socks4,
300 forward-socks4a, forward-socks5 and forward-socks5t</a></dt>
303 "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
304 Forwarding Examples</a></dt>
307 "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a></dt>
311 <dt>7.6. <a href="config.html#MISC">Miscellaneous</a></dt>
316 "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a></dt>
319 "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a></dt>
322 "config.html#SPLIT-LARGE-FORMS">split-large-forms</a></dt>
325 "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a></dt>
328 "config.html#TOLERATE-PIPELINING">tolerate-pipelining</a></dt>
331 "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt>
334 "config.html#CONNECTION-SHARING">connection-sharing</a></dt>
337 "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt>
340 "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt>
343 "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt>
346 "config.html#ENABLE-COMPRESSION">enable-compression</a></dt>
349 "config.html#COMPRESSION-LEVEL">compression-level</a></dt>
352 "config.html#CLIENT-HEADER-ORDER">client-header-order</a></dt>
356 <dt>7.7. <a href="config.html#WINDOWS-GUI">Windows GUI
361 <dt>8. <a href="actions-file.html">Actions Files</a></dt>
365 <dt>8.1. <a href="actions-file.html#AEN2964">Finding the Right
368 <dt>8.2. <a href="actions-file.html#AEN2971">How to Edit</a></dt>
370 <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
371 are Applied to Requests</a></dt>
374 "actions-file.html#AF-PATTERNS">Patterns</a></dt>
378 <dt>8.4.1. <a href="actions-file.html#AEN3083">The Domain
381 <dt>8.4.2. <a href="actions-file.html#AEN3159">The Path
384 <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
389 <dt>8.5. <a href="actions-file.html#ACTIONS">Actions</a></dt>
394 "actions-file.html#ADD-HEADER">add-header</a></dt>
396 <dt>8.5.2. <a href="actions-file.html#BLOCK">block</a></dt>
399 "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a></dt>
402 "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></dt>
405 "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt>
408 "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt>
411 "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt>
414 "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt>
417 "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt>
420 "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt>
423 "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt>
426 "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt>
429 "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt>
432 "actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt>
435 "actions-file.html#FILTER">filter</a></dt>
438 "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt>
441 "actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt>
444 "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt>
447 "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt>
450 "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt>
453 "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt>
456 "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt>
459 "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt>
462 "actions-file.html#HIDE-REFERRER">hide-referrer</a></dt>
465 "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt>
468 "actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>
471 "actions-file.html#LIMIT-COOKIE-LIFETIME">limit-cookie-lifetime</a></dt>
474 "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
477 "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
480 "actions-file.html#REDIRECT">redirect</a></dt>
483 "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
486 "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
489 "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
492 "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
495 "actions-file.html#AEN4831">Summary</a></dt>
499 <dt>8.6. <a href="actions-file.html#ALIASES">Aliases</a></dt>
501 <dt>8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files
507 "actions-file.html#AEN4895">match-all.action</a></dt>
510 "actions-file.html#AEN4917">default.action</a></dt>
513 "actions-file.html#AEN5030">user.action</a></dt>
519 <dt>9. <a href="filter-file.html">Filter Files</a></dt>
523 <dt>9.1. <a href="filter-file.html#AEN5185">Filter File
526 <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
527 Pre-defined Filters</a></dt>
531 <dt>10. <a href="templates.html">Privoxy's Template Files</a></dt>
533 <dt>11. <a href="contact.html">Contacting the Developers, Bug
534 Reporting and Feature Requests</a></dt>
538 <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get
541 <dt>11.2. <a href="contact.html#REPORTING">Reporting
546 <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
547 or Other Configuration Problems</a></dt>
549 <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
554 <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New
557 <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing
562 <dt>12. <a href="copyright.html">Privoxy Copyright, License and
567 <dt>12.1. <a href="copyright.html#AEN5667">License</a></dt>
569 <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
571 <dt>12.3. <a href="copyright.html#AUTHORS">Authors</a></dt>
575 <dt>13. <a href="seealso.html">See Also</a></dt>
577 <dt>14. <a href="appendix.html">Appendix</a></dt>
581 <dt>14.1. <a href="appendix.html#REGEX">Regular
584 <dt>14.2. <a href="appendix.html#AEN5911">Privoxy's Internal
590 "appendix.html#BOOKMARKLETS">Bookmarklets</a></dt>
594 <dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>
596 <dt>14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting:
597 Anatomy of an Action</a></dt>
604 <div class="NAVFOOTER">
605 <hr align="left" width="100%">
607 <table summary="Footer navigation table" width="100%" border="0"
608 cellpadding="0" cellspacing="0">
610 <td width="33%" align="left" valign="top"> </td>
612 <td width="34%" align="center" valign="top"> </td>
614 <td width="33%" align="right" valign="top"><a href=
615 "introduction.html" accesskey="N">Next</a></td>
619 <td width="33%" align="left" valign="top"> </td>
621 <td width="34%" align="center" valign="top"> </td>
623 <td width="33%" align="right" valign="top">Introduction</td>