514 lines
9.8 KiB
HTML
514 lines
9.8 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||
<HTML
|
||
><HEAD
|
||
><TITLE
|
||
>Privoxy Configuration</TITLE
|
||
><META
|
||
NAME="GENERATOR"
|
||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||
REL="HOME"
|
||
TITLE="Privoxy 3.0.12 User Manual"
|
||
HREF="index.html"><LINK
|
||
REL="PREVIOUS"
|
||
TITLE="Starting Privoxy"
|
||
HREF="startup.html"><LINK
|
||
REL="NEXT"
|
||
TITLE="The Main Configuration File"
|
||
HREF="config.html"><LINK
|
||
REL="STYLESHEET"
|
||
TYPE="text/css"
|
||
HREF="../p_doc.css"><META
|
||
HTTP-EQUIV="Content-Type"
|
||
CONTENT="text/html;
|
||
charset=ISO-8859-1">
|
||
<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
|
||
</head
|
||
><BODY
|
||
CLASS="SECT1"
|
||
BGCOLOR="#EEEEEE"
|
||
TEXT="#000000"
|
||
LINK="#0000FF"
|
||
VLINK="#840084"
|
||
ALINK="#0000FF"
|
||
><DIV
|
||
CLASS="NAVHEADER"
|
||
><TABLE
|
||
SUMMARY="Header navigation table"
|
||
WIDTH="100%"
|
||
BORDER="0"
|
||
CELLPADDING="0"
|
||
CELLSPACING="0"
|
||
><TR
|
||
><TH
|
||
COLSPAN="3"
|
||
ALIGN="center"
|
||
>Privoxy 3.0.12 User Manual</TH
|
||
></TR
|
||
><TR
|
||
><TD
|
||
WIDTH="10%"
|
||
ALIGN="left"
|
||
VALIGN="bottom"
|
||
><A
|
||
HREF="startup.html"
|
||
ACCESSKEY="P"
|
||
>Prev</A
|
||
></TD
|
||
><TD
|
||
WIDTH="80%"
|
||
ALIGN="center"
|
||
VALIGN="bottom"
|
||
></TD
|
||
><TD
|
||
WIDTH="10%"
|
||
ALIGN="right"
|
||
VALIGN="bottom"
|
||
><A
|
||
HREF="config.html"
|
||
ACCESSKEY="N"
|
||
>Next</A
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><HR
|
||
ALIGN="LEFT"
|
||
WIDTH="100%"></DIV
|
||
><DIV
|
||
CLASS="SECT1"
|
||
><H1
|
||
CLASS="SECT1"
|
||
><A
|
||
NAME="CONFIGURATION"
|
||
>6. Privoxy Configuration</A
|
||
></H1
|
||
><P
|
||
> All <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> configuration is stored
|
||
in text files. These files can be edited with a text editor.
|
||
Many important aspects of <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> can
|
||
also be controlled easily with a web browser.
|
||
</P
|
||
><DIV
|
||
CLASS="SECT2"
|
||
><H2
|
||
CLASS="SECT2"
|
||
><A
|
||
NAME="AEN776"
|
||
>6.1. Controlling Privoxy with Your Web Browser</A
|
||
></H2
|
||
><P
|
||
> <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
>'s user interface can be reached through the special
|
||
URL <A
|
||
HREF="http://config.privoxy.org/"
|
||
TARGET="_top"
|
||
>http://config.privoxy.org/</A
|
||
>
|
||
(shortcut: <A
|
||
HREF="http://p.p/"
|
||
TARGET="_top"
|
||
>http://p.p/</A
|
||
>),
|
||
which is a built-in page and works without Internet access.
|
||
You will see the following section: </P
|
||
><TABLE
|
||
BORDER="0"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> <H2
|
||
CLASS="BRIDGEHEAD"
|
||
><A
|
||
NAME="AEN784"
|
||
></A
|
||
><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Privoxy Menu</H2
|
||
><P
|
||
></P
|
||
><TABLE
|
||
BORDER="0"
|
||
><TBODY
|
||
><TR
|
||
><TD
|
||
> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>▪<EFBFBD><EFBFBD><A
|
||
HREF="http://config.privoxy.org/show-status"
|
||
TARGET="_top"
|
||
>View & change the current configuration</A
|
||
>
|
||
</TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>▪<EFBFBD><EFBFBD><A
|
||
HREF="http://config.privoxy.org/show-version"
|
||
TARGET="_top"
|
||
>View the source code version numbers</A
|
||
>
|
||
</TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>▪<EFBFBD><EFBFBD><A
|
||
HREF="http://config.privoxy.org/show-request"
|
||
TARGET="_top"
|
||
>View the request headers.</A
|
||
>
|
||
</TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>▪<EFBFBD><EFBFBD><A
|
||
HREF="http://config.privoxy.org/show-url-info"
|
||
TARGET="_top"
|
||
>Look up which actions apply to a URL and why</A
|
||
>
|
||
</TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>▪<EFBFBD><EFBFBD><A
|
||
HREF="http://config.privoxy.org/toggle"
|
||
TARGET="_top"
|
||
>Toggle Privoxy on or off</A
|
||
>
|
||
</TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>▪<EFBFBD><EFBFBD><A
|
||
HREF="http://www.privoxy.org/3.0.12/user-manual/"
|
||
TARGET="_top"
|
||
>Documentation</A
|
||
>
|
||
</TD
|
||
></TR
|
||
></TBODY
|
||
></TABLE
|
||
><P
|
||
></P
|
||
></PRE
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
> This should be self-explanatory. Note the first item leads to an editor for the
|
||
<A
|
||
HREF="actions-file.html"
|
||
>actions files</A
|
||
>, which is where the ad, banner,
|
||
cookie, and URL blocking magic is configured as well as other advanced features of
|
||
<SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
>. This is an easy way to adjust various
|
||
aspects of <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> configuration. The actions
|
||
file, and other configuration files, are explained in detail below. </P
|
||
><P
|
||
> <SPAN
|
||
CLASS="QUOTE"
|
||
>"Toggle Privoxy On or Off"</SPAN
|
||
> is handy for sites that might
|
||
have problems with your current actions and filters. You can in fact use
|
||
it as a test to see whether it is <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
>
|
||
causing the problem or not. <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> continues
|
||
to run as a proxy in this case, but all manipulation is disabled, i.e.
|
||
<SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> acts like a normal forwarding proxy. There
|
||
is even a toggle <A
|
||
HREF="appendix.html#BOOKMARKLETS"
|
||
>Bookmarklet</A
|
||
> offered, so
|
||
that you can toggle <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> with one click from
|
||
your browser.</P
|
||
><P
|
||
> Note that several of the features described above are disabled by default
|
||
in <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> 3.0.7 beta and later.
|
||
Check the
|
||
<A
|
||
HREF="config.html"
|
||
TARGET="_top"
|
||
>configuration file</A
|
||
> to learn why
|
||
and in which cases it's safe to enable them again.</P
|
||
></DIV
|
||
><DIV
|
||
CLASS="SECT2"
|
||
><H2
|
||
CLASS="SECT2"
|
||
><A
|
||
NAME="CONFOVERVIEW"
|
||
>6.2. Configuration Files Overview</A
|
||
></H2
|
||
><P
|
||
> For Unix, *BSD and Linux, all configuration files are located in
|
||
<TT
|
||
CLASS="FILENAME"
|
||
>/etc/privoxy/</TT
|
||
> by default. For MS Windows, OS/2, and
|
||
AmigaOS these are all in the same directory as the
|
||
<SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> executable. </P
|
||
><P
|
||
> The installed defaults provide a reasonable starting point, though
|
||
some settings may be aggressive by some standards. For the time being, the
|
||
principle configuration files are:</P
|
||
><P
|
||
> <P
|
||
></P
|
||
><UL
|
||
><LI
|
||
><P
|
||
> The <A
|
||
HREF="config.html"
|
||
>main configuration file</A
|
||
> is named <TT
|
||
CLASS="FILENAME"
|
||
>config</TT
|
||
>
|
||
on Linux, Unix, BSD, OS/2, and AmigaOS and <TT
|
||
CLASS="FILENAME"
|
||
>config.txt</TT
|
||
>
|
||
on Windows. This is a required file.
|
||
</P
|
||
></LI
|
||
><LI
|
||
><P
|
||
> <TT
|
||
CLASS="FILENAME"
|
||
>match-all.action</TT
|
||
> is used to define which <SPAN
|
||
CLASS="QUOTE"
|
||
>"actions"</SPAN
|
||
>
|
||
relating to banner-blocking, images, pop-ups, content modification, cookie handling
|
||
etc should be applied by default. It should be the first actions file loaded.
|
||
</P
|
||
><P
|
||
> <TT
|
||
CLASS="FILENAME"
|
||
>default.action</TT
|
||
> defines many exceptions (both positive and negative)
|
||
from the default set of actions that's configured in <TT
|
||
CLASS="FILENAME"
|
||
>match-all.action</TT
|
||
>.
|
||
It should be the second actions file loaded and shouldn't be edited by the user.
|
||
</P
|
||
><P
|
||
> Multiple actions files may be defined in <TT
|
||
CLASS="FILENAME"
|
||
>config</TT
|
||
>. These
|
||
are processed in the order they are defined. Local customizations and locally
|
||
preferred exceptions to the default policies as defined in
|
||
<TT
|
||
CLASS="FILENAME"
|
||
>match-all.action</TT
|
||
> (which you will most probably want
|
||
to define sooner or later) are best applied in <TT
|
||
CLASS="FILENAME"
|
||
>user.action</TT
|
||
>,
|
||
where you can preserve them across upgrades. The file isn't installed by all
|
||
installers, but you can easily create it yourself with a text editor.
|
||
</P
|
||
><P
|
||
>
|
||
There is also a web based editor that can be accessed from
|
||
<A
|
||
HREF="http://config.privoxy.org/show-status"
|
||
TARGET="_top"
|
||
>http://config.privoxy.org/show-status</A
|
||
>
|
||
(Shortcut: <A
|
||
HREF="http://p.p/show-status"
|
||
TARGET="_top"
|
||
>http://p.p/show-status</A
|
||
>) for the
|
||
various actions files.
|
||
</P
|
||
></LI
|
||
><LI
|
||
><P
|
||
> <SPAN
|
||
CLASS="QUOTE"
|
||
>"Filter files"</SPAN
|
||
> (the <A
|
||
HREF="filter-file.html"
|
||
>filter
|
||
file</A
|
||
>) can be used to re-write the raw page content, including
|
||
viewable text as well as embedded HTML and JavaScript, and whatever else
|
||
lurks on any given web page. The filtering jobs are only pre-defined here;
|
||
whether to apply them or not is up to the actions files.
|
||
<TT
|
||
CLASS="FILENAME"
|
||
>default.filter</TT
|
||
> includes various filters made
|
||
available for use by the developers. Some are much more intrusive than
|
||
others, and all should be used with caution. You may define additional
|
||
filter files in <TT
|
||
CLASS="FILENAME"
|
||
>config</TT
|
||
> as you can with
|
||
actions files. We suggest <TT
|
||
CLASS="FILENAME"
|
||
>user.filter</TT
|
||
> for any
|
||
locally defined filters or customizations.
|
||
</P
|
||
></LI
|
||
></UL
|
||
></P
|
||
><P
|
||
> The syntax of the configuration and filter files may change between different
|
||
Privoxy versions, unfortunately some enhancements cost backwards compatibility.
|
||
</P
|
||
><P
|
||
> All files use the <SPAN
|
||
CLASS="QUOTE"
|
||
>"<TT
|
||
CLASS="LITERAL"
|
||
>#</TT
|
||
>"</SPAN
|
||
> character to denote a
|
||
comment (the rest of the line will be ignored) and understand line continuation
|
||
through placing a backslash ("<TT
|
||
CLASS="LITERAL"
|
||
>\</TT
|
||
>") as the very last character
|
||
in a line. If the <TT
|
||
CLASS="LITERAL"
|
||
>#</TT
|
||
> is preceded by a backslash, it looses
|
||
its special function. Placing a <TT
|
||
CLASS="LITERAL"
|
||
>#</TT
|
||
> in front of an otherwise
|
||
valid configuration line to prevent it from being interpreted is called "commenting
|
||
out" that line. Blank lines are ignored.</P
|
||
><P
|
||
> The actions files and filter files
|
||
can use Perl style <A
|
||
HREF="appendix.html#REGEX"
|
||
>regular expressions</A
|
||
> for
|
||
maximum flexibility. </P
|
||
><P
|
||
> After making any changes, there is no need to restart
|
||
<SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> in order for the changes to take
|
||
effect. <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
> detects such changes
|
||
automatically. Note, however, that it may take one or two additional
|
||
requests for the change to take effect. When changing the listening address
|
||
of <SPAN
|
||
CLASS="APPLICATION"
|
||
>Privoxy</SPAN
|
||
>, these <SPAN
|
||
CLASS="QUOTE"
|
||
>"wake up"</SPAN
|
||
> requests
|
||
must obviously be sent to the <SPAN
|
||
CLASS="emphasis"
|
||
><I
|
||
CLASS="EMPHASIS"
|
||
>old</I
|
||
></SPAN
|
||
> listening address.</P
|
||
></DIV
|
||
></DIV
|
||
><DIV
|
||
CLASS="NAVFOOTER"
|
||
><HR
|
||
ALIGN="LEFT"
|
||
WIDTH="100%"><TABLE
|
||
SUMMARY="Footer navigation table"
|
||
WIDTH="100%"
|
||
BORDER="0"
|
||
CELLPADDING="0"
|
||
CELLSPACING="0"
|
||
><TR
|
||
><TD
|
||
WIDTH="33%"
|
||
ALIGN="left"
|
||
VALIGN="top"
|
||
><A
|
||
HREF="startup.html"
|
||
ACCESSKEY="P"
|
||
>Prev</A
|
||
></TD
|
||
><TD
|
||
WIDTH="34%"
|
||
ALIGN="center"
|
||
VALIGN="top"
|
||
><A
|
||
HREF="index.html"
|
||
ACCESSKEY="H"
|
||
>Home</A
|
||
></TD
|
||
><TD
|
||
WIDTH="33%"
|
||
ALIGN="right"
|
||
VALIGN="top"
|
||
><A
|
||
HREF="config.html"
|
||
ACCESSKEY="N"
|
||
>Next</A
|
||
></TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
WIDTH="33%"
|
||
ALIGN="left"
|
||
VALIGN="top"
|
||
>Starting Privoxy</TD
|
||
><TD
|
||
WIDTH="34%"
|
||
ALIGN="center"
|
||
VALIGN="top"
|
||
> </TD
|
||
><TD
|
||
WIDTH="33%"
|
||
ALIGN="right"
|
||
VALIGN="top"
|
||
>The Main Configuration File</TD
|
||
></TR
|
||
></TABLE
|
||
></DIV
|
||
></BODY
|
||
></HTML
|
||
> |