X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Factions-file.html;h=c9652e6cdb4045d64145f558ab78ff777b924876;hp=3c82adf592f3d7272ff6e04e4bed0d38b15823d8;hb=e1cb1adbdddac3bd536132926479436743fe46a0;hpb=b47cbf4db0d9e96ddba749f3b44e714f7288443b diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index 3c82adf5..c9652e6c 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -6,7 +6,7 @@
+ ++filter{iframes} # Removes all detected iframes. Should only be enabled for individual sites. ++ |
+
If the ports are missing or invalid, default values will be used. This might change in the future and you shouldn't rely on it. Otherwise incorrect syntax causes - Privoxy to exit.
+ Privoxy to exit. Due to design limitations, invalid + parameter syntax isn't detected until the action is + used the first time.-# Always use direct connections for requests previously tagged as +# Use an ssh tunnel for requests previously tagged as # "User-Agent: fetch libfetch/2.0" and make sure # resuming downloads continues to work. +# # This way you can continue to use Tor for your normal browsing, # without overloading the Tor network with your FreeBSD ports updates # or downloads of bigger files like ISOs. +# # Note that HTTP headers are easy to fake and therefore their # values are as (un)trustworthy as your clients and users. -{+forward-override{forward .} \ +{+forward-override{forward-socks5 10.0.0.2:2222 .} \ -hide-if-modified-since \ -overwrite-last-modified \ } @@ -2771,7 +2910,7 @@ TAG:^User-Agent: fetch libfetch/2\.0$8.5.18. handle-as-empty-document
+ "HANDLE-AS-EMPTY-DOCUMENT">8.5.19. handle-as-empty-document@@ -2849,7 +2988,7 @@ example.org/.*\.js$
8.5.19. handle-as-image
+ "HANDLE-AS-IMAGE">8.5.20. handle-as-image@@ -2938,7 +3077,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
8.5.20. hide-accept-language
+ "HIDE-ACCEPT-LANGUAGE">8.5.21. hide-accept-language@@ -3018,7 +3157,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
8.5.21. hide-content-disposition
+ "HIDE-CONTENT-DISPOSITION">8.5.22. hide-content-disposition@@ -3104,7 +3243,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
8.5.22. hide-if-modified-since
+ "HIDE-IF-MODIFIED-SINCE">8.5.23. hide-if-modified-since@@ -3191,7 +3330,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
8.5.23. hide-from-header
+ "HIDE-FROM-HEADER">8.5.24. hide-from-header@@ -3266,7 +3405,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-8.5.24. +
8.5.25. hide-referrer
@@ -3386,7 +3525,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash8.5.25. hide-user-agent
+ "HIDE-USER-AGENT">8.5.26. hide-user-agent@@ -3475,7 +3614,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-8.5.26. +
8.5.27. limit-connect
@@ -3556,7 +3695,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash8.5.27. limit-cookie-lifetime
+ "LIMIT-COOKIE-LIFETIME">8.5.28. limit-cookie-lifetime@@ -3638,7 +3777,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
8.5.28. prevent-compression
+ "PREVENT-COMPRESSION">8.5.29. prevent-compression@@ -3742,7 +3881,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
8.5.29. overwrite-last-modified
+ "OVERWRITE-LAST-MODIFIED">8.5.30. overwrite-last-modified@@ -3838,7 +3977,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash
-8.5.30. +
8.5.31. redirect
@@ -3880,11 +4019,15 @@ nasty-banner-server.example.com/junk.cgi\?output=trashThe syntax for pcrs commands is documented in the filter file section.
-This action will be ignored if you use it together with - block. It can be combined - with fast-redirects{check-decoded-url} +
Requests can't be blocked and redirected at the same time, + applying this action together with block is a configuration + error. Currently the request is blocked and an error message + logged, the behavior may change in the future and result in + Privoxy rejecting the action file.
+ +This action can be combined with fast-redirects{check-decoded-url} to redirect to a decoded version of a rewritten URL.
Use this action carefully, make sure not to create @@ -3908,7 +4051,7 @@ nasty-banner-server.example.com/junk.cgi\?output=trash example.com/stylesheet\.css # Create a short, easy to remember nickname for a favorite site -# (relies on the browser accept and forward invalid URLs to Privoxy) { +redirect{http://www.privoxy.org/user-manual/actions-file.html} } a @@ -3927,6 +4070,19 @@ undeadly.org/cgi\?action=article&sid=\d*$ {+redirect{s@^http://[^/]*/results\.aspx\?q=([^&]*).*@http://search.yahoo.com/search?p=$1@}} search.msn.com//results\.aspx\?q= +# Redirect http://example.com/&bla=fasel&toChange=foo (and any other value but "bar") +# to http://example.com/&bla=fasel&toChange=bar +# +# The URL pattern makes sure that the following request isn't redirected again. +{+redirect{s@toChange=[^&]+@toChange=bar@}} +example.com/.*toChange=(?!bar) + +# Add a shortcut to look up illumos bugs +{+redirect{s@^http://i([0-9]+)/.*@https://www.illumos.org/issues/$1@}} +# Redirected URL = http://i4974/ +# Redirect Destination = https://www.illumos.org/issues/4974 +i[0-9][0-9][0-9][0-9]*/ + # Redirect remote requests for this manual # to the local version delivered by Privoxy {+redirect{s@^http://www@http://config@}} @@ -3942,7 +4098,7 @@ www.privoxy.org/user-manual/
8.5.31. server-header-filter
+ "SERVER-HEADER-FILTER">8.5.32. server-header-filter@@ -4014,7 +4170,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
8.5.32. server-header-tagger
+ "SERVER-HEADER-TAGGER">8.5.33. server-header-tagger@@ -4076,6 +4232,15 @@ example.org/instance-that-is-delivered-as-xml-but-is-not {+server-header-tagger{content-type}} / +# If the response has a tag starting with 'image/' enable an external +# filter that only applies to images. +# +# Note that the filter is not available by default, it's just a +# silly example. +{+external-filter{rotate-image} +force-text-mode} +TAG:^image/ +
Note that many of these actions have the potential to cause a page @@ -4483,7 +4648,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not together:
Remember all actions @@ -4532,7 +4697,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not