.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
-.TH "PRIVOXY" "1" "05 September 2006" "Privoxy 3.0.4 beta" ""
+.TH "PRIVOXY" "1" "13 November 2006" "Privoxy 3.0.6" ""
.SH NAME
privoxy \- Privacy Enhancing Proxy
.SH SYNOPSIS
fail to start.
.SH "DESCRIPTION"
.PP
-\fBPrivoxy\fR is a web proxy with advanced filtering
-capabilities for protecting privacy, modifying web page data, managing
-cookies, controlling access, and removing ads, banners, pop-ups and other
-obnoxious Internet junk. \fBPrivoxy\fR has a very
-flexible configuration and can be customized to suit individual needs and
-tastes. \fBPrivoxy\fR has application for both
-stand-alone systems and multi-user networks.
+Privoxy is a
+web proxy
+with advanced filtering capabilities for protecting
+privacy, modifying web page data, managing
+cookies,
+controlling access, and removing ads, banners, pop-ups and other obnoxious
+Internet junk. Privoxy has a very flexible configuration and can be
+customized to suit individual needs and tastes. Privoxy has application for
+both stand-alone systems and multi-user networks.
.PP
-\fBPrivoxy\fR is based on \fBInternet
-Junkbuster\fR (tm).
+Privoxy is based on Internet Junkbuster (tm).
.SH "INSTALLATION AND USAGE"
.PP
Browsers must be individually configured to use \fBPrivoxy\fR as
and Unix-like systems, these are located in
\fI/etc/privoxy/\fR by default.
.PP
-See the \fIUser Manual\fR for a detailed
-explanation of installation, general usage, all configuration options, new
-features and notes on upgrading.
+\fBPrivoxy\fR uses the concept of \fBactions\fR
+in order to manipulate the data stream between the browser and remote sites.
+There are various actions available with specific functions for such things
+as blocking web sites, managing cookies, etc. These actions can be invoked
+individually or combined, and used against individual URLs, or groups of URLs
+that can be defined using wildcards and regular expressions. The result is
+that the user has greatly enhanced control and freedom.
.PP
The actions list (ad blocks, etc) can also be configured with your
web browser at http://config.privoxy.org/.
\fBPrivoxy's\fR configuration parameters can also be viewed at
the same page. In addition, \fBPrivoxy\fR can be toggled on/off.
This is an internal page, and does not require Internet access.
+.PP
+See the \fIUser Manual\fR for a detailed
+explanation of installation, general usage, all configuration options, new
+features and notes on upgrading.
.SH "SAMPLE CONFIGURATION"
.PP
A brief example of what a simple \fIdefault.action\fR
# Define a few useful custom aliases for later use
{{alias}}
- # Useful aliases
+ # Useful aliases that combine more than one action
+crunch-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies
-crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
- +imageblock = +block +handle-as-image
+ +block-as-image = +block +handle-as-image
# Fragile sites should have the minimum changes
fragile = -block -deanimate-gifs -fast-redirects -filter \\
+deanimate-gifs{last} \\
-downgrade-http-version \\
-fast-redirects \\
-+filter{js-annoyances} \\
+-filter{js-annoyances} \\
-filter{js-events} \\
-+filter{html-annoyances} \\
+-filter{html-annoyances} \\
-filter{content-cookies} \\
+filter{refresh-tags} \\
-+filter{unsolicited-popups} \\
+-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} \\
-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 \\
/ # '/' Match *all* URL patterns
+ # Block all URLs that match these patterns
+ { +block }
+ 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.
- {+imageblock}
+ { +block-as-image }
.ad.doubleclick.net
.a[0-9].yimg.com/(?:(?!/i/).)*$
ad.*.doubleclick.net
- # Block any URLs that match these patterns
- {+block}
- ad*.
- .*ads.
- banner?.
- /.*count(er)?\\.(pl|cgi|exe|dll|asp|php[34]?)
- .hitbox.com
-
# Make exceptions for these harmless ones that would be
# caught by our +block patterns just above.
- {-block}
+ { -block }
adsl.
+ adobe.
advice.
.*downloads.
+ # uploads or downloads
+ /.*loads
.fi
.PP
Then for a \fIuser.action\fR, we would put local,
# Set personal exceptions to the policies in default.action #######
- # Sites where we want persistant cookies, so allow *all* cookies
- {-crunch-cookies -session-cookies-only}
+ # Sites where we want persistent cookies, so allow *all* cookies
+ { -crunch-cookies -session-cookies-only }
.redhat.com
.sun.com
.msdn.microsoft.com
- # This site breaks easily.
- {-block -fast-redirects}
+ # These sites breaks easily. Use our "fragile" alias here.
+ { fragile }
.forbes.com
+ mybank.example.com
+
+ # Replace example.com's style sheet with one of my choosing
+ { +redirect{http://localhost/css-replacements/example.com.css} }
+ example.com/stylesheet.css
.fi
.PP
See the comments in the configuration files themselves, or the
automatically.
.SH "NOTES"
.PP
-This is a beta version of \fBPrivoxy\fR. Not
-all features are well tested.
-.PP
Please see the \fIUser Manual\fR on how to contact the
developers, for feature requests, reporting problems, and other questions.
.SH "SEE ALSO"
caching proxy, which is often used together with \fBPrivoxy\fR.
http://tor.eff.org/,
-\fBTOR\fR can help anonymize web browsing,
+\fBTor\fR can help anonymize web browsing,
web publishing, instant messaging, IRC, SSH, and other applications.
http://www.privoxy.org/developer-manual/,
.SH "DEVELOPMENT TEAM"
.nf
- Fabian Keil
- David Schmidt
-
-
- Johny Agotnes
- Moritz Barsnick
+ Fabian Keil, developer
+ David Schmidt, developer
+
Hal Burgiss
- Mattes Dolak
+ Ian Cummings
Roland Rosenfeld
.fi
.SH "COPYRIGHT AND LICENSE"
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the
\fIGNU General Public License\fR for
-more details, which is available from the Free Software Foundation, Inc, 59
-Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+more details, which is available from the Free Software Foundation, Inc,
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
.PP
You should have received a copy of the \fIGNU General Public License\fR
along with this program; if not, write to the Free Software
-Foundation, Inc. 59 Temple Place - Suite 330
-Boston, MA 02111-1307
+Foundation, Inc. 51 Franklin Street, Fifth Floor
+Boston, MA 02110-1301
USA