1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
6 <meta name="generator" content=
7 "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">
9 <title>Privoxy 3.0.18 User Manual</title>
10 <meta name="GENERATOR" content=
11 "Modular DocBook HTML Stylesheet Version 1.79">
12 <link rel="NEXT" title="Introduction" href="introduction.html">
13 <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
14 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
15 <link rel="STYLESHEET" type="text/css" href="p_doc.css">
16 <style type="text/css">
18 background-color: #EEEEEE;
21 :link { color: #0000FF }
22 :visited { color: #840084 }
23 :active { color: #0000FF }
24 hr.c2 {text-align: left}
25 dt.c1 {font-weight: bold}
29 <body class="ARTICLE">
31 <div class="TITLEPAGE">
32 <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.18 User
35 <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> ©
36 2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy
37 Developers</a></sub><br></p>
39 <p class="PUBDATE">$Id: user-manual.sgml,v 2.139 2011/11/18 16:49:29
40 fabiankeil Exp $<br></p>
42 <div class="ABSTRACT">
43 <a name="AEN9" id="AEN9"></a>
45 <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users
46 information on how to install, configure and use <a href=
47 "http://www.privoxy.org/" target="_top">Privoxy</a>.</p>
49 <p>Privoxy is a non-caching web proxy with advanced filtering
50 capabilities for enhancing privacy, modifying web page data and HTTP
51 headers, controlling access, and removing ads and other obnoxious
52 Internet junk. Privoxy has a flexible configuration and can be
53 customized to suit individual needs and tastes. It has application
54 for both stand-alone systems and multi-user networks.</p>
56 <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>
58 <p>Privoxy is an associated project of Software in the Public
61 <p>Helping hands and donations are welcome:</p>
65 <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE"
67 "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
71 <p><a href="http://www.privoxy.org/faq/general.html#DONATE"
73 "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p>
77 <p>You can find the latest version of the <i class=
78 "CITETITLE">Privoxy User Manual</i> at <a href=
79 "http://www.privoxy.org/user-manual/" target=
80 "_top">http://www.privoxy.org/user-manual/</a>. Please see the
81 <a href="contact.html">Contact section</a> on how to contact the
89 <dt class="c1">Table of Contents</dt>
91 <dt>1. <a href="introduction.html">Introduction</a></dt>
95 <dt>1.1. <a href="introduction.html#FEATURES">Features</a></dt>
99 <dt>2. <a href="installation.html">Installation</a></dt>
103 <dt>2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary
109 "installation.html#INSTALLATION-PACK-RPM">Red Hat and Fedora
113 "installation.html#INSTALLATION-DEB">Debian and
117 "installation.html#INSTALLATION-PACK-WIN">Windows</a></dt>
120 "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a></dt>
123 "installation.html#INSTALLATION-OS2">OS/2</a></dt>
125 <dt>2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac
129 "installation.html#INSTALLATION-AMIGA">AmigaOS</a></dt>
132 "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt>
135 "installation.html#INSTALLATTION-GENTOO">Gentoo</a></dt>
139 <dt>2.2. <a href="installation.html#INSTALLATION-SOURCE">Building
143 "installation.html#INSTALLATION-KEEPUPDATED">Keeping your
144 Installation Up-to-Date</a></dt>
148 <dt>3. <a href="whatsnew.html">What's New in this Release</a></dt>
152 <dt>3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to
157 <dt>4. <a href="quickstart.html">Quickstart to Using Privoxy</a></dt>
162 "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad
167 <dt>5. <a href="startup.html">Starting Privoxy</a></dt>
171 <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and
174 <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt>
176 <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>
178 <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
179 FreeBSD, HP-UX and others</a></dt>
181 <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>
183 <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
185 <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt>
187 <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt>
189 <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line
194 <dt>6. <a href="configuration.html">Privoxy Configuration</a></dt>
198 <dt>6.1. <a href="configuration.html#AEN1071">Controlling Privoxy
199 with Your Web Browser</a></dt>
201 <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
202 Files Overview</a></dt>
206 <dt>7. <a href="config.html">The Main Configuration File</a></dt>
210 <dt>7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up
211 Documentation</a></dt>
216 "config.html#USER-MANUAL">user-manual</a></dt>
219 "config.html#TRUST-INFO-URL">trust-info-url</a></dt>
222 "config.html#ADMIN-ADDRESS">admin-address</a></dt>
225 "config.html#PROXY-INFO-URL">proxy-info-url</a></dt>
229 <dt>7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log
230 File Locations</a></dt>
234 <dt>7.2.1. <a href="config.html#CONFDIR">confdir</a></dt>
236 <dt>7.2.2. <a href="config.html#TEMPLDIR">templdir</a></dt>
238 <dt>7.2.3. <a href="config.html#LOGDIR">logdir</a></dt>
241 "config.html#ACTIONSFILE">actionsfile</a></dt>
244 "config.html#FILTERFILE">filterfile</a></dt>
246 <dt>7.2.6. <a href="config.html#LOGFILE">logfile</a></dt>
248 <dt>7.2.7. <a href="config.html#TRUSTFILE">trustfile</a></dt>
252 <dt>7.3. <a href="config.html#DEBUGGING">Debugging</a></dt>
256 <dt>7.3.1. <a href="config.html#DEBUG">debug</a></dt>
259 "config.html#SINGLE-THREADED">single-threaded</a></dt>
261 <dt>7.3.3. <a href="config.html#HOSTNAME">hostname</a></dt>
265 <dt>7.4. <a href="config.html#ACCESS-CONTROL">Access Control and
271 "config.html#LISTEN-ADDRESS">listen-address</a></dt>
273 <dt>7.4.2. <a href="config.html#TOGGLE">toggle</a></dt>
276 "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a></dt>
279 "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a></dt>
282 "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a></dt>
285 "config.html#ENFORCE-BLOCKS">enforce-blocks</a></dt>
287 <dt>7.4.7. <a href="config.html#ACLS">ACLs: permit-access and
291 "config.html#BUFFER-LIMIT">buffer-limit</a></dt>
295 <dt>7.5. <a href="config.html#FORWARDING">Forwarding</a></dt>
299 <dt>7.5.1. <a href="config.html#FORWARD">forward</a></dt>
301 <dt>7.5.2. <a href="config.html#SOCKS">forward-socks4,
302 forward-socks4a and forward-socks5</a></dt>
305 "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
306 Forwarding Examples</a></dt>
309 "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a></dt>
313 <dt>7.6. <a href="config.html#MISC">Miscellaneous</a></dt>
318 "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a></dt>
321 "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a></dt>
324 "config.html#SPLIT-LARGE-FORMS">split-large-forms</a></dt>
327 "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a></dt>
330 "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt>
333 "config.html#CONNECTION-SHARING">connection-sharing</a></dt>
336 "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt>
339 "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt>
342 "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt>
345 "config.html#ENABLE-COMPRESSION">enable-compression</a></dt>
348 "config.html#COMPRESSION-LEVEL">compression-level</a></dt>
352 <dt>7.7. <a href="config.html#WINDOWS-GUI">Windows GUI
357 <dt>8. <a href="actions-file.html">Actions Files</a></dt>
361 <dt>8.1. <a href="actions-file.html#AEN2860">Finding the Right
364 <dt>8.2. <a href="actions-file.html#AEN2867">How to Edit</a></dt>
366 <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
367 are Applied to Requests</a></dt>
370 "actions-file.html#AF-PATTERNS">Patterns</a></dt>
374 <dt>8.4.1. <a href="actions-file.html#AEN2979">The Domain
377 <dt>8.4.2. <a href="actions-file.html#AEN3055">The Path
380 <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
385 <dt>8.5. <a href="actions-file.html#ACTIONS">Actions</a></dt>
390 "actions-file.html#ADD-HEADER">add-header</a></dt>
392 <dt>8.5.2. <a href="actions-file.html#BLOCK">block</a></dt>
395 "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a></dt>
398 "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></dt>
401 "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt>
404 "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt>
407 "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt>
410 "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt>
413 "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt>
416 "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt>
419 "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt>
422 "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt>
425 "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt>
428 "actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt>
431 "actions-file.html#FILTER">filter</a></dt>
434 "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt>
437 "actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt>
440 "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt>
443 "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt>
446 "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt>
449 "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt>
452 "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt>
455 "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt>
458 "actions-file.html#HIDE-REFERRER">hide-referrer</a></dt>
461 "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt>
464 "actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>
467 "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
470 "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
473 "actions-file.html#REDIRECT">redirect</a></dt>
476 "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
479 "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
482 "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
485 "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
488 "actions-file.html#AEN4684">Summary</a></dt>
492 <dt>8.6. <a href="actions-file.html#ALIASES">Aliases</a></dt>
494 <dt>8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files
500 "actions-file.html#AEN4748">match-all.action</a></dt>
503 "actions-file.html#AEN4770">default.action</a></dt>
506 "actions-file.html#AEN4883">user.action</a></dt>
512 <dt>9. <a href="filter-file.html">Filter Files</a></dt>
516 <dt>9.1. <a href="filter-file.html#AEN5038">Filter File
519 <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
520 Pre-defined Filters</a></dt>
524 <dt>10. <a href="templates.html">Privoxy's Template Files</a></dt>
526 <dt>11. <a href="contact.html">Contacting the Developers, Bug
527 Reporting and Feature Requests</a></dt>
531 <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get
534 <dt>11.2. <a href="contact.html#REPORTING">Reporting
539 <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
540 or Other Configuration Problems</a></dt>
542 <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
547 <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New
550 <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing
555 <dt>12. <a href="copyright.html">Privoxy Copyright, License and
560 <dt>12.1. <a href="copyright.html#AEN5520">License</a></dt>
562 <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
564 <dt>12.3. <a href="copyright.html#AUTHORS">Authors</a></dt>
568 <dt>13. <a href="seealso.html">See Also</a></dt>
570 <dt>14. <a href="appendix.html">Appendix</a></dt>
574 <dt>14.1. <a href="appendix.html#REGEX">Regular
577 <dt>14.2. <a href="appendix.html#AEN5773">Privoxy's Internal
583 "appendix.html#BOOKMARKLETS">Bookmarklets</a></dt>
587 <dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>
589 <dt>14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting:
590 Anatomy of an Action</a></dt>
597 <div class="NAVFOOTER">
598 <hr class="c2" width="100%">
600 <table summary="Footer navigation table" width="100%" border="0"
601 cellpadding="0" cellspacing="0">
603 <td width="33%" align="left" valign="top"> </td>
605 <td width="34%" align="center" valign="top"> </td>
607 <td width="33%" align="right" valign="top"><a href=
608 "introduction.html" accesskey="N">Next</a></td>
612 <td width="33%" align="left" valign="top"> </td>
614 <td width="34%" align="center" valign="top"> </td>
616 <td width="33%" align="right" valign="top">Introduction</td>