Default Configurations
@@ -2069,7 +2104,7 @@ for details.
Image tag reorderingno
- no
+ yesyes
@@ -2248,9 +2283,9 @@ for details.
The pattern matching syntax is different for the domain and path parts of
the URL. The domain part uses a simple globbing type matching technique,
- while the path part uses a more flexible
+ while the path part uses more flexible
Regular
- Expressions (PCRE) based syntax.
+ Expressions (POSIX 1003.2).
@@ -2275,7 +2310,7 @@ for details.
- www.example.com/index.html$
+ www.example.com/index.html
matches all the documents on www.example.com
@@ -2429,20 +2464,16 @@ for details.
The Path Pattern
- Privoxy uses Perl compatible (PCRE)
+ Privoxy uses modern POSIX 1003.2
Regular
- Expression based syntax
- (through the PCRE library) for
- matching the path portion (after the slash), and is thus more flexible.
+ Expressions for matching the path portion (after the slash),
+ and is thus more flexible.
There is an Appendix with a brief quick-start into regular
- expressions, and full (very technical) documentation on PCRE regex syntax is available on-line
- at http://www.pcre.org/man.txt.
- You might also find the Perl man page on regular expressions (man perlre)
- useful, which is available on-line at http://perldoc.perl.org/perlre.html.
+ expressions, you also might want to have a look at your operating system's documentation
+ on regular expressions (try man re_format).
@@ -2840,17 +2871,6 @@ for details.
to the blocked content (the latter only if the force feature is available and
enabled).
-
A very important exception occurs if bothblock and handle-as-image,
@@ -3052,6 +3072,25 @@ This doesn't actually work in all browser configuration and the user probably do
# Tag every request with the User-Agent header
{+client-header-tagger{user-agent}}
/
+
+# Tagging itself doesn't change the action
+# settings, sections with TAG patterns do:
+#
+# If it's a download agent, use a different forwarding proxy,
+# show the real User-Agent and make sure resume works.
+{+forward-override{forward-socks5 10.0.0.2:2222 .} \
+ -hide-if-modified-since \
+ -overwrite-last-modified \
+ -hide-user-agent \
+ -filter \
+ -deanimate-gifs \
+}
+TAG:^User-Agent: NetBSD-ftp/
+TAG:^User-Agent: Novell ZYPP Installer
+TAG:^User-Agent: RPM APT-HTTP/
+TAG:^User-Agent: fetch libfetch/
+TAG:^User-Agent: Ubuntu APT-HTTP/
+TAG:^User-Agent: MPlayer/
@@ -3948,23 +3987,23 @@ problem-host.example.com
- +filter{js-annoyances} # Get rid of particularly annoying JavaScript abuse
+ +filter{js-annoyances} # Get rid of particularly annoying JavaScript abuse.
- +filter{js-events} # Kill all JS event bindings (Radically destructive! Only for extra nasty sites)
+ +filter{js-events} # Kill all JS event bindings and timers (Radically destructive! Only for extra nasty sites).
- +filter{html-annoyances} # Get rid of particularly annoying HTML abuse
+ +filter{html-annoyances} # Get rid of particularly annoying HTML abuse.
- +filter{content-cookies} # Kill cookies that come in the HTML or JS content
+ +filter{content-cookies} # Kill cookies that come in the HTML or JS content.
- +filter{refresh-tags} # Kill automatic refresh tags (for dial-on-demand setups)
+ +filter{refresh-tags} # Kill automatic refresh tags (for dial-on-demand setups).
@@ -3976,43 +4015,43 @@ problem-host.example.com
- +filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective
+ +filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective.
- +filter{banners-by-size} # Kill banners by size
+ +filter{banners-by-size} # Kill banners by size.
- +filter{banners-by-link} # Kill banners by their links to known clicktrackers
+ +filter{banners-by-link} # Kill banners by their links to known clicktrackers.
- +filter{webbugs} # Squish WebBugs (1x1 invisible GIFs used for user tracking)
+ +filter{webbugs} # Squish WebBugs (1x1 invisible GIFs used for user tracking).
- +filter{tiny-textforms} # Extend those tiny textareas up to 40x80 and kill the hard wrap
+ +filter{tiny-textforms} # Extend those tiny textareas up to 40x80 and kill the hard wrap.
- +filter{jumping-windows} # Prevent windows from resizing and moving themselves
+ +filter{jumping-windows} # Prevent windows from resizing and moving themselves.
- +filter{frameset-borders} # Give frames a border and make them resizeable
+ +filter{frameset-borders} # Give frames a border and make them resizable.
- +filter{demoronizer} # Fix MS's non-standard use of standard charsets
+ +filter{demoronizer} # Fix MS's non-standard use of standard charsets.
- +filter{shockwave-flash} # Kill embedded Shockwave Flash objects
+ +filter{shockwave-flash} # Kill embedded Shockwave Flash objects.
- +filter{quicktime-kioskmode} # Make Quicktime movies savable
+ +filter{quicktime-kioskmode} # Make Quicktime movies saveable.
@@ -4020,35 +4059,35 @@ problem-host.example.com
- +filter{crude-parental} # Crude parental filtering (demo only)
+ +filter{crude-parental} # Crude parental filtering. Note that this filter doesn't work reliably.
- +filter{ie-exploits} # Disable a known Internet Explorer bug exploits
+ +filter{ie-exploits} # Disable some known Internet Explorer bug exploits.
- +filter{site-specifics} # Custom filters for specific site related problems
+ +filter{site-specifics} # Cure for site-specific problems. Don't apply generally!
+
+
+
+ +filter{no-ping} # Removes non-standard ping attributes in <a> and <area> tags.
- +filter{google} # Removes text ads and other Google specific improvements
+ +filter{google} # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement.
- +filter{yahoo} # Removes text ads and other Yahoo specific improvements
+ +filter{yahoo} # CSS-based block for Yahoo text ads. Also removes a width limitation.
- +filter{msn} # Removes text ads and other MSN specific improvements
+ +filter{msn} # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation.
- +filter{blogspot} # Cleans up Blogspot blogs
-
-
-
- +filter{no-ping} # Removes non-standard ping attributes from anchor and area tags
+ +filter{blogspot} # Cleans up some Blogspot blogs. Read the fine print before using this.
@@ -5345,6 +5384,10 @@ new action
and be aware that using your own redirects might make it
possible to fingerprint your requests.
+
+ In case of problems with your redirects, or simply to watch
+ them working, enable debug 128.
+
@@ -5365,143 +5408,24 @@ new action
# (Note the $ at the end of the URL pattern to make sure
# the request for the rewritten URL isn't redirected as well)
{+redirect{s@$@&mode=expanded@}}
-undeadly.org/cgi\?action=article&sid=\d*$
-
-
-
+undeadly.org/cgi\?action=article&sid=\d*$
-
-
-
-
-
-
-send-vanilla-wafer
-
-
-
- Typical use:
-
-
- Feed log analysis scripts with useless data.
-
-
-
-
-
- Effect:
-
-
- Sends a cookie with each request stating that you do not accept any copyright
- on cookies sent to you, and asking the site operator not to track you.
-
-
-
-
-
- Type:
-
-
- Boolean.
-
-
-
-
- Parameter:
-
-
- N/A
-
-
-
-
-
- Notes:
-
-
- The vanilla wafer is a (relatively) unique header and could conceivably be used to track you.
-
-
- This action is rarely used and not enabled in the default configuration.
-
-
-
-
-
- Example usage:
-
-
- +send-vanilla-wafer
-
-
-
-
-
-
-
-
-
-
-send-wafer
+# Redirect Google search requests to MSN
+{+redirect{s@^http://[^/]*/search\?q=([^&]*).*@http://search.msn.com/results.aspx?q=$1@}}
+.google.com/search
-
-
- Typical use:
-
-
- Send custom cookies or feed log analysis scripts with even more useless data.
-
-
-
+# Redirect MSN search requests to Yahoo
+{+redirect{s@^http://[^/]*/results\.aspx\?q=([^&]*).*@http://search.yahoo.com/search?p=$1@}}
+search.msn.com//results\.aspx\?q=
-
- Effect:
-
-
- Sends a custom, user-defined cookie with each request.
+# Redirect remote requests for this manual
+# to the local version delivered by Privoxy
+{+redirect{s@^http://www@http://config@}}
+www.privoxy.org/user-manual/
-
- Type:
-
-
- Multi-value.
-
-
-
-
- Parameter:
-
-
- A string of the form name=value.
-
-
-
-
-
- Notes:
-
-
- Being multi-valued, multiple instances of this action can apply to the same request,
- resulting in multiple cookies being sent.
-
-
- This action is rarely used and not enabled in the default configuration.
-
-
-
-
- Example usage (section):
-
-
- {+send-wafer{UsingPrivoxy=true}}
-my-internal-testing-server.void
-
-
-
@@ -8403,8 +8327,6 @@ In file: user.action [ View ][ Edit ][ View ][ Edit ][ View ][ Edit ]