Rebuild docs for 3.0.29 stable
[privoxy.git] / doc / webserver / faq / general.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "">
3 <html>
4 <head>
5   <title>General Information</title>
6   <meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.79">
7   <link rel="HOME" title="Privoxy Frequently Asked Questions" href="index.html">
8   <link rel="PREVIOUS" title="Privoxy Frequently Asked Questions" href="index.html">
9   <link rel="NEXT" title="Installation" href="installation.html">
10   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
11   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
12 </head>
13 <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink="#840084" alink="#0000FF">
14   <div class="NAVHEADER">
15     <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
16       <tr>
17         <th colspan="3" align="center">Privoxy Frequently Asked Questions</th>
18       </tr>
19       <tr>
20         <td width="10%" align="left" valign="bottom"><a href="index.html" accesskey="P">Prev</a></td>
21         <td width="80%" align="center" valign="bottom"></td>
22         <td width="10%" align="right" valign="bottom"><a href="installation.html" accesskey="N">Next</a></td>
23       </tr>
24     </table>
25     <hr align="left" width="100%">
26   </div>
27   <div class="SECT1">
28     <h1 class="SECT1"><a name="GENERAL" id="GENERAL">1. General Information</a></h1>
29     <div class="SECT2">
30       <h3 class="SECT2"><a name="WHO-USES" id="WHO-USES">1.1. Who should give <span class="APPLICATION">Privoxy</span>
31       a try?</a></h3>
32       <p>Anyone who is interested in security, privacy, or in finer-grained control over their web and Internet
33       experience.</p>
34     </div>
35     <div class="SECT2">
36       <h3 class="SECT2"><a name="BESTCHOICE" id="BESTCHOICE">1.2. Is Privoxy the best choice for me?</a></h3>
37       <p><span class="APPLICATION">Privoxy</span> is certainly a good choice, especially for those who want more
38       control and security. Those with the willingness to read the documentation and the ability to fine-tune their
39       installation will benefit the most.</p>
40       <p>One of <span class="APPLICATION">Privoxy's</span> strengths is that it is highly configurable giving you the
41       ability to completely personalize your installation. Being familiar with, or at least having an interest in
42       learning about <a href="" target="_top">HTTP</a> and other networking protocols,
43       <a href="" target="_top">HTML</a>, and <a href=
44       "" target="_top"><span class="QUOTE">"Regular
45       Expressions"</span></a> will be a big plus and will help you get the most out of <span class=
46       "APPLICATION">Privoxy</span>. A new installation just includes a very basic configuration. The user should take
47       this as a starting point only, and enhance it as he or she sees fit. In fact, the user is encouraged, and
48       expected to, fine-tune the configuration.</p>
49       <p>Much of <span class="APPLICATION">Privoxy's</span> configuration can be done with a <a href=
50       "" target="_top">Web browser</a>. But there are areas where configuration
51       is done using a <a href="" target="_top">text editor</a> to edit
52       configuration files. Also note that the web-based action editor doesn't use authentication and should only be
53       enabled in environments where all clients with access to <span class="APPLICATION">Privoxy</span> listening port
54       can be trusted.</p>
55     </div>
56     <div class="SECT2">
57       <h3 class="SECT2"><a name="PROXYMORON" id="PROXYMORON">1.3. What is a <span class="QUOTE">"proxy"</span>? How
58       does Privoxy work?</a></h3>
59       <p>A <a href="" target="_top">web proxy</a> is a service, based on a
60       software such as <span class="APPLICATION">Privoxy</span>, that clients (i.e. browsers) can use instead of
61       connecting to web servers directly. The clients then ask the proxy to request objects (web pages, images, movies
62       etc) on their behalf and to forward the data to the clients. It is a <span class="QUOTE">"go-between"</span>. For
63       details, see <a href="" target="_top">Wikipedia's proxy
64       definition</a>.</p>
65       <p>There are many reasons to use web proxies, such as security (firewalling), efficiency (caching) and others,
66       and there are any number of proxies to accommodate those needs.</p>
67       <p><span class="APPLICATION">Privoxy</span> is a proxy that is primarily focused on privacy enhancement, ad and
68       junk elimination and freeing the user from restrictions placed on his activities. Sitting between your browser(s)
69       and the Internet, it is in a perfect position to filter outbound personal information that your browser is
70       leaking, as well as inbound junk. It uses a variety of techniques to do this, all of which are under your
71       complete control via the various configuration files and options. Being a proxy also makes it easier to share
72       configurations among multiple browsers and/or users.</p>
73     </div>
74     <div class="SECT2">
75       <h3 class="SECT2"><a name="OTHERSTUFF" id="OTHERSTUFF">1.4. Does Privoxy do anything more than ad
76       blocking?</a></h3>
77       <p>Yes, ad blocking is but one possible use. There are many, many ways <span class="APPLICATION">Privoxy</span>
78       can be used to sanitize and customize web browsing.</p>
79     </div>
80     <div class="SECT2">
81       <h3 class="SECT2"><a name="NEWJB" id="NEWJB">1.5. What is this new version of <span class=
82       "QUOTE">"Junkbuster"</span>?</a></h3>
83       <p>A long time ago, there was the <span class="APPLICATION">Internet Junkbuster</span>, by Anonymous Coders and
84       Junkbusters Corporation. This saved many users a lot of pain in the early days of web advertising and user
85       tracking.</p>
86       <p>But the web, its protocols and standards, and with it, the techniques for forcing ads on users, give up
87       autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the <span class=
88       "APPLICATION">Internet Junkbuster</span> did not. Version 2.0.2, published in 1998, was the last official
89       release, available from Junkbusters Corporation. Fortunately, it had been released under the GNU <a href=
90       "" target="_top">GPL</a>, which allowed further development
91       by others.</p>
92       <p>So Stefan Waldherr started maintaining an improved version of the software, to which eventually a number of
93       people contributed patches. It could already replace banners with a transparent image, and had a first version of
94       pop-up killing, but it was still very closely based on the original, with all its limitations, such as the lack
95       of HTTP/1.1 support, flexible per-site configuration, or content modification. The last release from this effort
96       was version 2.0.2-10, published in 2000.</p>
97       <p>Then, some <a href="" target="_top">developers</a>
98       picked up the thread, and started turning the software inside out, upside down, and then reassembled it, adding
99       many <a href="" target="_top">new features</a>
100       along the way.</p>
101       <p>The result of this is <span class="APPLICATION">Privoxy</span>, whose first stable version, 3.0, was released
102       August, 2002.</p>
103       <p>As of 2012 the Junkbusters Corporation's website ( has been shut down, but Privoxy
104       is still actively maintained.</p>
105     </div>
106     <div class="SECT2">
107       <h3 class="SECT2"><a name="WHYPRIVOXY" id="WHYPRIVOXY">1.6. Why <span class="QUOTE">"Privoxy"</span>? Why change
108       the name from Junkbuster at all?</a></h3>
109       <p>Though outdated, Junkbusters Corporation continued to offer their original version of the <span class=
110       "APPLICATION">Internet Junkbuster</span> for a while, so publishing our <span class=
111       "APPLICATION">Junkbuster</span>-derived software under the same name would have led to confusion.</p>
112       <p>There were also potential legal reasons not to use the <span class="APPLICATION">Junkbuster</span> name, as it
113       was (and maybe still is) a registered trademark of Junkbusters Corporation. There were, however, no objections
114       from Junkbusters Corporation to the <span class="APPLICATION">Privoxy</span> project itself, and they, in fact,
115       shared our ideals and goals.</p>
116       <p>The Privoxy developers also believed that there were so many improvements over the original code, that it was
117       time to make a clean break from the past and make a name in their own right.</p>
118       <p><span class="APPLICATION">Privoxy</span> is the <span class="QUOTE">"<span class="emphasis"><i class=
119       "EMPHASIS">Privacy Enhancing Proxy</i></span>"</span>. Also, its content modification and junk suppression gives
120       <span class="emphasis"><i class="EMPHASIS">you</i></span>, the user, more control, more freedom, and allows you
121       to browse your personal and <span class="QUOTE">"<span class="emphasis"><i class="EMPHASIS">private</i></span>
122       edition"</span> of the web.</p>
123     </div>
124     <div class="SECT2">
125       <h3 class="SECT2"><a name="DIFFERS" id="DIFFERS">1.7. How does Privoxy differ from the old Junkbuster?</a></h3>
126       <p><span class="APPLICATION">Privoxy</span> picks up where <span class="APPLICATION">Junkbuster</span> left off.
127       <span class="APPLICATION">Privoxy</span> still blocks ads and banners, still manages <a href=
128       "" target="_top">cookies</a>, and still helps protect your privacy.
129       But, most of these features have been enhanced, and many new ones have been added, all in the same vein.</p>
130       <p><span class="APPLICATION">Privoxy</span>'s new features include:</p>
131       <ul>
132         <li>
133           <p>Supports "Connection: keep-alive". Outgoing connections can be kept alive independently from the
134           client.</p>
135         </li>
136         <li>
137           <p>Supports IPv6, provided the operating system does so too, and the configure script detects it.</p>
138         </li>
139         <li>
140           <p>Supports tagging which allows to change the behaviour based on client and server headers.</p>
141         </li>
142         <li>
143           <p>Supports https inspection which allows to filter https requests.</p>
144         </li>
145         <li>
146           <p>Can be run as an "intercepting" proxy, which obviates the need to configure browsers individually.</p>
147         </li>
148         <li>
149           <p>Sophisticated actions and filters for manipulating both server and client headers.</p>
150         </li>
151         <li>
152           <p>Can be chained with other proxies.</p>
153         </li>
154         <li>
155           <p>Integrated browser-based configuration and control utility at <a href="" target=
156           "_top"></a> (shortcut: <a href="http://p.p/" target="_top">http://p.p/</a>).
157           Browser-based tracing of rule and filter effects. Remote toggling.</p>
158         </li>
159         <li>
160           <p>Web page filtering (text replacements, removes banners based on size, invisible <span class=
161           "QUOTE">"web-bugs"</span> and HTML annoyances, etc.)</p>
162         </li>
163         <li>
164           <p>Modularized configuration that allows for standard settings and user settings to reside in separate files,
165           so that installing updated actions files won't overwrite individual user settings.</p>
166         </li>
167         <li>
168           <p>Support for Perl Compatible Regular Expressions in the configuration files, and a more sophisticated and
169           flexible configuration syntax.</p>
170         </li>
171         <li>
172           <p>GIF de-animation.</p>
173         </li>
174         <li>
175           <p>Bypass many click-tracking scripts (avoids script redirection).</p>
176         </li>
177         <li>
178           <p>User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page).</p>
179         </li>
180         <li>
181           <p>Auto-detection and re-reading of config file changes.</p>
182         </li>
183         <li>
184           <p>Most features are controllable on a per-site or per-location basis.</p>
185         </li>
186         <li>
187           <p>Many smaller new features added, limitations and bugs removed.</p>
188         </li>
189       </ul>
190     </div>
191     <div class="SECT2">
192       <h3 class="SECT2"><a name="WHATSANAD" id="WHATSANAD">1.8. How does Privoxy know what is an ad, and what is
193       not?</a></h3>
194       <p><span class="APPLICATION">Privoxy</span>'s approach to blocking ads is twofold:</p>
195       <p>First, there are certain patterns in the <span class="emphasis"><i class="EMPHASIS">locations</i></span>
196       (URLs) of banner images. This applies to both the path (you wouldn't guess how many web sites serve their banners
197       from a directory called <span class="QUOTE">"banners"</span>!) and the host (blocking the big banner hosting
198       services like already helps a lot). <span class="APPLICATION">Privoxy</span> takes advantage of
199       this fact by using <a href="../user-manual/actions-file.html#AF-PATTERNS" target="_top">URL patterns</a> to sort
200       out and block the requests for things that sound like they would be ads or banners.</p>
201       <p>Second, banners tend to come in certain <span class="emphasis"><i class="EMPHASIS">sizes</i></span>. But you
202       can't tell the size of an image by its URL without downloading it, and if you do, it's too late to save
203       bandwidth. Therefore, <span class="APPLICATION">Privoxy</span> also inspects the HTML sources of web pages while
204       they are loaded, and replaces references to images with standard banner sizes by dummy references, so that your
205       browser doesn't request them anymore in the first place.</p>
206       <p>Both of this involves a certain amount of guesswork and is, of course, freely and readily configurable.</p>
207     </div>
208     <div class="SECT2">
209       <h3 class="SECT2"><a name="MISTAKES" id="MISTAKES">1.9. Can Privoxy make mistakes? This does not sound very
210       scientific.</a></h3>
211       <p>Actually, it's a black art ;-) And yes, it is always possible to have a broad rule accidentally block or
212       change something by mistake. You will almost surely run into such situations at some point. It is tricky writing
213       rules to cover every conceivable possibility, and not occasionally get false positives.</p>
214       <p>But this should not be a big concern since the <span class="APPLICATION">Privoxy</span> configuration is very
215       flexible, and includes tools to help identify these types of situations so they can be addressed as needed,
216       allowing you to customize your installation. (<a href="trouble.html#BADSITE">See the Troubleshooting section
217       below</a>.)</p>
218     </div>
219     <div class="SECT2">
220       <h3 class="SECT2"><a name="CONFIGORNOT" id="CONFIGORNOT">1.10. Will I have to configure Privoxy before I can use
221       it?</a></h3>
222       <p>That depends on your expectations. The default installation should give you a good starting point, and block
223       <span class="emphasis"><i class="EMPHASIS">most</i></span> ads and unwanted content, but many of the more
224       advanced features are off by default, and require you to activate them.</p>
225       <p>You do have to set up your browser to use <span class="APPLICATION">Privoxy</span> (see the <a href=
226       "installation.html#FIRSTSTEP">Installation section below</a>).</p>
227       <p>And you will certainly run into situations where there are false positives, or ads not being blocked that you
228       may not want to see. In these cases, you would certainly benefit by customizing <span class=
229       "APPLICATION">Privoxy's</span> configuration to more closely match your individual situation. And we encourage
230       you to do this. This is where the real power of <span class="APPLICATION">Privoxy</span> lies!</p>
231     </div>
232     <div class="SECT2">
233       <h3 class="SECT2"><a name="LAN" id="LAN">1.11. Can Privoxy run as a server on a network?</a></h3>
234       <p>Yes, <span class="APPLICATION">Privoxy</span> runs as a server already, and can easily be configured to
235       <span class="QUOTE">"serve"</span> more than one client. See <a href="configuration.html#LANCONFIG">How can I set
236       up Privoxy to act as a proxy for my LAN</a> below.</p>
237     </div>
238     <div class="SECT2">
239       <h3 class="SECT2"><a name="BROWSERS2" id="BROWSERS2">1.12. My browser does the same things as Privoxy. Why should
240       I use Privoxy at all?</a></h3>
241       <p>Modern browsers do indeed have <span class="emphasis"><i class="EMPHASIS">some</i></span> of the same
242       functionality as <span class="APPLICATION">Privoxy</span>. Maybe this is adequate for you. But <span class=
243       "APPLICATION">Privoxy</span> is very versatile and powerful, and can probably do a number of things your browser
244       just can't.</p>
245       <p>In addition, a proxy is good choice if you use multiple browsers, or have a LAN with multiple computers since
246       <span class="APPLICATION">Privoxy</span> can run as a server application. This way all the configuration is in
247       one place, and you don't have to maintain a similar configuration for possibly many browsers or users.</p>
248       <p>Note, however, that it's recommended to leverage both your browser's and <span class=
249       "APPLICATION">Privoxy's</span> privacy enhancing features at the same time. While your browser probably lacks
250       some features <span class="APPLICATION">Privoxy</span> offers, it should also be able to do some things more
251       reliably, for example restricting and suppressing JavaScript.</p>
252     </div>
253     <div class="SECT2">
254       <h3 class="SECT2"><a name="WHYTRUST" id="WHYTRUST">1.13. Why should I trust Privoxy?</a></h3>
255       <p>The most important reason is because you have access to <span class="emphasis"><i class=
256       "EMPHASIS">everything</i></span>, and you can control everything. You can check every line of every configuration
257       file yourself. You can check every last bit of source code should you desire. And even if you can't read code,
258       there should be some comfort in knowing that other people can, and do read it. You can build the software from
259       scratch, if you want, so that you know the executable is clean, and that it is <span class="emphasis"><i class=
260       "EMPHASIS">yours</i></span>. In fact, we encourage this level of scrutiny. It is one reason we use <span class=
261       "APPLICATION">Privoxy</span> ourselves.</p>
262     </div>
263     <div class="SECT2">
264       <h3 class="SECT2"><a name="LICENSE" id="LICENSE">1.14. Is there is a license or fee? What about a warranty?
265       Registration?</a></h3>
266       <p><span class="APPLICATION">Privoxy</span> is free software and licensed under the <a href=
267       "" target="_top">GNU General Public License (GPL) version
268       2</a>. It is free to use, copy, modify or distribute as you wish under the terms of this license. Please see the
269       <a href="copyright.html">Copyright</a> section for more information on the license and copyright. Or the
270       <tt class="FILENAME">LICENSE</tt> file that should be included.</p>
271       <p>There is <span class="emphasis"><i class="EMPHASIS">no warranty</i></span> of any kind, expressed, implied or
272       otherwise. That is something that would cost real money ;-) There is no registration either.</p>
273     </div>
274     <div class="SECT2">
275       <h3 class="SECT2"><a name="SPYWARE" id="SPYWARE">1.15. Can Privoxy remove spyware? Adware? Viruses?</a></h3>
276       <p>No, at least not reliably enough to trust it. <span class="APPLICATION">Privoxy</span> is not designed to be a
277       malware removal tool and the default configuration doesn't even try to filter out any malware.</p>
278       <p><span class="APPLICATION">Privoxy</span> could help prevent contact from (known) sites that use such tactics
279       with appropriate configuration rules, and thus could conceivably prevent contamination from such sites. However,
280       keeping such a configuration up to date would require a lot of time and effort that would be better spend on
281       keeping your software itself up to date so it doesn't have known vulnerabilities.</p>
282     </div>
283     <div class="SECT2">
284       <h3 class="SECT2"><a name="OTHERADS" id="OTHERADS">1.16. Can I use Privoxy with other ad-blocking
285       software?</a></h3>
286       <p><span class="APPLICATION">Privoxy</span> should work fine with other proxies and other software in
287       general.</p>
288       <p>But it is probably not necessary to use <span class="APPLICATION">Privoxy</span> in conjunction with other
289       ad-blocking products, and this could conceivably cause undesirable results. It might be better to choose one
290       software or the other and work a little to tweak its configuration to your liking.</p>
291       <p>Note that this is an advice specific to ad blocking.</p>
292     </div>
293     <div class="SECT2">
294       <h3 class="SECT2"><a name="HELP-THE-DEVELOPERS" id="HELP-THE-DEVELOPERS">1.17. I would like to help you, what can
295       I do?</a></h3>
296       <div class="SECT3">
297         <h4 class="SECT3"><a name="PARTICIPATE" id="PARTICIPATE">1.17.1. Would you like to participate?</a></h4>
298         <p>Well, we <span class="emphasis"><i class="EMPHASIS">always</i></span> need help. There is something for
299         everybody who wants to help us. We welcome new developers, packagers, testers, documentation writers or really
300         anyone with a desire to help in any way. You <span class="emphasis"><i class="EMPHASIS">DO NOT</i></span> need
301         to be a <span class="QUOTE">"programmer"</span>. There are many other tasks available. In fact, the programmers
302         often can't spend as much time programming because of some of the other, more mundane things that need to be
303         done, like checking the Tracker feedback sections or responding to user questions on the mailing lists.</p>
304         <p>So first thing, subscribe to the <a href="" target=
305         "_top">Privoxy Users</a> or the <a href="" target=
306         "_top">Privoxy Developers</a> mailing list, join the discussion, help out other users, provide general feedback
307         or report problems you noticed.</p>
308         <p>If you intend to help out with the trackers, you also might want to <a href=
309         "" target="_top">get an account on</a> so we don't
310         confuse you with the other name-less users.</p>
311         <p>We also have a <a href="../developer-manual/index.html" target="_top">Developer's Manual</a>. While it is
312         partly out of date, it's still worth reading.</p>
313         <p>Our <a href=";a=blob_plain;f=TODO;hb=HEAD" target="_top">TODO
314         list</a> may be of interest to you as well. Please let us know if you want to work on one of the items
315         listed.</p>
316       </div>
317       <div class="SECT3">
318         <h4 class="SECT3"><a name="DONATE" id="DONATE">1.17.2. Would you like to donate?</a></h4>
319         <p>Donations are welcome. Our <a href=
320         ";a=blob_plain;f=TODO;hb=HEAD" target="_top">TODO list</a> is
321         rather long and being able to pay one (or more) developers to work on Privoxy would make a huge difference,
322         even if it was only for a couple of weeks. Donations may also be used for Privoxy-related travel expenses (for
323         example to attend conferences), for hardware used for Privoxy development and for hosting expenses etc.</p>
324         <p><span class="APPLICATION">Privoxy</span> is an associated project of <a href=""
325         target="_top">Software in the Public Interest (SPI)</a>, which allows us to receive tax-deductible donations in
326         the United States. You can <a href="" target="_top">donate via
327         Paypal</a> and <a href="" target="_top">Click
328         &#38; Pledge</a>. For details, please have a look at <a href="" target=
329         "_top">SPI's general donation page</a>.</p>
330         <p>If you have any questions regarding donations please mail to either the public user mailing list or, if it's
331         a private matter, to <a href="" target="_top">Fabian Keil</a> (Privoxy's SPI liaison)
332         directly.</p>
333       </div>
334     </div>
335     <div class="SECT2">
336       <h2 class="SECT2"><a name="SPONSOR" id="SPONSOR">1.18. How can I become a sponsor and get my logo or link on
338       <p>We are currently offering the following sponsor levels as an experiment:</p>
339       <div class="VARIABLELIST">
340         <dl>
341           <dt>Gold (12000 USD/year)</dt>
342           <dd>
343             <p>Logo or text link shown at the bottom of the <a href="" target="_top">Privoxy
344             homepage</a>. Logo, link and self description on the <a href="" target=
345             "_top">sponsor page</a>.</p>
346           </dd>
347           <dt>Silver (1200 USD/year)</dt>
348           <dd>
349             <p>Logo or text link shown at the bottom of the <a href="" target="_top">Privoxy
350             homepage</a>. Logo, link and self description on the <a href="" target=
351             "_top">sponsor page</a>.</p>
352           </dd>
353           <dt>Bronze (600 USD/year)</dt>
354           <dd>
355             <p>Logo and link on the <a href="" target="_top">sponsor page</a>.</p>
356           </dd>
357         </dl>
358       </div>
359       <p>The logo sizes depend on the sponsor level. Logos are served from our server, no requests are made to the
360       sponsor website unless the links are being used.</p>
361       <p>The details may change over time but changes will only affect new sponsors (or existing sponsors that
362       explicitly agreed to the changes).</p>
363       <p>If you want to become a sponsor, please contact <a href="" target="_top">Fabian
364       Keil</a>. New sponsors are only accepted if no developer objects.</p>
365     </div>
366   </div>
367   <div class="NAVFOOTER">
368     <hr align="left" width="100%">
369     <table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
370       <tr>
371         <td width="33%" align="left" valign="top"><a href="index.html" accesskey="P">Prev</a></td>
372         <td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">Home</a></td>
373         <td width="33%" align="right" valign="top"><a href="installation.html" accesskey="N">Next</a></td>
374       </tr>
375       <tr>
376         <td width="33%" align="left" valign="top">Privoxy Frequently Asked Questions</td>
377         <td width="34%" align="center" valign="top">&nbsp;</td>
378         <td width="33%" align="right" valign="top">Installation</td>
379       </tr>
380     </table>
381   </div>
382 </body>
383 </html>