296 lines
4.8 KiB
HTML
296 lines
4.8 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<HTML
|
||
|
|
><HEAD
|
||
|
|
><TITLE
|
||
|
|
>Note to Upgraders</TITLE
|
||
|
|
><META
|
||
|
|
NAME="GENERATOR"
|
||
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
||
|
|
REL="HOME"
|
||
|
|
TITLE="Privoxy 3.0.3 User Manual"
|
||
|
|
HREF="index.html"><LINK
|
||
|
|
REL="PREVIOUS"
|
||
|
|
TITLE="Installation"
|
||
|
|
HREF="installation.html"><LINK
|
||
|
|
REL="NEXT"
|
||
|
|
TITLE="Quickstart to Using Privoxy"
|
||
|
|
HREF="quickstart.html"><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.3 User Manual</TH
|
||
|
|
></TR
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="10%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="bottom"
|
||
|
|
><A
|
||
|
|
HREF="installation.html"
|
||
|
|
ACCESSKEY="P"
|
||
|
|
>Prev</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="80%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="bottom"
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="10%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="bottom"
|
||
|
|
><A
|
||
|
|
HREF="quickstart.html"
|
||
|
|
ACCESSKEY="N"
|
||
|
|
>Next</A
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
><HR
|
||
|
|
ALIGN="LEFT"
|
||
|
|
WIDTH="100%"></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="SECT1"
|
||
|
|
><H1
|
||
|
|
CLASS="SECT1"
|
||
|
|
><A
|
||
|
|
NAME="UPGRADERSNOTE"
|
||
|
|
>3. Note to Upgraders</A
|
||
|
|
></H1
|
||
|
|
><P
|
||
|
|
> There are very significant changes from earlier
|
||
|
|
<SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Junkbuster</SPAN
|
||
|
|
> versions to the current
|
||
|
|
<SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
>. The number, names, syntax, and
|
||
|
|
purposes of configuration files have substantially changed.
|
||
|
|
<SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Junkbuster 2.0.x</SPAN
|
||
|
|
> configuration
|
||
|
|
files will not migrate, <SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Junkbuster 2.9.x</SPAN
|
||
|
|
>
|
||
|
|
and <SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
> configurations will need to be
|
||
|
|
ported. The functionalities of the old <TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>blockfile</TT
|
||
|
|
>,
|
||
|
|
<TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>cookiefile</TT
|
||
|
|
> and <TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>imagelist</TT
|
||
|
|
>
|
||
|
|
are now combined into the <A
|
||
|
|
HREF="actions-file.html"
|
||
|
|
><SPAN
|
||
|
|
CLASS="QUOTE"
|
||
|
|
>"actions
|
||
|
|
files"</SPAN
|
||
|
|
></A
|
||
|
|
>.
|
||
|
|
<TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>default.action</TT
|
||
|
|
>, is the main actions file. Local
|
||
|
|
exceptions should best be put into <TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>user.action</TT
|
||
|
|
>.</P
|
||
|
|
><P
|
||
|
|
> A <A
|
||
|
|
HREF="filter-file.html"
|
||
|
|
><SPAN
|
||
|
|
CLASS="QUOTE"
|
||
|
|
>"filter file"</SPAN
|
||
|
|
></A
|
||
|
|
> (typically
|
||
|
|
<TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>default.filter</TT
|
||
|
|
>) is new as of <SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy
|
||
|
|
2.9.x</SPAN
|
||
|
|
>, and provides some of the new sophistication (explained
|
||
|
|
below). <TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>config</TT
|
||
|
|
> is much the same as before.</P
|
||
|
|
><P
|
||
|
|
> If upgrading from a 2.0.x version, you will have to use the new config
|
||
|
|
files, and possibly adapt any personal rules from your older files.
|
||
|
|
When porting personal rules over from the old <TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>blockfile</TT
|
||
|
|
>
|
||
|
|
to the new actions files, please note that even the pattern syntax has
|
||
|
|
changed. If upgrading from 2.9.x development versions, it is still
|
||
|
|
recommended to use the new configuration files.</P
|
||
|
|
><P
|
||
|
|
> A quick list of things to be aware of before upgrading: </P
|
||
|
|
><P
|
||
|
|
> <P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
> The default listening port is now 8118 due to a conflict with another
|
||
|
|
service (NAS).
|
||
|
|
</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>
|
||
|
|
Some installers may remove earlier versions completely. Save any
|
||
|
|
important configuration files!
|
||
|
|
</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
> <SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
> is controllable with a web browser
|
||
|
|
at 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
|
||
|
|
>). Many
|
||
|
|
aspects of configuration can be done here, including temporarily disabling
|
||
|
|
<SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
>.
|
||
|
|
</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
> The primary configuration files for cookie management, ad and banner
|
||
|
|
blocking, and many other aspects of <SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
>
|
||
|
|
configuration are the <A
|
||
|
|
HREF="actions-file.html"
|
||
|
|
>actions
|
||
|
|
files</A
|
||
|
|
>. It is strongly recommended to become familiar with the new
|
||
|
|
actions concept below, before modifying these files. Locally defined rules
|
||
|
|
should go into <TT
|
||
|
|
CLASS="FILENAME"
|
||
|
|
>user.action</TT
|
||
|
|
>.
|
||
|
|
</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>
|
||
|
|
Some installers may not automatically start
|
||
|
|
<SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
> after installation.
|
||
|
|
</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
></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="installation.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="quickstart.html"
|
||
|
|
ACCESSKEY="N"
|
||
|
|
>Next</A
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="top"
|
||
|
|
>Installation</TD
|
||
|
|
><TD
|
||
|
|
WIDTH="34%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="top"
|
||
|
|
> </TD
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="top"
|
||
|
|
>Quickstart to Using <SPAN
|
||
|
|
CLASS="APPLICATION"
|
||
|
|
>Privoxy</SPAN
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
></DIV
|
||
|
|
></BODY
|
||
|
|
></HTML
|
||
|
|
>
|