Please note that this document is constantly evolving. This copy represents - the state at the release of version 3.0.5. + the state at the release of version 3.0.6. You can find the latest version of the this manual at

  debchange -v 3.0.5-BETA-1 "New upstream version"

debchange -v 3.0.6-stable-1 "New upstream version"

1.14. Can I use Privoxy with other ad-blocking software?1.16. Can I use Privoxy with other ad-blocking software? 1.15. I would like to help you, what can I do?1.17. I would like to help you, what can I do? 1.15.1. Would you like to participate? 1.17.1. Would you like to participate? Well, we Developer's Manual, at least the pertinent sections. Once we have added you to the team, you'll have access to the CVS repository, and - together we'll find a suitable task for you.

1.15.2. Contribute!1.17.2. Contribute! We, of course, welcome donations and could use money for domain registering, buying software to test 1.15.3. Software1.17.3. Software If you are a vendor of a web-related software like a browser, web server or proxy, and would like us to ensure that $Id: faq.sgml,v 2.21 2006/10/03 14:40:51 fabiankeil Exp $ $Id: faq.sgml,v 2.23 2006/10/21 22:19:52 hal9 Exp $

Privoxy is based on Internet Junkbuster (tm). Please note that this document is a work in progress. This copy represents - the state at the release of version 3.0.5. + the state at the release of version 3.0.6. You can find the latest version of the document at 1.4. Does Privoxy do anything more than ad blocking? 1.5. What is this new version of ? 1.5. 1.6. Why "Privoxy" 1.6. 1.7. How does Privoxy differ from the old Junkbuster? 1.7. 1.8. How does Privoxy know what is an ad, and what is not? 1.8. 1.9. Can Privoxy make mistakes? This does not sound very scientific. 1.9. 1.10. Will I have to configure Privoxy before I can use it? 1.10. 1.11. Can Privoxy run as a server on a network? 1.12. My browser does the same things as -Privoxy. Why should I use -Privoxy at all? 1.11. 1.13. Why should I trust Privoxy? 1.12. 1.14. Is there is a license or fee? What about a warranty? Registration? 1.13. 1.15. Can Privoxy remove spyware? Adware? Viruses? 1.14. 1.16. Can I use Privoxy with other ad-blocking software? 1.15. 1.17. I would like to help you, what can I do? 1.15.1. 1.17.1. Would you like to participate? 1.15.2. 1.17.2. Contribute! 1.15.3. 1.17.3. Software 2.5. I just installed Privoxy. Is there anything special I have to do now? 3.1. What exactly is an "actions" 3.3. How are actions files configured? What is the easiest way to do this? 3.4. There are several different "actions" 3.7. Why is the configuration so complicated? 3.8. How can I make my Yahoo/Hotmail/Gmail account work? 3.8. 3.9. What's the difference between the defaults? 3.9. 3.10. Why can I change the configuration with a browser? Does that not raise security issues? 3.10. 3.11. What is the default.filter? 3.11. 3.12. How can I set up Privoxy to act as a proxy for my LAN? 3.12. 3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything. 3.13. 3.14. Why would anybody want to see a checkerboard pattern? 3.14. 3.15. I see some images being replaced by a text instead of the checkerboard image. Why and how do I get rid of this? 3.15. 3.16. Can Privoxy run as a service on Win2K/NT/XP? 3.16. 3.17. How can I make Privoxy work with other proxies like Squid or Tor? 3.17. 3.18. Can I just set Privoxy to use port 80 and thus avoid individual browser configuration? 3.18. 3.19. Can Privoxy run as a proxy? 3.19. 3.20. How can I configure Privoxy for use with Outlook Express? 3.20. 3.21. How can I have separate rules just for HTML mail? 3.21. 3.22. I sometimes notice cookies sneaking through. How? 3.22. 3.23. Are all cookies bad? Why? 3.23. 3.24. How can I allow permanent cookies for my trusted sites? 3.24. 3.25. Can I have separate configurations for different users? 3.25. 3.26. Can I set-up Privoxy as a whitelist of sites? 3.26. 3.27. How can I turn off ad-blocking? 3.27. 3.28. How can I have custom template pages, like the page? 3.28. 3.29. How can I remove the 4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing. 4.8. Can Privoxy guarantee I am anonymous? 4.9. A test site says I am not using a Proxy. 4.11. Might some things break because header information or content is being altered? 4.12. Can Privoxy act as a "caching" 4.13. What about as a firewall? Can Privoxy protect me? 4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why? 4.15. How can Privoxy filter Secure (HTTPS) URLs? 4.16. Privoxy runs as a "server" 4.19. How can I tell Privoxy to totally ignore certain sites? 4.20. My logs show Privoxy ? 4.20. 4.21. Can Privoxy effect files that I download from a webserver? FTP server? 4.21. 4.22. I just downloaded a Perl script, and Privoxy altered it! Yikes, what is wrong! 4.22. 4.23. Should I continue to use a file for ad-blocking? 4.23. 4.24. Where can I find more information about Privoxy and related issues? 4.24. 4.25. I've noticed that Privoxy changes 5.1. I cannot connect to any websites. Or, I am getting 5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page? 5.3. I just added a new rule, but the steenkin ad is still getting through. How? 5.3. 5.4. One of my favorite sites does not work with Privoxy. What can I do? 5.4. 5.5. After installing Privoxy, I have to log in every time I start IE. What gives? 5.5. 5.6. I cannot connect to any FTP sites. Privoxy is blocking me. 5.6. 5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use Privoxy as the HTTP proxy. 5.7. 5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to uninstall it. Now the finder tells me I don't have sufficient privileges to empty the trash. 5.8. 5.9. In Mac OSX Panther (10.3), images often fail to load and/or I experience random delays in page loading. I'm using @@ -744,7 +768,7 @@ CLASS="LITERAL" > as my browser's proxy setting. 5.9. 5.10. I get a completely blank page at one site. 5.10. Why am I getting a 503 Error (WSAECONNREFUSED) on every page? 5.11. My logs show many I just installed Privoxy, and all my browsing has slowed to a crawl. What gives? 5.20. Why do my filters work on some sites but not on others?

7.1. License 7.2. History 2.5. I just installed Privoxy. Is there anything special I have to do now?Privoxy as a proxy by specifying the correct proxy address and port number - in the appropriate configuration area for the browser. See below. - You should also flush your browser's memory and disk cache to get rid of any + in the appropriate configuration area for the browser. See + the User Manual for more + details. You should also flush your browser's memory and disk cache to get rid of any cached junk items, and remove any stored Privoxy - is running, or the equivalent hostname. Port assignment would be - same as above. Note that 192.168.1.1. + Port assignment would be same as above. Note that + Privoxy doesn't - listen on any LAN interfaces by default. +> doesn't listen on any LAN interfaces by + default.

4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing.

Privoxy, http://example.com/show-proxy-args and http://i.j.b/, are no longer supported. If you still use such an old version, you should really consider - upgrading to 3.0.5.

4.8. Can Privoxy guarantee I am anonymous?

4.9. A test site says I am not using a Proxy.

Tor.

Afterwards, please take the time to at least skim through the rest +> Afterward, please take the time to at least skim through the rest of Tor's

4.11. Might some things break because header information or content is being altered?

4.12. Can Privoxy act as a
4.13. What about as a firewall? Can Privoxy protect me?
4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why?
It would be technically possible eliminate the banners in a way that frees - their screen estate in many cases, by doing all banner blocking with filters, - i.e. eliminating the whole image references from the HTML pages instead - of letting them stay in, and blocking the resulting requests for the - banners themselves.
But this would consume considerable CPU resources, would likely destroy - the layout of many web pages which rely on the banners consuming a certain - amount of screen space, and would fail in other cases, where the screen space - is reserved e.g. by tables anyway. Also, making the banners disappear without - a visual trace complicates troubleshooting.
So we won't support this in the default configuration, but you can of course - define appropriate filters yourself.
It is technically possible to eliminate banners and ads in a way that frees + their allocated page space. This could easily be done by blocking with + Privoxy's filters, + and eliminating the entire image references from the + HTML page source.
But, this would consume considerably more CPU resources (IOW, slow things + down), would likely destroy the layout of some web pages which rely on the + banners utilizing a certain amount of page space, and might fail in other + cases, where the screen space is reserved (e.g. by HTML tables for instance). + Also, making ads and banners disappear without any trace complicates + troubleshooting, and would sooner or later be problematic.
The better alternative is to instead let them stay, and block the resulting + requests for the banners themselves as is now the case. This leaves either + empty space, or the familiar checkerboard pattern.
So the developers won't support this in the default configuration, but you + can of course define appropriate filters yourself to achieve this.

4.15. How can Privoxy filter Secure (HTTPS) URLs?

4.16. Privoxy runs as a "middle-man" in - the interaction between your browser and web sites.

4.19. How can I tell Privoxy to totally ignore certain sites?

Bypassing a proxy, or proxying based on arbitrary criteria, is purely a browser + configuration issue, not a Privoxy issue. Modern browsers typically do have + settings for not proxying certain sites. Check your browser's help files.

4.19. My logs show Privoxy 4.20. My logs show Privoxy "crunches" @@ -1109,7 +1140,7 @@ CLASS="SECT2" >4.20. Can Privoxy effect files that I download +>4.21. Can Privoxy effect files that I download from a webserver? FTP server?

From the webserver's perspective, there is no difference between @@ -1248,7 +1279,7 @@ CLASS="SECT2" >4.21. I just downloaded a Perl script, and Privoxy +>4.22. I just downloaded a Perl script, and Privoxy altered it! Yikes, what is wrong!

Please read above.

4.22. Should I continue to use a 4.23. Should I continue to use a "HOSTS" file for ad-blocking?4.23. Where can I find more information about Privoxy +>4.24. Where can I find more information about Privoxy and related issues?

Other references and sites of interest to 4.24. I've noticed that Privoxy changes 4.25. I've noticed that Privoxy changes "Microsoft" to diff --git a/doc/webserver/faq/trouble.html b/doc/webserver/faq/trouble.html index 54324730..659fec9c 100644 --- a/doc/webserver/faq/trouble.html +++ b/doc/webserver/faq/trouble.html @@ -81,7 +81,7 @@ CLASS="SECT2" >

5.1. I cannot connect to any websites. Or, I am getting "connection refused" message with every web page. Why?

Either ...

There are several possibilities:

Privoxy is installed correctly, has not died, and is running.

is installed correctly, has not crashed, and is indeed running. + Look at Privoxy's logs to see what they say.

Or you have a firewall that is interfering and blocking you. Solution: - try disabling or removing the firewall as a test. + try disabling or removing the firewall as a simple test.

5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?

More than likely this is a problem with your TCP/IP networking. ZoneAlarm has + been reported to cause this symptom -- even if not running! The solution is + to either fight the ZA configuration, or uninstall ZoneAlarm, and then find + something better behaved in its place. Other personal firewall type products + may cause similar type problems if not configured correctly. +

5.2. I just added a new rule, but the steenkin ad is +>5.3. I just added a new rule, but the steenkin ad is still getting through. How?

If the ad had been displayed before you added its URL, it will probably be @@ -151,8 +171,7 @@ still getting through. How?Privoxy - will not be in the picture. The best thing to do is try flushing the browser's - caches. And then try again.

If this doesn't help, you probably have an error in the rule you applied. Try pasting the full URL of the offending ad into http://config.privoxy.org/show-url-info and see if it really matches your new rule. Blocking ads is like blocking - spam: a lot of tinkering is required to stay ahead of the game.

Privoxy's logs.

Below is a slightly modified real-life log snippet that originates with one + requested URL: www.example.com (name of site was changed + for this example, the number of requests is real). You can see in this the + complexity of what goes into making up this one "page". There + are eight different domains involved here, with thirty two separate URLs + requested in all, making up all manner of images, Shockwave Flash, + JavaScript, CSS stylesheets, scripts, and other related content. Some of this + content is obviously "good" or "bad", but not all. + Many of the more questionable looking requests, are going to outside domains + that seem to be identifying themselves with suspicious looking names, making + our job a little easier. Privoxy has "crunched" (meaning caught + and BLOCKED) quite a few items in this example, but perhaps missed a few as well.

Request: www.example.com/ +Request: www.example.com/favicon.ico +Request: img.example.com/main.css +Request: img.example.com/sr.js +Request: example.betamarker.com/example.html +Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers +Request: img.example.com/pb.png +Request: www.google-analytics.com/urchin.js crunch! +Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! +Request: img.example.com/p.gif +Request: www.popuptraffic.com/assign.php?l=example&mode=behind crunch! +Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&tmpl=PBa.tmpl crunch! +Request: www.popuptraffic.com/assign.php?l=example crunch! +Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css +Request: www.adtrak.net/adx.js crunch! +Request: img.example.com/hbg.gif +Request: img.example.com/example.jpg +Request: img.example.com/mt.png +Request: img.example.com/mm.png +Request: img.example.com/mb.png +Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&tmpl=Ua.tmp crunch! +Request: www.example.com/tracker.js +Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif +Request: www.adtrak.net/adjs.php?n=020548130&what=zone:61 crunch! +Request: www.adtrak.net/adjs.php?n=463594413&what=zone:58&source=Ua crunch! +Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf +Request: mmm.elitemediagroup.net/install.php?allowpop=no&popupmincook=0&allowsp2=1 crunch! +Request: www.example.com/tracker.js?screen=1400x1050&win=962x693 +Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=61 crunch! +Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&si +Request: 66.70.21.80/img/pixel.gif +Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch! +Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua

Despite 12 out of 32 requests being blocked, the page looked, and seemed to + behave perfectly "normal" (minus some ads, of course).

5.3. One of my favorite sites does not work with Privoxy. +>5.4. One of my favorite sites does not work with Privoxy. What can I do?

First verify that it is indeed a

If still a problem, go to If the problem went away, we know we have a configuration related problem. + Now go to http://config.privoxy.org/show-url-info - and paste the full URL of the page in question into the prompt. See which actions - are being applied to the URL, and which matches in which actions files are - responsible for that. Now, armed with this information, go to required. + Now, armed with this information, go to + http://config.privoxy.org/show-status - and select the appropriate actions files for editing.

You can now either look for a section which disables the actions that you suspect to cause the problem and add a pattern for your site there, @@ -240,6 +363,9 @@ TARGET="_top" >actions tutorial with general configuration information and examples.

As a last resort, you can always see if your browser has a setting that will + bypass the proxy setting for selective sites. Modern browsers can do this.

5.4. After installing Privoxy, I have to log in +>5.5. After installing Privoxy, I have to log in every time I start IE. What gives?

This is a quirk that effects the installation of @@ -303,7 +429,7 @@ CLASS="SECT2" >5.5. I cannot connect to any FTP sites. Privoxy +>5.6. I cannot connect to any FTP sites. Privoxy is blocking me.

5.6. In Mac OSX, I can't configure Microsoft Internet Explorer to use +>5.7. In Mac OSX, I can't configure Microsoft Internet Explorer to use Privoxy as the HTTP proxy.

Microsoft Internet Explorer (in versions like 5.1) respects system-wide @@ -399,7 +525,7 @@ CLASS="SECT2" >5.7. In Mac OSX, I dragged the Privoxy folder to the trash in order to +>5.8. In Mac OSX, I dragged the Privoxy folder to the trash in order to uninstall it. Now the finder tells me I don't have sufficient privileges to empty the trash.

5.8. In Mac OSX Panther (10.3), images often fail to load and/or I +>5.9. In Mac OSX Panther (10.3), images often fail to load and/or I experience random delays in page loading. I'm using 5.9. I get a completely blank page at one site. 5.10. I get a completely blank page at one site. "View Source" @@ -524,22 +650,6 @@ CLASS="SECT2" >

`5.10. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?`

More than likely this is a problem with your TCP/IP networking. ZoneAlarm has - been reported to cause this symptom -- even if not running. The solution is - to either fight the ZA configuration, or uninstall ZoneAlarm, and then find - something better behaved in its place. Other personal firewall type products - may cause similar type problems if not configured correctly. -

`5.11. My logs show many HOSTS` file. If this file has been changed from the original, try reverting it to - see if that helps. Make sure what ever name(s) are used for the local system, + see if that helps. Make sure whatever name(s) are used for the local system, that they resolve both ways.

which is reporting whatever problem occurred downstream, and not the root cause of the error.

In any case, v. 3.0.5 includes various improvements to help +> In any case, newer versions include various improvements to help Privoxy

5.20. Why do my filters work on some sites but not on others?

It's probably due to compression. It is a common practice for web servers to + send their content "compressed" in order to speed things up, and + then let the browser "uncompress" them. Privoxy does not (yet) + support compression. But we can force the web server to bend to our will ;-) + So for filtering, make sure you have prevent-compression + turned ON!

The most recent release is 3.0.5 (BETA)3.0.6 (stable).

Manpage of PRIVOXY

PRIVOXY

-Section: (1)
Updated: 21 September 2006
Index +Section: (1)
Updated: 13 November 2006
Index

@@ -186,8 +186,8 @@ configuration might look like: +filter{refresh-tags} \ -filter{unsolicited-popups} \ -filter{all-popups} \ -+filter{img-reorder} \ -+filter{banners-by-size} \ +-filter{img-reorder} \ +-filter{banners-by-size} \ -filter{banners-by-link} \ +filter{webbugs} \ -filter{tiny-textforms} \ @@ -200,6 +200,14 @@ configuration might look like: -filter{crude-parental} \ +filter{ie-exploits} \ -filter{site-specifics} \ +-filter{google} \ +-filter{yahoo} \ +-filter{msn} \ +-filter{blogspot} \ +-filter{xml-to-html} \ +-filter{html-to-xml} \ +-filter{no-ping} \ +-filter{hide-tor-exit-notation} \ -filter-client-headers \ -filter-server-headers \ -force-text-mode \ @@ -227,28 +235,32 @@ configuration might look like: / # '/' Match *all* URL patterns - # Block, and treat these URL patterns as if they were 'images'. - # We would expect these to be ads. - { +block-as-image } - .ad.doubleclick.net - .a[0-9].yimg.com/(?:(?!/i/).)*$ - ad.*.doubleclick.net - # Block all URLs that match these patterns { +block } - ad*. + ad. + ad[sv]. .*ads. banner?. /.*count(er)?\.(pl|cgi|exe|dll|asp|php[34]?) .hitbox.com media./.*(ads|banner) + # Block, and treat these URL patterns as if they were 'images'. + # We would expect these to be ads. + { +block-as-image } + .ad.doubleclick.net + .a[0-9].yimg.com/(?:(?!/i/).)*$ + ad.*.doubleclick.net + # Make exceptions for these harmless ones that would be # caught by our +block patterns just above. { -block } adsl. + adobe. advice. .*downloads. + # uploads or downloads + /.*loads

@@ -327,10 +339,6 @@ automatically.

-This is a BETA version of Privoxy. Not -all features are well tested. -

- Please see the User Manual on how to contact the developers, for feature requests, reporting problems, and other questions. @@ -388,7 +396,6 @@ the Privoxy developer manual. Hal Burgiss Ian Cummings - Félix Rauch Roland Rosenfeld @@ -457,6 +464,6 @@ USA This document was created by man2html, using the manual pages.
-Time: 01:21:32 GMT, September 22, 2006 +Time: 01:57:58 GMT, November 14, 2006 diff --git a/doc/webserver/privoxy-index.html b/doc/webserver/privoxy-index.html index f85db458..870240f1 100644 --- a/doc/webserver/privoxy-index.html +++ b/doc/webserver/privoxy-index.html @@ -76,7 +76,7 @@ NAME="AEN2" >Privoxy - The Privacy Enhancing Proxy

Project Index Page v3.0.5

Project Index Page v3.0.6

standard.action - is used by the web based editor +> - is used only by the web based editor at Cautious button changes the actions list to low/safe settings which will activate - a minimal set of Privoxy's features, and subsequently there will be - less of a chance for accidental problems. The 's features, and subsequently + there will be less of a chance for accidental problems. The + Medium - button sets the list to a medium level of ad blocking and a low level set of - privacy features. The button sets the list to a medium level of + other features and a low level set of privacy features. The + Advanced button - sets the list to a high level of ad blocking and medium level of - privacy. See the chart below. The latter three buttons over-ride - any changes via with the button sets the list to a high level of + ad blocking and medium level of privacy. See the chart below. The latter + three buttons over-ride any changes via with the + Edit button. More - fine-tuning can be done in the lower sections of this internal page. +> button. More fine-tuning can be done in the + lower sections of this internal page.

It is not recommend to edit the

8.1. Finding the Right Mix 8.2. How to Edit 8.4.1. The Domain Pattern

While flexibile, this is not the sophistication of full regular expression based syntax.

While flexible, this is not the sophistication of full regular expression based syntax.

`8.4.2. The Path Pattern`

# Check if www.example.net/ really uses valid XHTML
-{+content-type-overwrite {application/xml}}
+{ +content-type-overwrite{application/xml} }
 www.example.net/
 
 # but leave the content type unmodified if the URL looks like a style sheet
@@ -2337,7 +2338,7 @@ WIDTH="90%"
 ># Block the non-existent "Privacy-Violation:" client header 
-{+crunch-client-header {Privacy-Violation:}}
+{ +crunch-client-header{Privacy-Violation:} }
 /
     
# Let the browser revalidate cached documents without being tracked across sessions
-{+hide-if-modified-since {-60} \
-+overwrite-last-modified {randomize} \
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
 /   
# Crunch server headers that try to prevent caching
-{+crunch-server-header {no-cache}}
+{ +crunch-server-header{no-cache} }
 /   
+   
    
+    +filter{no-ping}             # Removes non-standard ping attributes from anchor and area tags
+   
    
+    +filter{hide-tor-exit-notation} # Header filter to remove the Tor exit node notation in Host and Referer headers
    ,
     the presence or absence of this mark decides whether an HTML "blocked""BLOCKED"
     page, or an empty document will be sent to the client as a substitute for the blocked content.
     The Privoxy's
     default HTML page; this option can be used to silence them.
+    And of course this action can also be used to eliminate the Privoxy
+    BLOCKED message in frames.
    
    The content type for the empty document can be specified with
@@ -4785,10 +4829,10 @@ WIDTH="90%"
 >
# Disarm the download link in Sourceforge's patch tracker
-{-filter\
-+content-type-overwrite {text/plain}\
-+hide-content-disposition {block} }
-.sourceforge.net/tracker/download.php
# Let the browser revalidate without being tracked across sessions
-{+hide-if-modified-since {-60}\
-+overwrite-last-modified {randomize}\
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
 /
# Set default:
+># Selectively turn off compression, and enable a filter
 #
-{+prevent-compression}
-/ # Match all sites
+{ +filter{tiny-textforms} +prevent-compression }
+# Match only these sites
+ .google.
+ sourceforge.net
+ sf.net
 
-# Make exceptions for ill sites:
+# Or instead, we could set a universal default:
 #
-{-prevent-compression}
-www.debianhelp.org
-www.pclinuxonline.com
# Let the browser revalidate without being tracked across sessions
-{+hide-if-modified-since {-60}\
-+overwrite-last-modified {randomize}\
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
 /
8.5.36. Summary
Privoxy.
 Now let's define some aliases...
crunch-outgoing-cookies
  +block-as-image      = +block +handle-as-image
- mercy-for-cookies   = -crunch-all-cookies -session-cookies-only - -kill-popups -prevent-compression
+
  shop        = -crunch-all-cookies -filter{all-popups} and "fragile" are often used for 
+> are typically used for 
  "problem" sites that require some actions to be disabled 
+> sites that require more than one action to be disabled 
  in order to function properly.

`8.7.1. default.action`

filter-html-to-xml \ + -filter-no-ping \ + -filter-hide-tor-exit-notation \ -

`8.7.2. user.action`

`14.2. Privoxy's Internal Pages`

Short cuts. Turn off, then on: 14.3. Chain of Events Let's take a quick look at the basic sequence of events when a web page is - requested by your browser and Let's take a quick look at how some of Privoxy is on duty:Privoxy's + core features are triggered, and the ensuing sequence of events when a web + page is requested by your browser: "+handle-as-image" - is then checked and if it does not match, an + and + "+handle-as-empty-document" + are then checked, and if there is no match, an HTML "BLOCKED" page is sent back. Otherwise, if it does match, - an image is returned. The type of image depends on the setting of page is sent back to the browser. Otherwise, if + it does match, an image is returned for the former, and an empty text + document for the latter. The type of image would depend on the setting of + Now the web server starts sending its response back (i.e. typically a web page and related - data). +> Now the web server starts sending its response back (i.e. typically a web + page). If a If any "+filter" +> action or back to your browser. If neither If neither a "+filter" +> action or As the browser receives the now (possibly filtered) page content, it reads and then requests any URLs that may be embedded within the page source, e.g. ad images, stylesheets, JavaScript, other HTML documents (e.g. - frames), sounds, etc. For each of these objects, the browser issues a new - request. And each such request is in turn processed as above. Note that a - complex web page may have many such embedded URLs. + frames), sounds, etc. For each of these objects, the browser issues a + separate request (this is easily viewable in Privoxy's + logs). And each such request is in turn processed just as above. Note that a + complex web page will have many, many such embedded URLs. If these + secondary requests are to a different server, then quite possibly a very + differing set of actions is triggered. NOTE: This is somewhat of a simplistic overview of what happens with each URL + request. For the sake of brevity and simplicity, we have focused on + Privoxy's core features only.

, for local site exceptions. Note that when a simple domain pattern is used by itself (without the subsequent path portion), all sub-pages within that domain are included - automatcially in the scope of the action. Images that are inexplicably being blocked, may well be hitting the 6.1. Controlling Privoxy with Your Web Browser Privoxy Menu Privoxy executable. The name - and number of configuration files has changed from previous versions, and is - subject to change as development progresses. executable. The installed defaults provide a reasonable starting point, though some settings may be aggressive by some standards. For the time being, the @@ -326,7 +324,7 @@ CLASS="FILENAME" upgrades. standard.action is for +> is only for Privoxy'sold listening address. While under development, the configuration content is subject to change. - The below documentation may not be accurate by the time you read this. - Also, what constitutes a "default" setting, may change, so - please check all your configuration files on important issues.

Windows XP SP2), if you are using some kind of Unix flavour, +>), if you are using a Unix flavor, sending the output of "uname -a"12.1. License Hal Burgiss Ian Cummings - Félix Rauch Roland Rosenfeld Former Privoxy Team Members: Stefan Waldherr Thanks to the many people who have tested Privoxy, reported bugs, made - suggestions or contributed in some way. These include (in alphabetical order): Thanks to the many people who have tested Privoxy, reported bugs, provided + patches, made suggestions or contributed in some way. These include (in + alphabetical order): Ken Arromdee @@ -297,23 +297,33 @@ CLASS="LITERALLAYOUT" Reiner Buehl Andrew J. Caines Clifford Caoile + Frédéric Crozat Michael T. Davis Mattes Dolak - Ulrich Drepper Peter E + Florian Effenberger + Dean Gaudet Aaron Hamid + Darel Henman Magnus Holmgren + Derek Jennings + David Laight Don Libes Paul Lieverse Jindrich Makovicka David Mediavilla + Raphael Moll Oliver Stoeneberg + Martin Thomas Roberto Ragusa + Félix Rauch Maynard Riley + Spinor S Bart Schelstraete Bobby G. Vinyard - Darren Wiebe Jörg Weinmann + Darren Wiebe + Anduin Withers Oliver Yeoh Jamie Zawinski Junkbusters Corp. - Anonymous Coders + Ulrich Drepper + Philip Hazel

`9.1. Filter File Tutorial`

Header filter to change the Content-Type from html to xml.

no-ping

Removes the non-standard ping attribute from + anchor and area HTML tags. +

hide-tor-exit-notation

Header filter to remove the Tor exit node notation + found in Host and Referer headers. +

$Id: user-manual.sgml,v 2.23 2006/10/02 22:43:53 hal9 Exp $ $Id: user-manual.sgml,v 2.26 2006/10/24 11:16:44 hal9 Exp $ 2.1.1. Red Hat, SuSE and Conectiva RPMsRed Hat and Fedora RPMs 2.1.2. 5.1. Red Hat, Fedora and ConectivaRed Hat and Fedora 5.2. 5.3. SuSE 5.4. Windows 5.5. 5.4. Solaris, NetBSD, FreeBSD, HP-UX and others 5.6. 5.5. OS/2 5.7. 5.6. Mac OSX 5.8. 5.7. AmigaOS 5.9. 5.8. Gentoo 5.10. 5.9. Command Line Options6.1. Controlling Privoxy with Your Web Browser8.1. Finding the Right Mix 8.2. How to Edit 8.4.1. The Domain Pattern 8.4.2. The Path Pattern 8.5.36. Summary 8.7.1. default.action 8.7.2. user.action9.1. Filter File Tutorial12.1. License 14.2. Privoxy's Internal Pages2.1.1. Red Hat, SuSE and Conectiva RPMs2.1.1. Red Hat and Fedora RPMs RPMs can be installed with Privoxy sources - is to download the source tarball from our project +>project download page. tar xzvf privoxy-3.0.6-beta-src* [.tgz or .tar.gz] - cd privoxy-3.0.6-beta tar xzvf privoxy-3.0.6-src* [.tgz or .tar.gz] + cd privoxy-3.0.6 For retrieving the current CVS sources, you'll need a CVS client installed. - Note that sources from CVS are typicially development quality, and may not be + Note that sources from CVS are typically development quality, and may not be stable, or well tested. To download CVS source, check the Sourceforge documentation, which might give commands like: Privoxy - as root, and instead it is suggested to create a Privoxy as + an unprivileged user, preferably by creating a "privoxy" user - and group for this purpose. See your local documentation for the correct - command line to do this. adduser, but the command syntax may vary from platform + to platform). If you have GNU Using GNU make, you can have the first four steps @@ -689,6 +699,32 @@ CLASS="SCREEN" > in the freshly downloaded or unpacked source directory. To build an executable with security enhanced features so that + users cannot easily bypass the proxy (e.g. "Go There Anyway"), or + alter their own configurations, configure like this: ./configure --disable-toggle --disable-editor --disable-force Then build as above. Privoxy, it should be run as this same user to - insure write access to configuration and log files. , it must be run as this same user to + insure write access to configuration and log files! Alternately, you can specify ./configure path options. If you are doing - a root install to anywhere else besides /usr/local, be @@ -780,7 +816,8 @@ CLASS="FILENAME" (./configure --help). ). Non-privileged users must of course + have write access permissions to wherever the target installation is going. If you do install to If installing to /usr/local, the docs will go by default - to , the documentation will go + by default to $prefix/share/doc. But if this directory doesn't - exist, it will then try . But if this directory + doesn't exist, it will then try $prefix/doc and install there before - creating a new and install + there before creating a new $prefix/share/doc just for @@ -863,8 +900,8 @@ CLASS="COMMAND" in config (main configuration file). You may want - to check this to make sure all values are correct. If appropriate, +> (main configuration file). You should + check this to make sure all values are correct. If appropriate, an init script will be installed, but it is up to the user to determine how and where to start If install finds previous versions of any local configuration files, these - will not be overwritten, and the new ones will be installed with a +> If install finds previous versions of local configuration files, most of + these will not be overwritten, and the new ones will be installed with a "new" extension. default.action, default.filter, and - standard.action will be overwritten. You will then need to manually update - the other installed configuration files as needed. All template files will be - overwritten. If you have customized, local templates, you should save these - first. If a previous version of will be overwritten. You will then need + to manually update the other installed configuration files as needed. All + template files will be overwritten. If you have customized, local templates, + you should save these first, and in fact it is wise to always save any + important configuration files "just in case". If a previous + version of Privoxy is - already running, you will have to restart it manually. is already running, you will + have to restart it manually. For more detailed instructions on how to build Redhat RPMs, Windows self-extracting installers, building on platforms with diff --git a/doc/webserver/user-manual/introduction.html b/doc/webserver/user-manual/introduction.html index bd6b8b9e..05e7ce6c 100644 --- a/doc/webserver/user-manual/introduction.html +++ b/doc/webserver/user-manual/introduction.html @@ -79,27 +79,11 @@ NAME="INTRODUCTION" >1. Introduction This documentation is included with the current UNRELEASED version of +> This documentation is included with the current stable version of Privoxy, v.3.0.6, - and is mostly complete at this point. The most up to date reference for the - time being is still the comments in the source files and in the individual - configuration files. Development of a new version is currently nearing - completion, and includes significant changes and enhancements over - earlier versions. . Since this is a UNRELEASED version, not all new features are well tested. This - documentation may be slightly out of sync as a result (especially with - CVS sources). And there may be bugs, though hopefully - not many! , v.3.0.6. Privoxy provides many supplemental - features, some of them currently under development, + features, that give the end-user more control, more privacy and more freedom: Web page content filtering (removes banners based on size, +> Web page filtering (text replacements, removes banners based on size, invisible "web-bugs", JavaScript and HTML annoyances, pop-up windows, etc.) +>, JavaScript and HTML annoyances, + pop-up windows, header manipulation, etc.) First a bit of a warning ... blocking ads is much like blocking SPAM: the more aggressive you are about it, the more likely you are to block - things that were not intended. So there is a trade off here. If you want + things that were not intended. And the more likely that some things + may not work as intended. So there is a trade off here. If you want extreme ad free browsing, be prepared to deal with more Privoxy to perform - some task relating to HTTP transactions (i.e. web browsing). We tell + some task relating to WWW transactions (i.e. web browsing). We tell PrivoxyPrivoxy can deal with each URL individually, so, for + instance, the main page text is not touched, but images from such-and-such + server are blocked. The actions we need to know about for ad blocking are: The most important actions for basic ad blocking are: handle-as-image, and +>, + handle-as-empty-document,and block - this action stops - any contact between your browser and any URL patterns that match this - action's configuration. It can be used for blocking ads, but also anything - that is determined to be unwanted. By itself, it simply stops any - communication with the remote server and sends - this is perhaps + the single most used action, and is particularly important for ad blocking. + This action stops any contact between your browser and any URL patterns + that match this action's configuration. It can be used for blocking ads, + but also anything that is determined to be unwanted. By itself, it simply + stops any communication with the remote server and sends + Privoxy's - own built-in BLOCKED page instead to let you now what has happened. +>'s own built-in BLOCKED page instead to + let you now what has happened (with some exceptions, see below). handle-as-empty-document - + sends an empty document instead of Privoxy's + normal BLOCKED HTML page. This is useful for file types that are neither + HTML nor images, such as blocking JavaScript files. + set-image-blocker Actions Files Tutorial. The ideas explained therein also apply to the web-based editor. There are also various + filters that can be used for ad blocking + (filters are a special subset of actions). These + fall into the "advanced" usage category, and are explained in + depth in later sections. Firefox, this can be set under: , this is typically set under: Manual Proxy Configuration + Or optionally on some platforms: Edit -> Preferences -> General -> Connection Settings -> Manual Proxy Configuration With 5.1. Red Hat, Fedora and Conectiva5.1. Red Hat and Fedora A default Red Hat installation may not start 5.3. SuSE We use a script. It will use the file /etc/privoxy/config -as its main configuration file. Note that SuSE starts Privoxy upon booting -your PC. # rcprivoxy start 5.4. Windows 5.3. WindowsClick on the 5.5. Solaris, NetBSD, FreeBSD, HP-UX and others5.4. Solaris, NetBSD, FreeBSD, HP-UX and others Example Unix startup command: 5.6. OS/25.5. OS/2 During installation, 5.7. Mac OSX5.6. Mac OSX During installation, 5.8. AmigaOS5.7. AmigaOS Start 5.9. Gentoo5.8. Gentoo A script is again used. It will use the file 5.10. Command Line Options5.9. Command Line Options 3. What's New in this Release There are many improvements and new features since the last There are many improvements and new features since Privoxy stable release: Privoxy 3.0.3, the last stable release: In addition, there are numerous bug fixes and significant enhancements, including error pages should no longer be cached if the problem is fixed, - much better DNS error handling, and various logging improvements. - The default actions setting is now Cautious. Previous - releases had a default setting of Medium. Experienced - users may want to adjust this, as it is fairly conservative by Privoxy - standards and past practices. See http://config.privoxy.org/edit-actions-list?f=default. New users - should try the default settings for a while before turning up the volume. + much better DNS error handling, various logging improvements, and + configuration updates for better ad blocking and junk elimination. "off" by default. There are also a number of new actions and filters you may want to - consider, most of which are not incorporated into the default settings as - yet (see above). + consider, most of which are not fully incorporated into the default + settings as yet (see above). + The default actions setting is now Cautious. Previous + releases had a default setting of Medium. Experienced + users may want to adjust this, as it is fairly conservative by Privoxy + standards and past practices. See http://config.privoxy.org/edit-actions-list?f=default. New users + should try the default settings for a while before turning up the volume. + The default setting has filtering turned off, which + subsequently means that compression is on. Remember + that filtering does not work on compressed pages, so if you use, or want to + use, filtering, you will need to force compression off. Example: + { +filter{google} +prevent-compression } + .google. + Or if you use a number of filters, or filter many sites, you may just want + to turn off compression for all sites in + default.action (or + user.action). + Also, session-cookies-only is + off by default now. If you've liked this feature in the past, you may want + to turn it back on in user.action now.

9.1. License

9.2. History

3.3. How are actions files configured? What is the easiest way to do this?

3.7. Why is the configuration so complicated?

3.7. How can I make my Yahoo/Hotmail/Gmail account work?

3.11. How can I set up Privoxy to act as a proxy for my +>3.12. How can I set up Privoxy to act as a proxy for my LAN?

3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.

3.13. Why would anybody want to see a checkerboard pattern?

3.14. I see some images being replaced by a text +>3.15. I see some images being replaced by a text instead of the checkerboard image. Why and how do I get rid of this?

7.1. License

7.2. History

1.4. Does Privoxy do anything more than ad blocking?

1.4. What is this new version of +>1.5. What is this new version of "Junkbuster"

1.5. Why 1.6. Why "Privoxy"? Why change the name from Junkbuster at all?

1.8. Can Privoxy make mistakes? +>1.9. Can Privoxy make mistakes? This does not sound very scientific.

1.9. Will I have to configure Privoxy +>1.10. Will I have to configure Privoxy before I can use it?

1.11. Can Privoxy run as a server on a network?

1.15.1. Would you like to participate?

2.5. I just installed Privoxy. Is there anything special I have to do now?

4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing.

4.8. Can Privoxy guarantee I am anonymous?

4.9. A test site says I am not using a Proxy.

4.11. Might some things break because header information or content is being altered?

4.13. What about as a firewall? Can Privoxy protect me?

4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why?

4.15. How can Privoxy filter Secure (HTTPS) URLs?

4.16. Privoxy runs as a "middle-man" in - the interaction between your browser and web sites.

4.19. How can I tell Privoxy to totally ignore certain sites?

5.1. I cannot connect to any websites. Or, I am getting "connection refused" message with every web page. Why?

5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?

5.2. I just added a new rule, but the steenkin ad is +>5.3. I just added a new rule, but the steenkin ad is still getting through. How?

5.10. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?

5.11. My logs show many HOSTS file. If this file has been changed from the original, try reverting it to - see if that helps. Make sure what ever name(s) are used for the local system, + see if that helps. Make sure whatever name(s) are used for the local system, that they resolve both ways.

5.20. Why do my filters work on some sites but not on others?

PRIVOXY

Project Index Page v3.0.5

8.1. Finding the Right Mix

8.2. How to Edit

8.4.1. The Domain Pattern

8.4.2. The Path Pattern

8.5.36. Summary

8.7.1. default.action

8.7.2. user.action

14.2. Privoxy's Internal Pages

6.1. Controlling Privoxy with Your Web Browser

Privoxy Menu

12.1. License

9.1. Filter File Tutorial

5.3. SuSE

5.4. Windows