1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
2 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 <meta name="generator" content="HTML Tidy, see www.w3.org">
7 Privoxy 3.0.18 User Manual
9 <meta name="GENERATOR" content=
10 "Modular DocBook HTML Stylesheet Version 1.79">
11 <link rel="NEXT" title="Introduction" href="introduction.html">
12 <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
13 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
14 <link rel="STYLESHEET" type="text/css" href="p_doc.css">
15 <style type="text/css">
17 background-color: #EEEEEE;
20 :link { color: #0000FF }
21 :visited { color: #840084 }
22 :active { color: #0000FF }
23 hr.c2 {text-align: left}
24 dt.c1 {font-weight: bold}
27 <body class="ARTICLE">
29 <div class="TITLEPAGE">
31 <a name="AEN2">Privoxy 3.0.18 User Manual</a>
34 <sub><a href="copyright.html">Copyright</a> © 2001-2011 by <a
35 href="http://www.privoxy.org/" target="_top">Privoxy
36 Developers</a></sub><br>
39 $Id: index.html,v 1.77 2011/08/26 16:14:24 fabiankeil Exp $<br>
44 The <i class="CITETITLE">Privoxy User Manual</i> gives users
45 information on how to install, configure and use <a href=
46 "http://www.privoxy.org/" target="_top">Privoxy</a>.
49 Privoxy is a non-caching web proxy with advanced filtering
50 capabilities for enhancing privacy, modifying web page data and
51 HTTP headers, controlling access, and removing ads and other
52 obnoxious Internet junk. Privoxy has a flexible configuration and
53 can be customized to suit individual needs and tastes. It has
54 application for both stand-alone systems and multi-user networks.
57 Privoxy is Free Software and licensed under the GNU GPLv2.
60 Privoxy is an associated project of Software in the Public
64 Helping hands and donations are welcome:
69 <a href="http://www.privoxy.org/faq/general.html#PARTICIPATE"
71 "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a>
76 <a href="http://www.privoxy.org/faq/general.html#DONATE"
78 "_top">http://www.privoxy.org/faq/general.html#DONATE</a>
84 You can find the latest version of the <i class=
85 "CITETITLE">Privoxy User Manual</i> at <a href=
86 "http://www.privoxy.org/user-manual/" target=
87 "_top">http://www.privoxy.org/user-manual/</a>. Please see the <a
88 href="contact.html">Contact section</a> on how to contact the
100 1. <a href="introduction.html">Introduction</a>
105 1.1. <a href="introduction.html#FEATURES">Features</a>
110 2. <a href="installation.html">Installation</a>
115 2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary
122 "installation.html#INSTALLATION-PACK-RPM">Red Hat and
127 "installation.html#INSTALLATION-DEB">Debian and
132 "installation.html#INSTALLATION-PACK-WIN">Windows</a>
136 "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a>
140 "installation.html#INSTALLATION-OS2">OS/2</a>
143 2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac
148 "installation.html#INSTALLATION-AMIGA">AmigaOS</a>
152 "installation.html#INSTALLATION-TBZ">FreeBSD</a>
156 "installation.html#INSTALLATTION-GENTOO">Gentoo</a>
161 2.2. <a href="installation.html#INSTALLATION-SOURCE">Building
166 "installation.html#INSTALLATION-KEEPUPDATED">Keeping your
167 Installation Up-to-Date</a>
172 3. <a href="whatsnew.html">What's New in this Release</a>
177 3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to
183 4. <a href="quickstart.html">Quickstart to Using Privoxy</a>
189 "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad
195 5. <a href="startup.html">Starting Privoxy</a>
200 5.1. <a href="startup.html#START-REDHAT">Red Hat and
204 5.2. <a href="startup.html#START-DEBIAN">Debian</a>
207 5.3. <a href="startup.html#START-WINDOWS">Windows</a>
210 5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD,
211 FreeBSD, HP-UX and others</a>
214 5.5. <a href="startup.html#START-OS2">OS/2</a>
217 5.6. <a href="startup.html#START-MACOSX">Mac OS X</a>
220 5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a>
223 5.8. <a href="startup.html#START-GENTOO">Gentoo</a>
226 5.9. <a href="startup.html#CMDOPTIONS">Command Line
232 6. <a href="configuration.html">Privoxy Configuration</a>
237 6.1. <a href="configuration.html#AEN933">Controlling Privoxy
238 with Your Web Browser</a>
241 6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
247 7. <a href="config.html">The Main Configuration File</a>
252 7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up
258 7.1.1. <a href="config.html#USER-MANUAL">user-manual</a>
262 "config.html#TRUST-INFO-URL">trust-info-url</a>
266 "config.html#ADMIN-ADDRESS">admin-address</a>
270 "config.html#PROXY-INFO-URL">proxy-info-url</a>
275 7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log
281 7.2.1. <a href="config.html#CONFDIR">confdir</a>
284 7.2.2. <a href="config.html#TEMPLDIR">templdir</a>
287 7.2.3. <a href="config.html#LOGDIR">logdir</a>
290 7.2.4. <a href="config.html#ACTIONSFILE">actionsfile</a>
293 7.2.5. <a href="config.html#FILTERFILE">filterfile</a>
296 7.2.6. <a href="config.html#LOGFILE">logfile</a>
299 7.2.7. <a href="config.html#TRUSTFILE">trustfile</a>
304 7.3. <a href="config.html#DEBUGGING">Debugging</a>
309 7.3.1. <a href="config.html#DEBUG">debug</a>
313 "config.html#SINGLE-THREADED">single-threaded</a>
316 7.3.3. <a href="config.html#HOSTNAME">hostname</a>
321 7.4. <a href="config.html#ACCESS-CONTROL">Access Control and
328 "config.html#LISTEN-ADDRESS">listen-address</a>
331 7.4.2. <a href="config.html#TOGGLE">toggle</a>
335 "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>
339 "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>
343 "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>
347 "config.html#ENFORCE-BLOCKS">enforce-blocks</a>
350 7.4.7. <a href="config.html#ACLS">ACLs: permit-access and
355 "config.html#BUFFER-LIMIT">buffer-limit</a>
360 7.5. <a href="config.html#FORWARDING">Forwarding</a>
365 7.5.1. <a href="config.html#FORWARD">forward</a>
368 7.5.2. <a href="config.html#SOCKS">forward-socks4,
369 forward-socks4a and forward-socks5</a>
373 "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced
374 Forwarding Examples</a>
378 "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a>
383 7.6. <a href="config.html#MISC">Miscellaneous</a>
389 "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a>
393 "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a>
397 "config.html#SPLIT-LARGE-FORMS">split-large-forms</a>
401 "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a>
405 "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a>
409 "config.html#CONNECTION-SHARING">connection-sharing</a>
413 "config.html#SOCKET-TIMEOUT">socket-timeout</a>
417 "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a>
421 "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a>
425 "config.html#ENABLE-COMPRESSION">enable-compression</a>
429 "config.html#COMPRESSION-LEVEL">compression-level</a>
434 7.7. <a href="config.html#WINDOWS-GUI">Windows GUI
440 8. <a href="actions-file.html">Actions Files</a>
445 8.1. <a href="actions-file.html#AEN2724">Finding the Right
449 8.2. <a href="actions-file.html#AEN2731">How to Edit</a>
452 8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
453 are Applied to Requests</a>
456 8.4. <a href="actions-file.html#AF-PATTERNS">Patterns</a>
461 8.4.1. <a href="actions-file.html#AEN2843">The Domain
465 8.4.2. <a href="actions-file.html#AEN2919">The Path
469 8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
475 8.5. <a href="actions-file.html#ACTIONS">Actions</a>
481 "actions-file.html#ADD-HEADER">add-header</a>
484 8.5.2. <a href="actions-file.html#BLOCK">block</a>
488 "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a>
492 "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a>
496 "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a>
500 "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a>
504 "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a>
508 "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a>
512 "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a>
516 "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a>
520 "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a>
524 "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a>
528 "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a>
532 "actions-file.html#FAST-REDIRECTS">fast-redirects</a>
535 8.5.15. <a href="actions-file.html#FILTER">filter</a>
539 "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a>
543 "actions-file.html#FORWARD-OVERRIDE">forward-override</a>
547 "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a>
551 "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a>
555 "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a>
559 "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a>
563 "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a>
567 "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a>
571 "actions-file.html#HIDE-REFERRER">hide-referrer</a>
575 "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a>
579 "actions-file.html#LIMIT-CONNECT">limit-connect</a>
583 "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a>
587 "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a>
590 8.5.29. <a href="actions-file.html#REDIRECT">redirect</a>
594 "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a>
598 "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a>
602 "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a>
606 "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a>
609 8.5.34. <a href="actions-file.html#AEN4549">Summary</a>
614 8.6. <a href="actions-file.html#ALIASES">Aliases</a>
617 8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files
624 "actions-file.html#AEN4613">match-all.action</a>
628 "actions-file.html#AEN4635">default.action</a>
632 "actions-file.html#AEN4748">user.action</a>
639 9. <a href="filter-file.html">Filter Files</a>
644 9.1. <a href="filter-file.html#AEN4903">Filter File
648 9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
649 Pre-defined Filters</a>
654 10. <a href="templates.html">Privoxy's Template Files</a>
657 11. <a href="contact.html">Contacting the Developers, Bug
658 Reporting and Feature Requests</a>
663 11.1. <a href="contact.html#CONTACT-SUPPORT">Get Support</a>
666 11.2. <a href="contact.html#REPORTING">Reporting Problems</a>
671 11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads
672 or Other Configuration Problems</a>
675 11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting
681 11.3. <a href="contact.html#CONTACT-FEATURE">Request New
685 11.4. <a href="contact.html#MAILING-LISTS">Mailing Lists</a>
690 12. <a href="copyright.html">Privoxy Copyright, License and
696 12.1. <a href="copyright.html#AEN5383">License</a>
699 12.2. <a href="copyright.html#HISTORY">History</a>
702 12.3. <a href="copyright.html#AUTHORS">Authors</a>
707 13. <a href="seealso.html">See Also</a>
710 14. <a href="appendix.html">Appendix</a>
715 14.1. <a href="appendix.html#REGEX">Regular Expressions</a>
718 14.2. <a href="appendix.html#AEN5636">Privoxy's Internal
725 "appendix.html#BOOKMARKLETS">Bookmarklets</a>
730 14.3. <a href="appendix.html#CHAIN">Chain of Events</a>
733 14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting:
734 Anatomy of an Action</a>
741 <div class="NAVFOOTER">
742 <hr width="100%" class="c2">
743 <table summary="Footer navigation table" width="100%" border="0"
744 cellpadding="0" cellspacing="0">
746 <td width="33%" align="left" valign="top">
749 <td width="34%" align="center" valign="top">
752 <td width="33%" align="right" valign="top">
753 <a href="introduction.html" accesskey="N">Next</a>
757 <td width="33%" align="left" valign="top">
760 <td width="34%" align="center" valign="top">
763 <td width="33%" align="right" valign="top">