><H1
CLASS="SECT1"
><A
-NAME="CONFIGURATION"
-></A
->3. Configuration</H1
+NAME="CONFIGURATION">3. Configuration</H1
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="GETUPDATES"
-></A
->3.1. Where can I get updated Actions Files?</H3
+NAME="GETUPDATES">3.1. Where can I get updated Actions Files?</H3
><P
> Based on your feedback and the continuing development, updated actions files will be
made available on the <A
><H3
CLASS="SECT2"
><A
-NAME="NEWCONFIG"
-></A
->3.2. Can I use my old config files?</H3
+NAME="NEWCONFIG">3.2. Can I use my old config files?</H3
><P
> The syntax, number, and purpose of configuration files has substantially
changed from <SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN275"
-></A
->3.3. What is an <SPAN
+NAME="AEN266">3.3. What is an <SPAN
CLASS="QUOTE"
>"actions"</SPAN
> file?</H3
site in one of your actions files, preferably in <TT
CLASS="FILENAME"
>user.action</TT
->.</P
+></P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="ACTIONSS"
-></A
->3.4. The <SPAN
+NAME="ACTIONSS">3.4. The <SPAN
CLASS="QUOTE"
>"actions"</SPAN
> concept confuses me. Please list
><H3
CLASS="SECT2"
><A
-NAME="AEN294"
-></A
->3.5. How are actions files configured? What is the easiest
+NAME="AEN285">3.5. How are actions files configured? What is the easiest
way to do this?</H3
><P
> Actions files are just text files in a special syntax and can be edited
><H3
CLASS="SECT2"
><A
-NAME="AEN302"
-></A
->3.6. There are several different <SPAN
+NAME="AEN293">3.6. There are several different <SPAN
CLASS="QUOTE"
>"actions"</SPAN
> files. What are
><H3
CLASS="SECT2"
><A
-NAME="YAHOO"
-></A
->3.7. How can I make my Yahoo/Hotmail/GMX account work?</H3
+NAME="YAHOO">3.7. How can I make my Yahoo/Hotmail/GMX account work?</H3
><P
> The default configuration shouldn't impact the usability of any of these services.
It will, however, make all cookies temporary, so that your browser will forget your
><H3
CLASS="SECT2"
><A
-NAME="CONFIGFILES"
-></A
->3.8. What's the difference between the
+NAME="CONFIGFILES">3.8. What's the difference between the
<SPAN
CLASS="QUOTE"
>"Cautious"</SPAN
>"Medium"</SPAN
> and <SPAN
CLASS="QUOTE"
->"Radical"</SPAN
+>"Advanced"</SPAN
> defaults?</H3
><P
> Configuring <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is not entirely trivial. To
- help you get started, we provide you with three different default action
- <SPAN
+> is not entirely trivial. To help you get
+ started, we provide you with three different default action <SPAN
CLASS="QUOTE"
->"profiles"</SPAN
-> in the web based actions file editor at <A
+>"packages"</SPAN
+> in
+ the web based actions file editor at <A
HREF="http://config.privoxy.org/show-status"
TARGET="_top"
>http://config.privoxy.org/show-status</A
>.
- See the <A
-HREF="../user-manual/actions-file.html"
-TARGET="_top"
-><I
-CLASS="CITETITLE"
->User
- Manual</I
-></A
-> for a list of actions, and how the default
- profiles are set.
+ The following table shows you, which of the most important features are enabled in each
+ configuration:
</P
><P
+><DIV
+CLASS="TABLE"
+><A
+NAME="AEN328"><P
+><B
+>Table 1. Default Configurations</B
+></P
+><TABLE
+BORDER="1"
+CLASS="CALSTABLE"
+><THEAD
+><TR
+><TH
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Feature</TH
+><TH
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Cautious</TH
+><TH
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Intermadiate</TH
+><TH
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Advanced</TH
+></TR
+></THEAD
+><TBODY
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Ad-blocking by URL</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Ad-filtering by size</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>GIF de-animation</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Referer forging</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Cookie handling</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>none</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>session-only</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>kill</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Pop-up killing</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Fast redirects</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>HTML taming</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>JavaScript taming</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Web-bug killing</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Fun text replacements</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Image tag reordering</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+><TR
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>Ad-filtering by link</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>no</TD
+><TD
+WIDTH="25%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>yes</TD
+></TR
+></TBODY
+></TABLE
+></DIV
+></P
+><P
> Where the defaults are likely to break some sites, exceptions for
known popular <SPAN
CLASS="QUOTE"
>"problem"</SPAN
> sites are included, but in
- general, the more aggressive your default settings are, the more exceptions
- you will have to make later. See the <A
+ general, the more aggressive your default settings are, the more
+
exceptions you will have to make later. See the <A
HREF="../user-manual/index.html"
TARGET="_top"
-><I
-CLASS="CITETITLE"
->User Manual</I
-></A
->
- for a more deatiled discussion.</P
-><P
-> It should be noted that the <SPAN
-CLASS="QUOTE"
->"Radical"</SPAN
-> profile (formerly known
- as the <SPAN
-CLASS="QUOTE"
->"Advanced"</SPAN
-> profile) is not only more
- aggressive, but also includes fun and, extreme usage of most of
- <SPAN
-CLASS="APPLICATION"
->Privoxy's</SPAN
-> features. Use at your own risk!</P
+>user manual</A
+> for a more
+ deatiled discussion.</P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="BROWSECONFIG"
-></A
->3.9. Why can I change the configuration
+NAME="BROWSECONFIG">3.9. Why can I change the configuration
with a browser? Does that not raise security issues?</H3
><P
> It may seem strange that regular users can edit the config files with their
><H3
CLASS="SECT2"
><A
-NAME="AEN367"
-></A
->3.10. What is the <TT
+NAME="AEN431">3.10. What is the <TT
CLASS="FILENAME"
>default.filter</TT
> file? What is a <SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN383"
-></A
->3.11. How can I set up <SPAN
+NAME="AEN447">3.11. How can I set up <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> to act as a proxy for my
>. Configure
all browsers on the network then to use this address and port number.</P
><P
-> Alternately, you can have <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> listen on
- all available interfaces:</P
-><P
-> <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
-> listen-address :8118</PRE
-></TD
-></TR
-></TABLE
-></P
-><P
-> And then use <SPAN
-CLASS="APPLICATION"
->Privoxy's</SPAN
->
- <A
-HREF="../user-manual/config.html#PERMIT-ACCESS"
-TARGET="_top"
->permit-access</A
->
- feature to limit connections. A firewall in this situation is recommended
- as well.</P
-><P
-> The above steps should be the same for any TCP network, regardless of
- operating system.</P
-><P
> If you run <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN409"
-></A
->3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</H3
+NAME="AEN465">3.12. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</H3
><P
> The replacement for blocked images can be controlled with the <A
HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
><H3
CLASS="SECT2"
><A
-NAME="AEN426"
-></A
->3.13. Why would anybody want to see a checkerboard pattern?</H3
+NAME="AEN482">3.13. Why would anybody want to see a checkerboard pattern?</H3
><P
> Remember that <A
HREF="general.html#WHATSANAD"
><H3
CLASS="SECT2"
><A
-NAME="AEN431"
-></A
->3.14. I see some images being replaced by a text
+NAME="AEN487">3.14. I see some images being replaced by a text
instead of the checkerboard image. Why and how do I get rid of this?</H3
><P
> This happens when the banners are not embedded in the HTML code of the
><H3
CLASS="SECT2"
><A
-NAME="SRVANY"
-></A
->3.15. Can <SPAN
+NAME="SRVANY">3.15. Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> run as a service
CLASS="COMMAND"
>srvany.exe</B
>.
- See the discussion at <A
+ The only catch is that this will effectively disable the
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> icon (and its menu!) in the taskbar. You can have
+ one or the other, but not both at this time :( </P
+><P
+> There is a pending feature request for this functionality. See the discussion
+ at <A
HREF="http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118"
TARGET="_top"
>http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118</A
->,
- for details, and a sample configuration.</P
-><P
-> Version 3.0.1 fixes the problem where the icon and menu where not available
- in the taskbar for this usage.</P
+>,
+ for details, and a sample configuration. </P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="OTHERPROXY"
-></A
->3.16. How can I make <SPAN
+NAME="OTHERPROXY">3.16. How can I make <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> work with other
><H3
CLASS="SECT2"
><A
-NAME="PORT-80"
-></A
->3.17. Can I just set <SPAN
+NAME="PORT-80">3.17. Can I just set <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> to use port 80
><H3
CLASS="SECT2"
><A
-NAME="TRANSPARENT"
-></A
->3.18. Can <SPAN
+NAME="TRANSPARENT">3.18. Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> run as a <SPAN
>http://www.transproxy.nlc.net.au/</A
>).</P
></DIV
-><DIV
-CLASS="SECT2"
-><H3
-CLASS="SECT2"
-><A
-NAME="OUTLOOK"
-></A
->3.19. How can I configure <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> for use with <SPAN
-CLASS="APPLICATION"
->Outlook
- Express</SPAN
->?</H3
-><P
-> <SPAN
-CLASS="APPLICATION"
->Outlook Express</SPAN
-> uses <SPAN
-CLASS="APPLICATION"
->Internet Explorer</SPAN
->
- components to both render HTML, and fetch any HTTP requests that may be embedded in an HTML email.
- So however you have <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> configured to work
- with IE, this configuration should automatically be shared.</P
-></DIV
-><DIV
-CLASS="SECT2"
-><H3
-CLASS="SECT2"
-><A
-NAME="OUTLOOK-MORE"
-></A
->3.20. How can I have separate rules just for HTML mail?</H3
-><P
-> The short answer is, you can't. <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> has no way
- of knowing which particular application makes a request, so there is no way to
- distinguish between web pages and HTML mail.
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> just blindly proxies all requests. In the
- case of <SPAN
-CLASS="APPLICATION"
->Outlook Express</SPAN
-> (see above), OE uses
- IE anyway, and there is no way for <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> to ever
- be able to distinguish between them (nor could any other proxy type application for
- that matter).</P
-><P
-> For a good discussion of some of the issues involved (including privacy and
- security issues), see
- <A
-HREF="http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118"
-TARGET="_top"
->http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118</A
->.</P
-></DIV
-><DIV
-CLASS="SECT2"
-><H3
-CLASS="SECT2"
-><A
-NAME="ALLOW-COOKIES"
-></A
->3.21. How can I allow permanent cookies for my trusted sites?</H3
-><P
-> There are several actions that relate to cookies. The default behavior is to
- allow only <SPAN
-CLASS="QUOTE"
->"session cookies"</SPAN
->, which means the cookies only last
- for the current browser session. This eliminates most kinds of abuse related
- to cookies. But there may be cases where we want cookies to last.</P
-><P
-> To disable all cookie actions, so that cookies are allowed unrestricted,
- both in and out, for <TT
-CLASS="LITERAL"
->example.com</TT
->: </P
-><P
-> <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
-> { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} }
- .example.com</PRE
-></TD
-></TR
-></TABLE
-></P
-><P
-> Place the above in <TT
-CLASS="FILENAME"
->user.action</TT
->. Note some of these may
- be off by default anyway, so this might be redundant, but there is no harm
- being explicit in what you want to happen. <TT
-CLASS="FILENAME"
->user.action</TT
->
- includes an alias for this situation, called
- <TT
-CLASS="LITERAL"
->allow-cookies</TT
->.</P
-></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
projects / privoxy.git / blobdiff