114d424d44ccb0f28bd6725fb1f8bc0d5ce66574
[privoxy.git] / doc / webserver / faq / general.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >General Information</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
8 REL="HOME"
9 TITLE="Privoxy Frequently Asked Questions"
10 HREF="index.html"><LINK
11 REL="PREVIOUS"
12 TITLE="Privoxy Frequently Asked Questions"
13 HREF="index.html"><LINK
14 REL="NEXT"
15 TITLE="Installation"
16 HREF="installation.html"><LINK
17 REL="STYLESHEET"
18 TYPE="text/css"
19 HREF="../p_doc.css"></HEAD
20 ><BODY
21 CLASS="SECT1"
22 BGCOLOR="#EEEEEE"
23 TEXT="#000000"
24 LINK="#0000FF"
25 VLINK="#840084"
26 ALINK="#0000FF"
27 ><DIV
28 CLASS="NAVHEADER"
29 ><TABLE
30 WIDTH="100%"
31 BORDER="0"
32 CELLPADDING="0"
33 CELLSPACING="0"
34 ><TR
35 ><TH
36 COLSPAN="3"
37 ALIGN="center"
38 >Privoxy Frequently Asked Questions</TH
39 ></TR
40 ><TR
41 ><TD
42 WIDTH="10%"
43 ALIGN="left"
44 VALIGN="bottom"
45 ><A
46 HREF="index.html"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="installation.html"
60 >Next</A
61 ></TD
62 ></TR
63 ></TABLE
64 ><HR
65 ALIGN="LEFT"
66 WIDTH="100%"></DIV
67 ><DIV
68 CLASS="SECT1"
69 ><H1
70 CLASS="SECT1"
71 ><A
72 NAME="GENERAL"
73 >1. General Information</A
74 ></H1
75 ><DIV
76 CLASS="SECT2"
77 ><H3
78 CLASS="SECT2"
79 ><A
80 NAME="NEWJB"
81 >1.1. What is this new version of <SPAN
82 CLASS="APPLICATION"
83 >Privoxy</SPAN
84 >?</A
85 ></H3
86 ><P
87 > In the beginning, there was the
88  <A
89 HREF="http://www.junkbusters.com/ijb.html"
90 TARGET="_top"
91 ><SPAN
92 CLASS="APPLICATION"
93 >Internet Junkbuster</SPAN
94 ></A
95 >, 
96  by Anonymous Coders and <A
97 HREF="http://www.junkbusters.com/"
98 TARGET="_top"
99 >Junkbusters
100  Corporation</A
101 >. It saved many users a lot of pain in the early days of
102  web advertising and user tracking.</P
103 ><P
104 > But the web, its protocols and standards, and with it, the techniques for
105  forcing  users to consume ads, give up autonomy over their browsing, and
106  for spying on them, kept evolving. Unfortunately, the <SPAN
107 CLASS="APPLICATION"
108 >Internet
109  Junkbuster</SPAN
110 > did not. Version 2.0.2, published in 1998, was 
111  (and is) the last official
112  <A
113 HREF="http://www.junkbusters.com/ijbdist.html#release"
114 TARGET="_top"
115 >release</A
116 >
117  available from <A
118 HREF="http://www.junkbusters.com"
119 TARGET="_top"
120 >Junkbusters Corporation</A
121 >.
122  Fortunately, it had been released under the GNU
123  <A
124 HREF="http://www.gnu.org/licenses/gpl.html"
125 TARGET="_top"
126 > GPL</A
127 >, which allowed further
128  development by others.</P
129 ><P
130 > So Stefan Waldherr started maintaining an
131  <A
132 HREF="http://www.waldherr.org/junkbuster/"
133 TARGET="_top"
134 >improved version of the
135  software</A
136 >, to which eventually a number of people contributed patches.
137  It could already replace banners with a transparent image, and had a first
138  version of pop-up killing, but it was still very closely based on the
139  original, with all its limitations, such as the lack of HTTP/1.1 support,
140  flexible per-site configuration, or content modification. The last release
141  from this effort was version 2.0.2-10, published in 2000.</P
142 ><P
143 > Then, some
144  <A
145 HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS"
146 TARGET="_top"
147 >developers</A
148 >
149  picked up the thread, and started turning the software inside out, upside down,
150  and then reassembled it, adding many
151  <A
152 HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES"
153 TARGET="_top"
154 >new
155  features</A
156 > along the way.</P
157 ><P
158 > The result of this is <SPAN
159 CLASS="APPLICATION"
160 >Privoxy</SPAN
161 >, whose first
162  stable release, 3.0, is due late summer or early fall 2002. 
163  </P
164 ></DIV
165 ><DIV
166 CLASS="SECT2"
167 ><H3
168 CLASS="SECT2"
169 ><A
170 NAME="AEN45"
171 >1.2. Why <SPAN
172 CLASS="QUOTE"
173 >"Privoxy"</SPAN
174 >? Why a name change at all?</A
175 ></H3
176 ><P
177 > <SPAN
178 CLASS="APPLICATION"
179 >Privoxy</SPAN
180 > is the 
181  <SPAN
182 CLASS="QUOTE"
183 >"<I
184 CLASS="EMPHASIS"
185 >Privacy Enhancing Proxy</I
186 >"</SPAN
187 >. Also, its content
188  modification and junk suppression allow you to browse your
189  <SPAN
190 CLASS="QUOTE"
191 >"<I
192 CLASS="EMPHASIS"
193 >private</I
194 > edition"</SPAN
195 > of the web.</P
196 ><P
197 > <A
198 HREF="http://junkbusters.com/"
199 TARGET="_top"
200 >Junkbusters Corporation</A
201 >
202  continues to offer their original version of the <SPAN
203 CLASS="APPLICATION"
204 >Internet
205  Junkbuster</SPAN
206 >, so publishing our
207  <SPAN
208 CLASS="APPLICATION"
209 > Junkbuster</SPAN
210 >-derived software under the same name
211  led to confusion.</P
212 ><P
213 > There are also potential legal complications from the continued use of the 
214  <SPAN
215 CLASS="APPLICATION"
216 >Junkbuster</SPAN
217 > name, which is a registered trademark of 
218  <A
219 HREF="http://junkbusters.com/"
220 TARGET="_top"
221 >Junkbusters Corporation</A
222 >.
223  There are, however, no objections from Junkbusters Corporation to the 
224  <SPAN
225 CLASS="APPLICATION"
226 >Privoxy</SPAN
227 > project itself, and they, in fact, still
228  share our ideals and goals.</P
229 ><P
230 > The developers also believed that there are so many changes from the original 
231  code, that it was time to make a clean break from the past and make 
232  a name in their own right, especially now with the pending
233  release of version 3.0.</P
234 ></DIV
235 ><DIV
236 CLASS="SECT2"
237 ><H3
238 CLASS="SECT2"
239 ><A
240 NAME="DIFFERS"
241 >1.3. How does <SPAN
242 CLASS="APPLICATION"
243 >Privoxy</SPAN
244 > differ
245 from the old <SPAN
246 CLASS="APPLICATION"
247 >Junkbuster?</SPAN
248 ></A
249 ></H3
250 ><P
251 > <SPAN
252 CLASS="APPLICATION"
253 >Privoxy</SPAN
254 > picks up where
255  <SPAN
256 CLASS="APPLICATION"
257 >Junkbuster</SPAN
258 > left off. All the old features remain.
259  The new <SPAN
260 CLASS="APPLICATION"
261 >Privoxy</SPAN
262 > still blocks ads and banners,
263  still manages cookies, and still helps protect your privacy. But, these are
264  all enhanced, and many new features have been added, all in the same vein.
265  </P
266 ><P
267 > The configuration has changed significantly as well. This is something that
268  users will notice right off the bat if upgrading from 
269  <SPAN
270 CLASS="APPLICATION"
271 >Junkbuster</SPAN
272 > 2.0.x. The <SPAN
273 CLASS="QUOTE"
274 >"blocklist"</SPAN
275 >
276  <SPAN
277 CLASS="QUOTE"
278 >"cookielist"</SPAN
279 >, <SPAN
280 CLASS="QUOTE"
281 >"imagelist"</SPAN
282 > and much more has been
283  combined into the <SPAN
284 CLASS="QUOTE"
285 >"actions"</SPAN
286 > files, with a completely different
287  syntax. See the <A
288 HREF="../user-manual/upgradersnote.html"
289 TARGET="_top"
290 >note to
291  upgraders</A
292 > for  details.</P
293 ><P
294 > <SPAN
295 CLASS="APPLICATION"
296 >Privoxy</SPAN
297 >'s new features include:</P
298 ><P
299 > <P
300 ></P
301 ><UL
302 ><LI
303 ><P
304 >   Integrated browser based configuration and control utility at <A
305 HREF="http://config.privoxy.org/"
306 TARGET="_top"
307 >http://config.privoxy.org/</A
308 >
309    (shortcut: <A
310 HREF="http://p.p/"
311 TARGET="_top"
312 >http://p.p/</A
313 >). Browser-based
314    tracing of rule and filter effects. Remote toggling.
315   </P
316 ></LI
317 ><LI
318 ><P
319 >   Web page content filtering (removes banners based on size,
320    invisible <SPAN
321 CLASS="QUOTE"
322 >"web-bugs"</SPAN
323 >, JavaScript and HTML annoyances, pop-up windows, etc.)
324   </P
325 ></LI
326 ><LI
327 ><P
328 >   Modularized configuration that allows for standard settings and
329    user settings to reside in separate files, so that installing updated
330    actions files won't overwrite individual user settings.
331   </P
332 ></LI
333 ><LI
334 ><P
335 >   HTTP/1.1 compliant (but not all optional 1.1 features are supported).
336   </P
337 ></LI
338 ><LI
339 ><P
340 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
341    generally a more sophisticated and flexible configuration syntax over
342    previous versions.
343   </P
344 ></LI
345 ><LI
346 ><P
347 >   Improved cookie management features (e.g. session based cookies).
348   </P
349 ></LI
350 ><LI
351 ><P
352 >   GIF de-animation. 
353   </P
354 ></LI
355 ><LI
356 ><P
357 >   Bypass many click-tracking scripts (avoids script redirection).
358   </P
359 ></LI
360 ><LI
361 ><P
362 >   Multi-threaded (POSIX and native threads).
363   </P
364 ></LI
365 ><LI
366 ><P
367 >   User-customizable HTML templates for all proxy-generated pages (e.g. "blocked" page).
368   </P
369 ></LI
370 ><LI
371 ><P
372 >   Auto-detection and re-reading of config file changes.
373   </P
374 ></LI
375 ><LI
376 ><P
377 >   Improved signal handling, and a true daemon mode (Unix).
378   </P
379 ></LI
380 ><LI
381 ><P
382 >   Every feature now controllable on a per-site or per-location basis, configuration
383    more powerful and versatile over-all.
384   </P
385 ></LI
386 ><LI
387 ><P
388 >   Many smaller new features added, limitations and bugs removed, and security holes fixed.
389   </P
390 ></LI
391 ></UL
392 ></P
393 ></DIV
394 ><DIV
395 CLASS="SECT2"
396 ><H3
397 CLASS="SECT2"
398 ><A
399 NAME="PROXYMORON"
400 >1.4. What is a <SPAN
401 CLASS="QUOTE"
402 >"proxy"</SPAN
403 >? How does
404 <SPAN
405 CLASS="APPLICATION"
406 >Privoxy</SPAN
407 > work?</A
408 ></H3
409 ><P
410 >  A web proxy is a service, based on a software such as <SPAN
411 CLASS="APPLICATION"
412 >Privoxy</SPAN
413 >,
414   that clients (i.e. browsers) can use instead of connecting directly to the web
415   servers on the Internet. The clients then ask the proxy to fetch the objects
416   they need (web pages, images, movies etc) on their behalf, and when the proxy
417   has done so, it hands the results back to the client.
418  </P
419 ><P
420 >  There are many reasons to use web proxies, such as security (firewalling),
421   efficiency (caching) and others, and there are just as many different proxies
422   to accommodate those needs.
423  </P
424 ><P
425 >  <SPAN
426 CLASS="APPLICATION"
427 >Privoxy</SPAN
428 > is a proxy that is solely focused on privacy
429   protection and junk elimination. Sitting between your browser(s) and the Internet,
430   it is in a perfect position to filter outbound personal information that your
431   browser is leaking, as well as inbound junk. It uses a variety of techniques to do
432   this, all of which are under your control via the various configuration
433   files and options.
434  </P
435 ></DIV
436 ><DIV
437 CLASS="SECT2"
438 ><H3
439 CLASS="SECT2"
440 ><A
441 NAME="WHATSANAD"
442 >1.5. How does <SPAN
443 CLASS="APPLICATION"
444 >Privoxy</SPAN
445 > know what is
446 an ad, and what is not?</A
447 ></H3
448 ><P
449 > <SPAN
450 CLASS="APPLICATION"
451 >Privoxy</SPAN
452 >'s approach to blocking ads is twofold:</P
453 ><P
454 > First, there are certain patterns in the <I
455 CLASS="EMPHASIS"
456 >locations</I
457 > (URLs)
458  of banner images. This applies to both the path (you wouldn't guess how many
459  web sites serve their banners from a directory called <SPAN
460 CLASS="QUOTE"
461 >"banners"</SPAN
462 >!)
463  and the host (blocking the big banner hosting services like doublecklick.net
464  already helps a lot). <SPAN
465 CLASS="APPLICATION"
466 >Privoxy</SPAN
467 > takes advantage of this
468  fact by using <A
469 HREF="../user-manual/actions-file.html#AF-PATTERNS"
470 TARGET="_top"
471 >URL
472  patterns</A
473 > to sort out and block the requests for banners.</P
474 ><P
475 > Second, banners tend to come in certain <I
476 CLASS="EMPHASIS"
477 >sizes</I
478 >. But you
479  can't tell the size of an image by its URL without downloading it, and if you
480  do, it's too late to save bandwidth. Therefore, <SPAN
481 CLASS="APPLICATION"
482 >Privoxy</SPAN
483 >
484  also inspects the HTML sources of web pages while they are loaded, and replaces
485  references to images with standard banner sizes by dummy references, so that
486  your browser doesn't request them anymore in the first place.</P
487 ><P
488 > Both of this involves a certain amount of guesswork and is, of course, freely
489  configurable.</P
490 ></DIV
491 ><DIV
492 CLASS="SECT2"
493 ><H3
494 CLASS="SECT2"
495 ><A
496 NAME="AEN136"
497 >1.6. Can <SPAN
498 CLASS="APPLICATION"
499 >Privoxy</SPAN
500 > make mistakes? 
501 This does not sound very scientific.</A
502 ></H3
503 ><P
504 > Actually, it's a black art ;-) And yes, it is always possible to have a broad
505  rule accidentally block or change something by mistake. There is a good chance
506  you may run into such a situation at some point. It is tricky writing rules to
507  cover every conceivable possibility, and not occasionally get false positives.</P
508 ><P
509 > But this should not be a big concern since the
510  <SPAN
511 CLASS="APPLICATION"
512 >Privoxy</SPAN
513 > configuration is very flexible, and
514  includes tools to help identify these types of situations so they can be
515  addressed as needed, allowing you to customize your installation.
516  (<A
517 HREF="trouble.html#AEN748"
518 >See the Troubleshooting section below</A
519 >.)</P
520 ></DIV
521 ><DIV
522 CLASS="SECT2"
523 ><H3
524 CLASS="SECT2"
525 ><A
526 NAME="BROWSERS2"
527 >1.7. My browser does the same things as
528 <SPAN
529 CLASS="APPLICATION"
530 >Privoxy</SPAN
531 >. Why should I use
532 <SPAN
533 CLASS="APPLICATION"
534 >Privoxy</SPAN
535 > at all?</A
536 ></H3
537 ><P
538 >  Modern browsers do indeed have <I
539 CLASS="EMPHASIS"
540 >some</I
541 > of the same
542   functionality as <SPAN
543 CLASS="APPLICATION"
544 >Privoxy</SPAN
545 >. Maybe this is
546   adequate for you. But <SPAN
547 CLASS="APPLICATION"
548 >Privoxy</SPAN
549 > is much more
550   versatile and powerful, and can do a number of things that browsers just can't.
551  </P
552 ><P
553 >  In addition, a proxy is good choice if you use multiple browsers, or 
554   have a LAN with multiple computers. This way all the configuration 
555   is in one place, and you don't have to maintain a similar configuration 
556   for possibly many browsers.
557  </P
558 ></DIV
559 ><DIV
560 CLASS="SECT2"
561 ><H3
562 CLASS="SECT2"
563 ><A
564 NAME="LICENSE"
565 >1.8. Is there is a license or fee? What about a 
566 warranty? Registration?</A
567 ></H3
568 ><P
569 >  <SPAN
570 CLASS="APPLICATION"
571 >Privoxy</SPAN
572 > is licensed under the <A
573 HREF="http://www.gnu.org/copyleft/gpl.html"
574 TARGET="_top"
575 >GNU General Public License (GPL)</A
576 >.
577   It is free to use, copy, modify or distribute as you wish under the terms of this
578   license.  Please see the <A
579 HREF="copyright.html"
580 >Copyright</A
581 > section for more
582   information on the license and copyright. Or the <TT
583 CLASS="FILENAME"
584 >LICENSE</TT
585 > file 
586   that should be included.
587  </P
588 ><P
589 >  There is <I
590 CLASS="EMPHASIS"
591 >no warranty</I
592 > of any kind, expressed, implied or otherwise.
593   That is something that would cost real money ;-) There is no registration either.
594   <SPAN
595 CLASS="APPLICATION"
596 >Privoxy</SPAN
597 > really is <I
598 CLASS="EMPHASIS"
599 >free</I
600 >
601   in every respect!
602  </P
603 ></DIV
604 ><DIV
605 CLASS="SECT2"
606 ><H3
607 CLASS="SECT2"
608 ><A
609 NAME="JOINTEAM"
610 >1.9. I would like to help you, what do I do?</A
611 ></H3
612 ><DIV
613 CLASS="SECT3"
614 ><H4
615 CLASS="SECT3"
616 ><A
617 NAME="JOINTEAM-MONEY"
618 >1.9.1. Money Money Money</A
619 ></H4
620 ><P
621 > We, of course, welcome donations and could use money for domain registering,
622  buying software to test <SPAN
623 CLASS="APPLICATION"
624 >Privoxy</SPAN
625 > with, and, of course,
626  for regular world-wide get-togethers (hahaha). If you enjoy the software and feel
627  like helping us with a donation, just <A
628 HREF="mailto:developers@privoxy.org"
629 TARGET="_top"
630 >drop us a note</A
631 >.</P
632 ></DIV
633 ><DIV
634 CLASS="SECT3"
635 ><H4
636 CLASS="SECT3"
637 ><A
638 NAME="JOINTEAM-SOFTWARE"
639 >1.9.2. Software</A
640 ></H4
641 ><P
642 > If you are a vendor of a web-related software like a browser, web server
643  or proxy, and would like us to ensure that <SPAN
644 CLASS="APPLICATION"
645 >Privoxy</SPAN
646 >
647  runs smoothly with your product, you might consider supplying us with a
648  copy or license. We can't, however, guarantee that we will fix all potential
649  compatibility issues as a result.</P
650 ></DIV
651 ><DIV
652 CLASS="SECT3"
653 ><H4
654 CLASS="SECT3"
655 ><A
656 NAME="JOINTEAM-WORK"
657 >1.9.3. You want to work with us?</A
658 ></H4
659 ><P
660 >   Well, helping the team is always a good idea. We welcome new developers,
661    packaging gurus or documentation writers. Simply <A
662 HREF="https://sourceforge.net/account/register.php"
663 TARGET="_top"
664 >get an account on SourceForge.net</A
665 >
666    and mail your id to the <A
667 HREF="mailto:developers@privoxy.org"
668 TARGET="_top"
669 >developers
670    mailing list</A
671 >. Then read the <A
672 HREF="../developer-manual/index.html"
673 TARGET="_top"
674 >Developer's Manual</A
675 >.</P
676 ><P
677 > Once we have added you to the team, you'll have write access to the <A
678 HREF="http://sourceforge.net/cvs/?group_id=11118"
679 TARGET="_top"
680 >CVS repository</A
681 >, and
682  together we'll find a suitable task for you.</P
683 ></DIV
684 ></DIV
685 ></DIV
686 ><DIV
687 CLASS="NAVFOOTER"
688 ><HR
689 ALIGN="LEFT"
690 WIDTH="100%"><TABLE
691 WIDTH="100%"
692 BORDER="0"
693 CELLPADDING="0"
694 CELLSPACING="0"
695 ><TR
696 ><TD
697 WIDTH="33%"
698 ALIGN="left"
699 VALIGN="top"
700 ><A
701 HREF="index.html"
702 >Prev</A
703 ></TD
704 ><TD
705 WIDTH="34%"
706 ALIGN="center"
707 VALIGN="top"
708 ><A
709 HREF="index.html"
710 >Home</A
711 ></TD
712 ><TD
713 WIDTH="33%"
714 ALIGN="right"
715 VALIGN="top"
716 ><A
717 HREF="installation.html"
718 >Next</A
719 ></TD
720 ></TR
721 ><TR
722 ><TD
723 WIDTH="33%"
724 ALIGN="left"
725 VALIGN="top"
726 >Privoxy Frequently Asked Questions</TD
727 ><TD
728 WIDTH="34%"
729 ALIGN="center"
730 VALIGN="top"
731 >&nbsp;</TD
732 ><TD
733 WIDTH="33%"
734 ALIGN="right"
735 VALIGN="top"
736 >Installation</TD
737 ></TR
738 ></TABLE
739 ></DIV
740 ></BODY
741 ></HTML
742 >