1 Privoxy Frequently Asked Questions
3 Copyright © 2001, 2002 by Privoxy Developers
5 $Id: faq.sgml,v 1.61.2.15 2002/08/10 11:34:22 oes Exp $
8 This FAQ gives quick answers to frequently asked questions about Privoxy. It
9 can't and doesn't replace the User Manual.
11 Privoxy is a web proxy with advanced filtering capabilities for protecting
12 privacy, filtering web page content, managing cookies, controlling access, and
13 removing ads, banners, pop-ups and other obnoxious Internet junk. Privoxy has a
14 very flexible configuration and can be customized to suit individual needs and
15 tastes. Privoxy has application for both stand-alone systems and multi-user
18 Privoxy is based on Internet Junkbuster (tm).
20 Please note that this document is constantly evolving. This copy represents the
21 state at the release of version 2.9.20. You can find the latest version of the
22 document at http://www.privoxy.org/faq/. Please see the Contact section if you
23 want to contact the developers.
25 -------------------------------------------------------------------------------
27 1. General Information
28 1.1. What is this new version of Privoxy?
29 1.2. Why "Privoxy"? Why a name change at all?
30 1.3. How does Privoxy differ from the old Junkbuster?
31 1.4. What is a "proxy"? How does Privoxy work?
32 1.5. How does Privoxy know what is an ad, and what is not?
33 1.6. Can Privoxy make mistakes? This does not sound very scientific.
34 1.7. My browser does the same things as Privoxy. Why should I use Privoxy
36 1.8. Is there is a license or fee? What about a warranty? Registration?
37 1.9. I would like to help you, what do I do?
38 1.9.1. Money Money Money
40 1.9.3. You want to work with us?
46 2.1. Which browsers are supported by Privoxy?
47 2.2. Which operating systems are supported?
48 2.3. Can I install Privoxy over Junkbuster?
49 2.4. I just installed Privoxy. Is there anything special I have to do now?
50 2.5. What is the proxy address of Privoxy?
51 2.6. I just installed Privoxy, and nothing is happening. All the ads are
56 3.1. Where can I get updated Actions Files?
57 3.2. Can I use my old config files?
58 3.3. What is an "actions" file?
59 3.4. The "actions" concept confuses me. Please list some of these "actions"
61 3.5. How are actions files configured? What is the easiest way to do this?
62 3.6. There are several different "actions" files. What are the differences?
63 3.7. How can I make my Yahoo/Hotmail/GMX account work?
64 3.8. What's the difference between the "Cautious", "Medium" and "Advanced"
66 3.9. Why can I change the configuration with a browser? Does that not raise
68 3.10. What is the default.filter file? What is a "filter"?
69 3.11. How can I set up Privoxy to act as a proxy for my LAN?
70 3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see
72 3.13. Why would anybody want to see a checkerboard pattern?
73 3.14. I see some images being replaced by a text instead of the
74 checkerboard image. Why and how do I get rid of this?
75 3.15. Can Privoxy run as a service on Win2K/NT?
76 3.16. How can I make Privoxy work with other proxies like Squid?
77 3.17. Can Privoxy run as a "transparent" proxy?
81 4.1. How much does Privoxy slow my browsing down? This has to add extra
83 4.2. I noticed considerable delays in page requests compared to the old
84 Junkbuster. What's wrong?
85 4.3. What are "http://config.privoxy.org/" and "http://p.p/"?
86 4.4. Do you still maintain the blocklists?
87 4.5. How can I submit new ads?
88 4.6. How can I hide my IP address?
89 4.7. Can Privoxy guarantee I am anonymous?
90 4.8. Might some things break because header information or content is being
92 4.9. Can Privoxy act as a "caching" proxy to speed up web browsing?
93 4.10. What about as a firewall? Can Privoxy protect me?
94 4.11. I have large empty spaces / a checkerboard pattern now where ads used
96 4.12. How can Privoxy filter Secure (HTTPS) URLs?
97 4.13. Privoxy runs as a "server". How secure is it? Do I need to take any
99 4.14. How can I temporarily disable Privoxy?
100 4.15. When "disabled" is Privoxy totally out of the picture?
101 4.16. Where can I find more information about Privoxy and related issues?
105 5.1. I just upgraded and am getting "connection refused" with every web
107 5.2. I just added a new rule, but the steenkin ad is still getting through.
109 5.3. One of my favorite sites does not work with Privoxy. What can I do?
110 5.4. After installing Privoxy, I have to log in every time I start IE. What
112 5.5. I cannot connect to any FTP sites. Privoxy seems to be blocking me.
113 5.6. In Mac OSX, I can't configure Microsoft Internet Explorer to use
114 Privoxy as the HTTP proxy.
115 5.7. In Mac OSX, I dragged the Privoxy folder to the trash in order to
116 uninstall it. Now the finder tells me I don't have sufficient
117 privileges to empty the trash.
120 6. Contacting the developers, Bug Reporting and Feature Requests
123 6.3. Request New Features
124 6.4. Report Ads or Other Actions-Related Problems
128 7. Privoxy Copyright, License and History
134 1. General Information
136 1.1. What is this new version of Privoxy?
138 In the beginning, there was the Internet Junkbuster, by Anonymous Coders and
139 Junkbusters Corporation. It saved many users a lot of pain in the early days of
140 web advertising and user tracking.
142 But the web, its protocols and standards, and with it, the techniques for
143 forcing users to consume ads, give up autonomy over their browsing, and for
144 spying on them, kept evolving. Unfortunately, the Internet Junkbuster did not.
145 Version 2.0.2, published in 1998, was (and is) the last official release
146 available from Junkbusters Corporation. Fortunately, it had been released under
147 the GNU GPL, which allowed further development by others.
149 So Stefan Waldherr started maintaining an improved version of the software, to
150 which eventually a number of people contributed patches. It could already
151 replace banners with a transparent image, and had a first version of pop-up
152 killing, but it was still very closely based on the original, with all its
153 limitations, such as the lack of HTTP/1.1 support, flexible per-site
154 configuration, or content modification. The last release from this effort was
155 version 2.0.2-10, published in 2000.
157 Then, some developers picked up the thread, and started turning the software
158 inside out, upside down, and then reassembled it, adding many new features
161 The result of this is Privoxy, whose first stable release, 3.0, is due late
162 summer or early fall 2002.
163 -------------------------------------------------------------------------------
165 1.2. Why "Privoxy"? Why a name change at all?
167 Privoxy is the "Privacy Enhancing Proxy". Also, its content modification and
168 junk suppression allow you to browse your "private edition" of the web.
170 Junkbusters Corporation continues to offer their original version of the
171 Internet Junkbuster, so publishing our Junkbuster-derived software under the
172 same name led to confusion.
174 There are also potential legal complications from the continued use of the
175 Junkbuster name, which is a registered trademark of Junkbusters Corporation.
176 There are, however, no objections from Junkbusters Corporation to the Privoxy
177 project itself, and they, in fact, still share our ideals and goals.
179 The developers also believed that there are so many changes from the original
180 code, that it was time to make a clean break from the past and make a name in
181 their own right, especially now with the pending release of version 3.0.
182 -------------------------------------------------------------------------------
184 1.3. How does Privoxy differ from the old Junkbuster?
186 Privoxy picks up where Junkbuster left off. All the old features remain. The
187 new Privoxy still blocks ads and banners, still manages cookies, and still
188 helps protect your privacy. But, these are all enhanced, and many new features
189 have been added, all in the same vein.
191 The configuration has changed significantly as well. This is something that
192 users will notice right off the bat if upgrading from Junkbuster 2.0.x. The
193 "blocklist" "cookielist", "imagelist" and much more has been combined into the
194 "actions" files, with a completely different syntax. See the note to upgraders
197 Privoxy's new features include:
199 * Integrated browser based configuration and control utility at http://
200 config.privoxy.org/ (shortcut: http://p.p/). Browser-based tracing of rule
201 and filter effects. Remote toggling.
203 * Web page content filtering (removes banners based on size, invisible
204 "web-bugs", JavaScript and HTML annoyances, pop-up windows, etc.)
206 * Modularized configuration that allows for standard settings and user
207 settings to reside in separate files, so that installing updated actions
208 files won't overwrite individual user settings.
210 * HTTP/1.1 compliant (but not all optional 1.1 features are supported).
212 * Support for Perl Compatible Regular Expressions in the configuration files,
213 and generally a more sophisticated and flexible configuration syntax over
216 * Improved cookie management features (e.g. session based cookies).
220 * Bypass many click-tracking scripts (avoids script redirection).
222 * Multi-threaded (POSIX and native threads).
224 * User-customizable HTML templates for all proxy-generated pages (e.g.
227 * Auto-detection and re-reading of config file changes.
229 * Improved signal handling, and a true daemon mode (Unix).
231 * Every feature now controllable on a per-site or per-location basis,
232 configuration more powerful and versatile over-all.
234 * Many smaller new features added, limitations and bugs removed, and security
238 -------------------------------------------------------------------------------
239 1.4. What is a "proxy"? How does Privoxy work?
241 A web proxy is a service, based on a software such as Privoxy, that clients
242 (i.e. browsers) can use instead of connecting directly to the web servers on
243 the Internet. The clients then ask the proxy to fetch the objects they need
244 (web pages, images, movies etc) on their behalf, and when the proxy has done
245 so, it hands the results back to the client.
247 There are many reasons to use web proxies, such as security (firewalling),
248 efficiency (caching) and others, and there are just as many different proxies
249 to accommodate those needs.
251 Privoxy is a proxy that is solely focused on privacy protection and junk
252 elimination. Sitting between your browser(s) and the Internet, it is in a
253 perfect position to filter outbound personal information that your browser is
254 leaking, as well as inbound junk. It uses a variety of techniques to do this,
255 all of which are under your control via the various configuration files and
257 -------------------------------------------------------------------------------
259 1.5. How does Privoxy know what is an ad, and what is not?
261 Privoxy's approach to blocking ads is twofold:
263 First, there are certain patterns in the locations (URLs) of banner images.
264 This applies to both the path (you wouldn't guess how many web sites serve
265 their banners from a directory called "banners"!) and the host (blocking the
266 big banner hosting services like doublecklick.net already helps a lot). Privoxy
267 takes advantage of this fact by using URL patterns to sort out and block the
268 requests for banners.
270 Second, banners tend to come in certain sizes. But you can't tell the size of
271 an image by its URL without downloading it, and if you do, it's too late to
272 save bandwidth. Therefore, Privoxy also inspects the HTML sources of web pages
273 while they are loaded, and replaces references to images with standard banner
274 sizes by dummy references, so that your browser doesn't request them anymore in
277 Both of this involves a certain amount of guesswork and is, of course, freely
279 -------------------------------------------------------------------------------
281 1.6. Can Privoxy make mistakes? This does not sound very scientific.
283 Actually, it's a black art ;-) And yes, it is always possible to have a broad
284 rule accidentally block or change something by mistake. There is a good chance
285 you may run into such a situation at some point. It is tricky writing rules to
286 cover every conceivable possibility, and not occasionally get false positives.
288 But this should not be a big concern since the Privoxy configuration is very
289 flexible, and includes tools to help identify these types of situations so they
290 can be addressed as needed, allowing you to customize your installation. (See
291 the Troubleshooting section below.)
292 -------------------------------------------------------------------------------
294 1.7. My browser does the same things as Privoxy. Why should I use Privoxy at
297 Modern browsers do indeed have some of the same functionality as Privoxy. Maybe
298 this is adequate for you. But Privoxy is much more versatile and powerful, and
299 can do a number of things that browsers just can't.
301 In addition, a proxy is good choice if you use multiple browsers, or have a LAN
302 with multiple computers. This way all the configuration is in one place, and
303 you don't have to maintain a similar configuration for possibly many browsers.
304 -------------------------------------------------------------------------------
306 1.8. Is there is a license or fee? What about a warranty? Registration?
308 Privoxy is licensed under the GNU General Public License (GPL). It is free to
309 use, copy, modify or distribute as you wish under the terms of this license.
310 Please see the Copyright section for more information on the license and
311 copyright. Or the LICENSE file that should be included.
313 There is no warranty of any kind, expressed, implied or otherwise. That is
314 something that would cost real money ;-) There is no registration either.
315 Privoxy really is free in every respect!
316 -------------------------------------------------------------------------------
318 1.9. I would like to help you, what do I do?
320 1.9.1. Money Money Money
322 We, of course, welcome donations and could use money for domain registering,
323 buying software to test Privoxy with, and, of course, for regular world-wide
324 get-togethers (hahaha). If you enjoy the software and feel like helping us with
325 a donation, just drop us a note.
326 -------------------------------------------------------------------------------
330 If you are a vendor of a web-related software like a browser, web server or
331 proxy, and would like us to ensure that Privoxy runs smoothly with your
332 product, you might consider supplying us with a copy or license. We can't,
333 however, guarantee that we will fix all potential compatibility issues as a
335 -------------------------------------------------------------------------------
337 1.9.3. You want to work with us?
339 Well, helping the team is always a good idea. We welcome new developers,
340 packaging gurus or documentation writers. Simply get an account on
341 SourceForge.net and mail your id to the developers mailing list. Then read the
344 Once we have added you to the team, you'll have write access to the CVS
345 repository, and together we'll find a suitable task for you.
346 -------------------------------------------------------------------------------
350 2.1. Which browsers are supported by Privoxy?
352 Any browser that can be configured to use a proxy, which should be virtually
353 all browsers. Direct browser support is not necessary since Privoxy runs as a
354 separate application and talks to the browser in the standardized HTTP
355 protocol, just like a web server does.
356 -------------------------------------------------------------------------------
358 2.2. Which operating systems are supported?
360 At present, Privoxy is known to run on Windows(95, 98, ME, 2000, XP), Linux
361 (RedHat, SuSE, Debian, Conectiva, Gentoo), Mac OSX, OS/2, AmigaOS, BeOS,
362 FreeBSD, NetBSD, Solaris, and many more flavors of Unix.
364 But any operating system that runs TCP/IP, can conceivably take advantage of
365 Privoxy in a networked situation where Privoxy would run as a server on a LAN
366 gateway. Then only the "gateway" needs to be running one of the above operating
369 Source code is freely available, so porting to other operating systems is
370 always a possibility.
371 -------------------------------------------------------------------------------
373 2.3. Can I install Privoxy over Junkbuster?
375 We recommend you un-install Junkbuster first to minimize conflicts and
376 confusion. You may want to save your old configuration files for future
377 reference. The configuration files and syntax have substantially changed, so
378 you will need to manually port your old patterns. See the note to upgraders and
379 installation chapter in the user manual for details.
381 Note: Some installers may automatically un-install Junkbuster, if present!
382 -------------------------------------------------------------------------------
384 2.4. I just installed Privoxy. Is there anything special I have to do now?
386 All browsers must be told to use Privoxy as a proxy by specifying the correct
387 proxy address and port number in the appropriate configuration area for the
388 browser. See below. You should also flush your browser's memory and disk cache
389 to get rid of any cached junk items.
390 -------------------------------------------------------------------------------
392 2.5. What is the proxy address of Privoxy?
394 If you set up the Privoxy to run on the computer you browse from (rather than
395 your ISP's server or some networked computer on a LAN), the proxy will be on
396 127.0.0.1 (sometimes referred to as "localhost", which is the special name used
397 by every computer on the Internet to refer to itself) and the port will be 8118
398 (unless you have Privoxy to run on a different port with the listen-address
401 When configuring your browser's proxy settings you typically enter the word
402 "localhost" or the IP address "127.0.0.1" in the boxes next to "HTTP" and
403 "Secure" (HTTPS) and then the number "8118" for "port". This tells your browser
404 to send all web requests to Privoxy instead of directly to the Internet.
406 Privoxy can also be used to proxy for a Local Area Network. In this case, your
407 would enter either the IP address of the LAN host where Privoxy is running, or
408 the equivalent hostname. Port assignment would be same as above. Note that
409 Privoxy doesn't listen on any LAN interfaces by default.
411 Privoxy does not currently handle protocols such as FTP, SMTP, IM, IRC, ICQ, or
412 other Internet protocols.
413 -------------------------------------------------------------------------------
415 2.6. I just installed Privoxy, and nothing is happening. All the ads are there.
418 Did you configure your browser to use Privoxy as a proxy? It does not sound
419 like it. See above. You might also try flushing the browser's caches to force a
420 full re-reading of pages. You can verify that Privoxy is running, and your
421 browser is correctly configured by entering the special URL: http://
422 config.privoxy.org/. This should take you to a page titled "This is Privoxy.."
423 with access to Privoxy's internal configuration. If you see this, then you are
424 good to go. If you receive a page saying "Privoxy is not running", then the
425 browser is not set up to use your Privoxy installation. If you receive anything
426 else (probably nothing at all), it could either be that the browser is not set
427 up correctly, or that Privoxy is not running at all. Check the log file.
428 -------------------------------------------------------------------------------
432 3.1. Where can I get updated Actions Files?
434 Based on your feedback and the continuing development, updated actions files
435 will be made available on the files section of our project page.
437 If you wish to receive an email notification whenever we release updates of
438 Privoxy or the actions file, subscribe to our announce mailing list,
439 ijbswa-announce@lists.sourceforge.net.
440 -------------------------------------------------------------------------------
442 3.2. Can I use my old config files?
444 The syntax, number, and purpose of configuration files has substantially
445 changed from Junkbuster and earlier versions of Privoxy. The old files, like
446 blocklist will not work at all. If you are upgrading from a 2.0.x version, you
447 will need to port your configuration data to the new format. Note that even the
448 pattern syntax has changed! Even configuration files from the 2.9.x versions
449 will need to be adapted, as configuration syntax has been very much in flow in
451 -------------------------------------------------------------------------------
453 3.3. What is an "actions" file?
455 Actions files are where various actions that Privoxy might take while
456 processing a certain request, are configured. Typically, you would define a set
457 of default actions that apply to all URLs, then add exceptions to these
458 defaults where needed.
460 Actions can be defined on a URL pattern basis, i.e. for single URLs, whole web
461 sites, groups or parts thereof etc. Actions can also be grouped together and
462 then applied to requests matching one or more patterns. There are many possible
463 actions that might apply to any given site. As an example, if you are blocking
464 cookies as one of your default actions, but need to accept cookies from a given
465 site, you would need to define an exception for this site in one of your
466 actions files, preferably in user.action
467 -------------------------------------------------------------------------------
469 3.4. The "actions" concept confuses me. Please list some of these "actions".
471 For a comprehensive discussion of the actions concept, please refer to the
472 actions file chapter in the user manual. It includes a list of all actions and
473 an actions file tutorial to get you started.
474 -------------------------------------------------------------------------------
476 3.5. How are actions files configured? What is the easiest way to do this?
478 Actions files are just text files in a special syntax and can be edited with a
479 text editor. The probably easiest way is to access Privoxy's user interface
480 with your web browser at http://config.privoxy.org/ (Shortcut: http://p.p/) and
481 then select "View & change the current configuration" from the menu.
482 -------------------------------------------------------------------------------
484 3.6. There are several different "actions" files. What are the differences?
486 As of Privoxy v2.9.15, three actions files are being included, to be used for
487 different purposes: These are default.action, the "main" actions file which is
488 actively maintained by the Privoxy developers, user.action, where users are
489 encouraged to make their private customizations, and standard.action, which is
490 for internal Privoxy use only. Please see the actions chapter in the user
491 manual for a more detailed explanation.
493 Earlier versions included three different versions of the default.action file.
494 The new scheme allows for greater flexibility of local configuration, and for
495 browser based selection of pre-defined "aggressiveness" levels.
496 -------------------------------------------------------------------------------
498 3.7. How can I make my Yahoo/Hotmail/GMX account work?
500 The default configuration shouldn't impact the usability of any of these
501 services. It will, however, make all cookies temporary, so that your browser
502 will forget your login credentials in between browser sessions. If you would
503 like not to have to log in manually each time you access those websites, simply
504 turn off all cookie handling for them in the user.action file. An example for
505 yahoo might look like:
507 # Allow all cookies for Yahoo login:
509 { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only }
511 -------------------------------------------------------------------------------
513 3.8. What's the difference between the "Cautious", "Medium" and "Advanced"
516 Configuring Privoxy is not entirely trivial. To help you get started, we
517 provide you with three different default action "packages" in the web based
518 actions file editor at http://config.privoxy.org/show-status. The following
519 table shows you, which of the most important features are enabled in each
522 Table 1. Default Configurations
523 +-------------------+------------------+-------------------+------------------+
524 |Feature |Cautious |Intermadiate |Advanced |
525 +-------------------+------------------+-------------------+------------------+
526 |Ad-blocking by URL |yes |yes |yes |
527 +-------------------+------------------+-------------------+------------------+
528 |Ad-filtering by |yes |yes |yes |
530 +-------------------+------------------+-------------------+------------------+
531 |GIF de-animation |no |yes |yes |
532 +-------------------+------------------+-------------------+------------------+
533 |Referer forging |no |yes |yes |
534 +-------------------+------------------+-------------------+------------------+
535 |Cookie handling |none |session-only |kill |
536 +-------------------+------------------+-------------------+------------------+
537 |Pop-up killing |no |yes |yes |
538 +-------------------+------------------+-------------------+------------------+
539 |Fast redirects |no |no |yes |
540 +-------------------+------------------+-------------------+------------------+
541 |HTML taming |yes |yes |yes |
542 +-------------------+------------------+-------------------+------------------+
543 |JavaScript taming |yes |yes |yes |
544 +-------------------+------------------+-------------------+------------------+
545 |Web-bug killing |yes |yes |yes |
546 +-------------------+------------------+-------------------+------------------+
547 |Fun text |no |no |yes |
548 |replacements | | | |
549 +-------------------+------------------+-------------------+------------------+
550 |Image tag |no |no |yes |
552 +-------------------+------------------+-------------------+------------------+
553 |Ad-filtering by |no |no |yes |
555 +-------------------+------------------+-------------------+------------------+
557 Where the defaults are likely to break some sites, exceptions for known popular
558 "problem" sites are included, but in general, the more aggressive your default
559 settings are, the more exceptions you will have to make later. See the user
560 manual for a more deatiled discussion.
561 -------------------------------------------------------------------------------
563 3.9. Why can I change the configuration with a browser? Does that not raise
566 It may seem strange that regular users can edit the config files with their
567 browsers, although the whole /etc/privoxy hierarchy belongs to the user
568 "privoxy", with only 644 permissions.
570 When you use the browser-based editor, Privoxy itself is writing to the config
571 files. Because Privoxy is running as the user "privoxy", it can update the
574 If you run Privoxy for multiple untrusted users (e.g. in a LAN), you will
575 probably want to turn the web-based editor and remote toggle features off by
576 setting "enable-edit-actions 0" and "enable-remote-toggle 0" in the main
579 Note that in the default configuration, only local users (i.e. those on
580 "localhost") can connect to Privoxy, so this is not (normally) a security
582 -------------------------------------------------------------------------------
584 3.10. What is the default.filter file? What is a "filter"?
586 The default.filter file is where filters are defined, which can be used to
587 modify or remove, web page content on the fly. Filters apply to anything in the
588 page source, including HTML tags, and JavaScript. Regular expressions are used
589 to accomplish this. There are a number of pre-defined filters to deal with
590 common annoyances. The filters are only defined here, to invoke them, you need
591 to use the filter action in one of the actions files. Filtering is
592 automatically disabled for inappropriate MIME types.
594 If you are familiar with regular expressions, and HTML, you can look at the
595 provided default.filter with a text editor and define your own filters. This is
596 potentially a very powerful feature, but requires some expertise in both
597 regular expressions and HTML/HTTP.
599 Presently, there is no GUI editor option for this part of the configuration,
600 but you can disable/enable the various pre-defined filters of the included
601 default.filter file with the web-based actions file editor.
602 -------------------------------------------------------------------------------
604 3.11. How can I set up Privoxy to act as a proxy for my LAN?
606 By default, Privoxy only responds to requests from 127.0.0.1 (localhost). To
607 have it act as a server for a network, this needs to be changed in the main
608 configuration file. Look for the listen-address option, which may be commented
609 out with a "#" symbol. Make sure it is uncommented, and assign it the address
610 of the LAN gateway interface, and port number to use. Assuming your LAN address
611 is 192.168.1.1 and you wish to run Privoxy on port 8118, this line should look
614 listen-address 192.168.1.1:8118
616 Save the file, and restart Privoxy. Configure all browsers on the network then
617 to use this address and port number.
619 If you run Privoxy on a LAN with untrusted users, we recommend that you
620 double-check the access control and security options!
621 -------------------------------------------------------------------------------
623 3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see
626 The replacement for blocked images can be controlled with the set-image-blocker
627 action. You have the choice of a checkerboard pattern, a transparent 1x1 GIF
628 image (aka "blank"), or a redirect to a custom image of your choice. Note that
629 this choice only has effect for images which are blocked as images, i.e. whose
630 URLs match both a handle-as-image and block action.
632 If you want to see nothing, then change the set-image-blocker action to "blank"
633 . This can be done by editing the default.action file, or trough the web-based
635 -------------------------------------------------------------------------------
637 3.13. Why would anybody want to see a checkerboard pattern?
639 Remember that telling which image is an ad and which isn't, is mostly
640 guesswork. While we hope that the standard configuration is rather smart, it
641 can and will make errors. The checkerboard image is visually decent, but it
642 shows you that and where images were blocked, which can be very helpful in case
643 some navigation aid or otherwise innocent image was erraneously blocked. Some
644 people might also enjoy seeing how many banners they don't have to see..
645 -------------------------------------------------------------------------------
647 3.14. I see some images being replaced by a text instead of the checkerboard
648 image. Why and how do I get rid of this?
650 This happens when the banners are not embedded in the HTML code of the page
651 itself, but in separate HTML (sub)documents that are loaded into (i)frames or
652 (i)layers, and these external HTML documents are blocked. Being non-images they
653 get replaced by a substitute HTML page rather than a substitute image, which
654 wouldn't work out technically, since the browser expects and accepts only HTML
655 when it has requested an HTML document.
657 The substitute page adapts to the available space and shows itself as a
658 miniature two-liner if loaded into small frames, or full-blown with a large red
659 "BLOCKED" banner if space allows.
661 If you prefer the banners to be blocked by images, you must see to it that the
662 HTML documents in which they are embedded are not blocked. Clicking the "See
663 why" link offered in the substitute page will show you which rule blocked the
664 page. After changing the rule and un-blocking the HTML documents, the browser
665 will try to load the actual banner images and the usual image blocking will
666 (hopefully!) kick in.
667 -------------------------------------------------------------------------------
669 3.15. Can Privoxy run as a service on Win2K/NT?
671 Yes, it can run as a system service using srvany.exe. The only catch is that
672 this will effectively disable the Privoxy icon (and its menu!) in the taskbar.
673 You can have one or the other, but not both at this time :(
675 There is a pending feature request for this functionality. See the discussion
676 at http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=
677 11118, for details, and a sample configuration.
678 -------------------------------------------------------------------------------
680 3.16. How can I make Privoxy work with other proxies like Squid?
682 This can be done and is often useful to combine the benefits of Privoxy with
683 those of a caching proxy. See the forwarding chapter in the user manual which
684 describes how to do this.
685 -------------------------------------------------------------------------------
687 3.17. Can Privoxy run as a "transparent" proxy?
689 No, Privoxy currently does not have this ability, though it is planned for a
690 future release. Transparent proxies require special handling of the request
691 headers beyond what Privoxy is now capable of.
693 Chaining Privoxy behind another proxy that has this ability should work though.
694 See the forwarding chapter in the user manual. As a transparent proxy to be
695 used for chaining we recommend Transproxy (http://www.transproxy.nlc.net.au/).
696 -------------------------------------------------------------------------------
700 4.1. How much does Privoxy slow my browsing down? This has to add extra time to
703 It should not slow you down any in real terms, and may actually help speed
704 things up since ads, banners and other junk are not being displayed. The actual
705 processing time required by Privoxy itself for each page, is relatively small
706 in the overall scheme of things, and happens very quickly. This is typically
707 more than offset by time saved not downloading and rendering ad images.
709 "Filtering" content via the filter or deanimate-gifs actions may cause a
710 perceived slowdown, since the entire document needs to be buffered before
711 displaying. See below.
712 -------------------------------------------------------------------------------
714 4.2. I noticed considerable delays in page requests compared to the old
715 Junkbuster. What's wrong?
717 If you use any filter action, such as filtering banners by size, web-bugs etc,
718 or the deanimate-gifs action, the entire document must be loaded into memory in
719 order for the filtering mechanism to work, and nothing is sent to the browser
722 The loading time does not really change in real numbers, but the feeling is
723 different, because most browsers are able to start rendering incomplete
724 content, giving the user a feeling of "it works". This effect is especially
725 noticeable on slow dialup connections.
727 Filtering is automatically disabled for inappropriate MIME types.
728 -------------------------------------------------------------------------------
730 4.3. What are "http://config.privoxy.org/" and "http://p.p/"?
732 http://config.privoxy.org/ is the address of Privoxy's built-in user interface,
733 and http://p.p/ is a shortcut for it.
735 Since Privoxy sits between your web browser and the Internet, it can simply
736 intercept requests for these addresses and answer them with its built-in "web
739 This also makes for a good test for your browser configuration: If entering the
740 URL http://config.privoxy.org/ takes you to a page saying "This is Privoxy..",
741 everything is OK. If you get a page saying "Privoxy is not working" instead,
742 then your browser didn't use Privoxy for the request, hence it could not be
743 intercepted, and you have accessed the real web site at config.privoxy.org.
745 With recent versions of Privoxy (version 2.9.x and later), the user interface
746 features information on the run time status, the configuration, and even a
747 built-in editor for the actions files.
749 Note that the built-in URLs from earlier versions of Junkbuster / Privoxy,
750 http://example.com/show-proxy-args and http://i.j.b/, are no longer supported.
751 If you still use such an old version, you should really consider upgrading to
753 -------------------------------------------------------------------------------
755 4.4. Do you still maintain the blocklists?
757 No. The patterns for blocking now reside (among other things) in the actions
758 files, which are actively maintained instead. See next question ...
759 -------------------------------------------------------------------------------
761 4.5. How can I submit new ads?
763 Yes, absolutely! Please see the Contact section for how to do that. Please note
764 that you (technically) need the latest Privoxy version for this to work.
765 -------------------------------------------------------------------------------
767 4.6. How can I hide my IP address?
769 If you run both the browser and the proxy locally, you cannot hide your IP
770 address with Privoxy or any other software. The server needs to know your IP
771 address to send the answers back to you.
773 Fortunately there are many publicly usable anonymous proxies out there, which
774 solve the problem by providing a further level of indirection between you and
775 the web server, shared by many people, and thus letting your requests "drown"
776 in white noise of unrelated requests as far as user tracking is concerned.
778 Most of them will, however, log your IP address and make it available to the
779 authorities in case you abuse that anonymity for criminal purposes. In fact you
780 can't even rule out that some of them only exist to *collect* information on
781 (those suspicious) people with a more than average preference for privacy.
783 You can find a list of anonymous public proxies at multiproxy.org and many more
784 through Google. A particularly interesting project is the JAP service offered
785 by the Technical University of Dresden (http://anon.inf.tu-dresden.de/
788 There is, however, even in the single-machine case the possibility to make the
789 server believe that your machine is in fact a shared proxy serving a whole big
790 LAN, and we are looking into that.
791 -------------------------------------------------------------------------------
793 4.7. Can Privoxy guarantee I am anonymous?
795 No. Your chances of remaining anonymous are greatly improved, but unless you
796 are an expert on Internet security it would be safest to assume that everything
797 you do on the Web can be traced back to you.
799 Privoxy can remove various information about you, and allows you more freedom
800 to decide which sites you can trust, and what details you want to reveal. But
801 it's still possible that web sites can find out who you are. Here's one way
804 A few browsers disclose the user's email address in certain situations, such as
805 when transferring a file by FTP. Privoxy does not filter FTP. If you need this
806 feature, or are concerned about the mail handler of your browser disclosing
807 your email address, you might consider products such as NSClean.
809 Browsers available only as binaries could use non-standard headers to give out
810 any information they can have access to: see the manufacturer's license
811 agreement. It's impossible to anticipate and prevent every breach of privacy
812 that might occur. The professionally paranoid prefer browsers available as
813 source code, because anticipating their behavior is easier. Trust the source,
815 -------------------------------------------------------------------------------
817 4.8. Might some things break because header information or content is being
820 Definitely. More and more sites use HTTP header content to decide what to
821 display and how to display it. There is many ways that this can be handled, so
822 having hard and fast rules, is tricky.
824 "User-Agent" in particular is often used in this way to identify the browser,
825 and adjust content accordingly. Changing this now (at least not further than
826 removing the OS information) is not recommended, since so many sites do look
827 for it. You may get undesirable results by changing this.
829 For instance, different browsers use different encodings of Russian and Czech
830 characters, certain web servers convert pages on-the-fly according to the User
831 Agent header. Giving a "User Agent" with the wrong operating system or browser
832 manufacturer causes some sites in these languages to be garbled; Surfers to
833 Eastern European sites should change it to something closer. And then some page
834 access counters work by looking at the "Referer" header; they may fail or break
835 if unavailable. The weather maps of Intellicast have been blocked by their
836 server when no "Referer" or cookie is provided, is another example. (But you
837 can forge both headers without giving information away). There are many other
838 ways things can go wrong when trying to fool a web server.
840 Similar thoughts apply to modifying JavaScript, and, to a lesser degree, HTML
843 If you have problems with a site, you will have to adjust your configuration
844 accordingly. Cookies are probably the most likely adjustment that may be
845 required, but by no means the only one.
846 -------------------------------------------------------------------------------
848 4.9. Can Privoxy act as a "caching" proxy to speed up web browsing?
850 No, it does not have this ability at all. You want something like Squid for
851 this. And, yes, before you ask, Privoxy can co-exist with other kinds of
852 proxies like Squid. See the forwarding chapter in the user manual for details.
853 -------------------------------------------------------------------------------
855 4.10. What about as a firewall? Can Privoxy protect me?
857 Not in the way you mean, or in the way a true firewall can. Privoxy can help
858 protect your privacy, but not protect you from intrusion attempts. It is, of
859 course, perfectly possible and recommended to use both.
860 -------------------------------------------------------------------------------
862 4.11. I have large empty spaces / a checkerboard pattern now where ads used to
865 It would be technically possible eliminate the banners in a way that frees
866 their screen estate in many cases, by doing all banner blocking with filters,
867 i.e. eliminating the whole image references from the HTML pages instead of
868 letting them stay in, and blocking the resulting requests for the banners
871 But this would consume considerable CPU resources, would likely destroy the
872 layout of many web pages which rely on the banners consuming a certain amount
873 of screen space, and would fail in other cases, where the screen space is
874 reserved e.g. by tables anyway. Also, making the banners disappear without a
875 visual trace complicates troubleshooting.
877 So we won't support this in the default configuration, but you can of course
878 define appropriate filters yourself.
879 -------------------------------------------------------------------------------
881 4.12. How can Privoxy filter Secure (HTTPS) URLs?
883 Since secure HTTP connections are encrypted SSL sessions between your browser
884 and the secure site, and are meant to be reliably secure, there is little that
885 Privoxy can do but hand the raw gibberish data though from one end to the other
888 The only exception to this is blocking by host patterns, as the client needs to
889 tell Privoxy the name of the remote server, so that Privoxy can establish the
890 connection. If that name matches a host-only pattern, the connection will be
893 As far as ad blocking is concerned, this is less of a restriction than it may
894 seem, since ad sources are often identifiable by the host name, and often the
895 banners to be placed in an encrypted page come unencrypted nonetheless for
896 efficiency reasons, which exposes them to the full power of Privoxy's ad
898 -------------------------------------------------------------------------------
900 4.13. Privoxy runs as a "server". How secure is it? Do I need to take any
903 There are no known exploits that might affect Privoxy. On Unix-like systems,
904 Privoxy can run as a non-privileged user, which is how we recommend it be run.
905 Also, by default Privoxy only listens to requests from "localhost" only. The
906 server aspect of Privoxy is not itself directly exposed to the Internet in this
907 configuration. If you want to have Privoxy serve as a LAN proxy, this will have
908 to be opened up to allow for LAN requests. In this case, we'd recommend you
909 specify only the LAN gateway address, e.g. 192.168.1.1, in the main Privoxy
910 configuration file and check all access control and security options. All LAN
911 hosts can then use this as their proxy address in the browser proxy
912 configuration, but Privoxy will not listen on any external interfaces. ACLs can
913 be defined in addition, and using a firewall is always good too. Better safe
915 -------------------------------------------------------------------------------
917 4.14. How can I temporarily disable Privoxy?
919 The easiest way is to access Privoxy with your browser by using the remote
920 toggle URL: http://config.privoxy.org/toggle. See the Bookmarklets section of
921 the User Manual for an easy way to access this feature.
922 -------------------------------------------------------------------------------
924 4.15. When "disabled" is Privoxy totally out of the picture?
926 No, this just means all filtering and actions are disabled. Privoxy is still
927 acting as a proxy, but just not doing any of the things that Privoxy would
928 normally be expected to do. It is still a "middle-man" in the interaction
929 between your browser and web sites.
930 -------------------------------------------------------------------------------
932 4.16. Where can I find more information about Privoxy and related issues?
934 Other references and sites of interest to Privoxy users:
936 http://www.privoxy.org/, the Privoxy Home page.
938 http://www.privoxy.org/faq/, the Privoxy FAQ.
940 http://sourceforge.net/projects/ijbswa/, the Project Page for Privoxy on
943 http://config.privoxy.org/, the web-based user interface. Privoxy must be
944 running for this to work. Shortcut: http://p.p/
946 http://www.privoxy.org/actions/, to submit "misses" to the developers.
948 http://www.junkbusters.com/ht/en/cookies.html, an explanation how cookies are
949 used to track web users.
951 http://www.junkbusters.com/ijb.html, the original Internet Junkbuster.
953 http://www.waldherr.org/junkbuster/, Stefan Waldherr's version of Junkbuster,
954 from which Privoxy was derived.
956 http://privacy.net/analyze/, a useful site to check what information about you
957 is leaked while you browse the web.
959 http://www.squid-cache.org/, a very popular caching proxy, which is often used
960 together with Privoxy.
962 http://www.privoxy.org/developer-manual/, the Privoxy developer manual.
964 -------------------------------------------------------------------------------
967 5.1. I just upgraded and am getting "connection refused" with every web page?
969 Either Privoxy is not running, or your browser is configured for a different
970 port than what Privoxy is using.
972 The old Privoxy (and also Junkbuster) used port 8000 by default. This has been
973 changed to port 8118 now, due to a conflict with NAS (Network Audio Service),
974 which uses port 8000. If you haven't, you need to change your browser to the
975 new port number, or alternately change the listen-address option in Privoxy's
976 main configuration file.
977 -------------------------------------------------------------------------------
979 5.2. I just added a new rule, but the steenkin ad is still getting through.
982 If the ad had been displayed before you added its URL, it will probably be held
983 in the browser's cache for some time, so it will be displayed without the need
984 for any request to the server, and Privoxy will not be in the picture. The best
985 thing to do is try flushing the browser's caches. And then try again.
987 If this doesn't help, you probably have an error in the rule you applied. Try
988 pasting the full URL of the offending ad into http://config.privoxy.org/
989 show-url-info and see if it really matches your new rule.
990 -------------------------------------------------------------------------------
992 5.3. One of my favorite sites does not work with Privoxy. What can I do?
994 First verify that it is indeed a Privoxy problem, by toggling off Privoxy
995 through http://config.privoxy.org/toggle, and then shift-reloading the problem
996 page (i.e. holding down the shift key while clicking reload. Alternatively,
997 flush your browser's disk and memory caches).
999 If still a problem, go to http://config.privoxy.org/show-url-info and paste the
1000 full URL of the page in question into the prompt. See which actions are being
1001 applied to the URL, and which matches in which actions files are responsible
1002 for that. Now, armed with this information, go to http://config.privoxy.org/
1003 show-status and select the appropriate actions files for editing.
1005 You can now either look for a section which disables the actions that you
1006 suspect to cause the problem and add a pattern for your site there, or make up
1007 a completely new section for your site. In any case, the recommended way is to
1008 disable only the prime suspect, reload the problem page, and only if the
1009 problem persists, disable more and more actions until you have identified the
1010 culprit. You may or may not want to turn the other actions on again. Remember
1011 to flush your browser's caches in between any such changes!
1013 Alternately, if you are comfortable with a text editor, you can accomplish the
1014 same thing by editing the appropriate actions file. Probably the easiest way to
1015 deal with such problems when editing by hand is to add your site to a { fragile
1016 } section in user.action, which is an alias that turns off most "dangerous"
1017 actions, but is also likely to turn off more actions then needed, and thus
1018 lower your privacy and protection more than necessary,
1020 Troubleshooting actions is discussed in more detail in the user-manual appendix
1021 . There is also an actions tutorial.
1022 -------------------------------------------------------------------------------
1024 5.4. After installing Privoxy, I have to log in every time I start IE. What
1027 This is a quirk that effects the installation of Privoxy, in conjunction with
1028 Internet Explorer and Internet Connection Sharing on Windows 2000 and Windows
1029 XP. The symptoms may appear to be corrupted or invalid DUN settings, or
1032 When setting up an NT based Windows system with Privoxy you may find that
1033 things do not seem to be doing what you expect. When you set your system up you
1034 will probably have set up Internet Connection Sharing (ICS) with Dial up
1035 Networking (DUN) when logged in with administrator privileges. You will
1036 probably have made this DUN connection available to other accounts that you may
1037 have set-up on your system. E.g. Mum or Dad sets up the system and makes
1038 accounts suitably configured for the kids.
1040 When setting up Privoxy in this environment you will have to alter the proxy
1041 set-up of Internet Explorer (IE) for the specific DUN connection on which you
1042 wish to use Privoxy. When you do this the ICS DUN set-up becomes user specific.
1043 In this instance you will see no difference if you change the DUN connection
1044 under the account used to set-up the connection. However when you do this from
1045 another user you will notice that the DUN connection changes to make available
1046 to "Me only". You will also find that you have to store the password under each
1049 The reason for this is that each user's set-up for IE is user specific. Each
1050 set-up DUN connection and each LAN connection in IE store the settings for each
1051 user individually. As such this enforces individual configurations rather than
1052 common ones. Hence the first time you use a DUN connection after re-booting
1053 your system it may not perform as you expect, and prompt you for the password.
1054 Just set and save the password again and all should be OK.
1056 [Thanks to Ray Griffith for this submission.]
1057 -------------------------------------------------------------------------------
1059 5.5. I cannot connect to any FTP sites. Privoxy seems to be blocking me.
1061 Privoxy cannot act as a proxy for FTP traffic, so do not configure your browser
1062 to use Privoxy as an FTP proxy. The same is true for any protocol other than
1064 -------------------------------------------------------------------------------
1066 5.6. In Mac OSX, I can't configure Microsoft Internet Explorer to use Privoxy
1069 Microsoft Internet Explorer (in versions like 5.1) respects system-wide network
1070 settings. In order to change the HTTP proxy, open System Preferences, and click
1071 on the Network icon. In the settings pane that comes up, click on the Proxies
1072 tab. Ensure the "Web Proxy (HTTP)" checkbox is checked and enter 127.0.0.1 in
1073 the entry field. Enter 8118 in the Port field. The next time you start IE, it
1074 should reflect these values.
1075 -------------------------------------------------------------------------------
1077 5.7. In Mac OSX, I dragged the Privoxy folder to the trash in order to
1078 uninstall it. Now the finder tells me I don't have sufficient privileges to
1081 Just dragging the Privoxy folder to the trash is not enough to delete it.
1082 Privoxy supplies an uninstall.command file that takes care of these details.
1083 Open the trash, drag the uninstall.command file out of the trash and
1084 double-click on it. You will be prompted for confirmation and the
1085 administration password.
1087 The trash may still appear full after this command; emptying the trash from the
1088 desktop should make it appear empty again.
1089 -------------------------------------------------------------------------------
1091 6. Contacting the developers, Bug Reporting and Feature Requests
1093 We value your feedback. In fact, we rely on it to improve Privoxy and its
1094 configuration. However, please note the following hints, so we can provide you
1095 with the best support:
1096 -------------------------------------------------------------------------------
1100 For casual users, our support forum at SourceForge is probably best suited:
1101 http://sourceforge.net/tracker/?group_id=11118&atid=211118
1103 All users are of course welcome to discuss their issues on the users mailing
1104 list, where the developers also hang around.
1105 -------------------------------------------------------------------------------
1109 Please report all bugs only through our bug tracker: http://sourceforge.net/
1110 tracker/?group_id=11118&atid=111118.
1112 Before doing so, please make sure that the bug has not already been submitted
1113 and observe the additional hints at the top of the submit form.
1115 Please try to verify that it is a Privoxy bug, and not a browser or site bug
1116 first. If unsure, try toggling off Privoxy, and see if the problem persists.
1117 The appendix of the user manual also has helpful information on action
1118 debugging. If you are using your own custom configuration, please try the stock
1119 configs to see if the problem is configuration related.
1121 If not using the latest version, chances are that the bug has been found and
1122 fixed in the meantime. We would appreciate if you could take the time to
1123 upgrade to the latest version (or even the latest CVS snapshot) and verify your
1124 bug, but this is not required for reporting.
1125 -------------------------------------------------------------------------------
1127 6.3. Request New Features
1129 You are welcome to submit ideas on new features or other proposals for
1130 improvement through our feature request tracker at http://sourceforge.net/
1131 tracker/?atid=361118&group_id=11118.
1132 -------------------------------------------------------------------------------
1134 6.4. Report Ads or Other Actions-Related Problems
1136 Please send feedback on ads that slipped through, innocent images that were
1137 blocked, and any other problems relating to the default.action file through our
1138 actions feedback mechanism located at http://www.privoxy.org/actions/. On this
1139 page, you will also find a bookmark which will take you back there from any
1140 troubled site and even pre-fill the form!
1142 New, improved default.action files will occasionally be made available based on
1143 your feedback. These will be announced on the ijbswa-announce list and
1144 available from our the files section of our project page.
1145 -------------------------------------------------------------------------------
1149 For any other issues, feel free to use the mailing lists. Technically
1150 interested users and people who wish to contribute to the project are also
1151 welcome on the developers list! You can find an overview of all Privoxy-related
1152 mailing lists, including list archives, at: http://sourceforge.net/mail/?
1154 -------------------------------------------------------------------------------
1156 7. Privoxy Copyright, License and History
1158 Copyright © 2001, 2002 by Privoxy Developers <developers@privoxy.org>
1160 Some source code is based on code Copyright © 1997 by Anonymous Coders and
1161 Junkbusters, Inc. and licensed under the GNU General Public License.
1163 Portions of this document are "borrowed" from the original Junkbuster (tm) FAQ,
1164 and modified as appropriate for Privoxy.
1165 -------------------------------------------------------------------------------
1169 Privoxy is free software; you can redistribute it and/or modify it under the
1170 terms of the GNU General Public License, version 2, as published by the Free
1171 Software Foundation.
1173 This program is distributed in the hope that it will be useful, but WITHOUT ANY
1174 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
1175 PARTICULAR PURPOSE. See the GNU General Public License for more details, which
1176 is available from the Free Software Foundation, Inc, 59 Temple Place - Suite
1177 330, Boston, MA 02111-1307, USA.
1179 You should have received a copy of the GNU General Public License along with
1180 this program; if not, write to the
1183 Foundation, Inc. 59 Temple Place - Suite 330
1184 Boston, MA 02111-1307
1186 -------------------------------------------------------------------------------
1190 In the beginning, there was the Internet Junkbuster, by Anonymous Coders and
1191 Junkbusters Corporation. It saved many users a lot of pain in the early days of
1192 web advertising and user tracking.
1194 But the web, its protocols and standards, and with it, the techniques for
1195 forcing users to consume ads, give up autonomy over their browsing, and for
1196 spying on them, kept evolving. Unfortunately, the Internet Junkbuster did not.
1197 Version 2.0.2, published in 1998, was (and is) the last official release
1198 available from Junkbusters Corporation. Fortunately, it had been released under
1199 the GNU GPL, which allowed further development by others.
1201 So Stefan Waldherr started maintaining an improved version of the software, to
1202 which eventually a number of people contributed patches. It could already
1203 replace banners with a transparent image, and had a first version of pop-up
1204 killing, but it was still very closely based on the original, with all its
1205 limitations, such as the lack of HTTP/1.1 support, flexible per-site
1206 configuration, or content modification. The last release from this effort was
1207 version 2.0.2-10, published in 2000.
1209 Then, some developers picked up the thread, and started turning the software
1210 inside out, upside down, and then reassembled it, adding many new features
1213 The result of this is Privoxy, whose first stable release, 3.0, is due late
1214 summer or early fall 2002.