X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Ffaq%2Fconfiguration.html;h=98e5442a64e0a87b49451aa51a84304bcafcac30;hp=01c001bdbd9681d80dffc716e21ddefb3ee80b23;hb=7ecdaff4e6e989eaa70d1ffec88c0e5dfbeb19bb;hpb=ecc029c86cab6da6b915bb80714db895e78034a2 diff --git a/doc/webserver/faq/configuration.html b/doc/webserver/faq/configuration.html index 01c001bd..98e5442a 100644 --- a/doc/webserver/faq/configuration.html +++ b/doc/webserver/faq/configuration.html @@ -84,7 +84,7 @@ CLASS="SECT2" >

3.1. What exactly is an "actions"actions" +> that are used to manipulate and control web page data. 3.2. The "actions" concept confuses me. Please list +> concept confuses me. Please list some of these "actions"

3.3. How are actions files configured? What is the easiest way to do this?

View & change the current configuration" from the menu. Note - that this feature must be explicitly enabled in the main config file +> from the menu. Note + that this feature must be explicitly enabled in the main config file (see

3.4. There are several different "actions"

Three actions files - are being included by the developers, to be used for - different purposes: These are - default.action, the "main" actions file - which is actively maintained by the Privoxy - developers and typically sets the default policies, user.action, - where users are encouraged to make their private customizations. - Please see Please have a look at the the actions chapterUser Manual for a more - detailed explanation.

Earlier versions included three different versions of the - default.action file. The new scheme allows for - greater flexibility of local configuration, and for browser based - selection of pre-defined "aggressiveness" levels.

for a detailed explanation.

3.5. Where can I get updated Actions Files?

Based on your feedback and the continuing development, updates of +> Based on your feedback and the continuing development, updates of default.action will be made available from time to time on the files section of our project page. @@ -309,11 +278,11 @@ TARGET="_top" CLASS="APPLICATION" >Privoxy or the actions file, subscribe to our announce mailing list, ijbswa-announce@lists.sourceforge.net. +>, privoxy-announce@lists.privoxy.org.

"Complicated" is in the eye of the beholder. Those that are - familiar with some of the underlying concepts, such as regular expression - syntax, take to it like a fish takes to water. Also, software that tries - hard to be "user friendly", often lacks sophistication and - flexibility. There is always that trade-off there between power vs. - easy-of-use. Furthermore, anyone is welcome to contribute ideas and - implementations to enhance Privoxy. +> is in the eye of the beholder. +

Privoxy is currently mainly written by and for people who are already + familiar with the underlying concepts like regular expressions, HTTP and HTML, + or are willing to become familiar with them to be able to get the most + out of a powerful and flexible tool such as Privoxy. +

While everybody is expected to be able to get a Privoxy default installation + up and running, fine-tuning requires a certain amount of background + information and Privoxy's documentation mainly concentrates on the + Privoxy-specific parts while only providing references to the rest. +

If you or anyone you know has the skills, time and energy to + reduce the barrier of entry, please get involved.

cookies +> temporary, so that your browser will forget your login credentials in between browser sessions. If you would like not to have to log in manually each time you access those websites, simply turn off all cookie handling @@ -386,8 +362,7 @@ CLASS="FILENAME" > file. An example for yahoo might look like:

-

These kinds of sites are often quite complex and heavy with +> These kinds of sites are often quite complex and heavy with Javascript and +> and thus "fragile"still a problem, +> a problem, we have an just for such sticky situations:

-

Be sure to flush your browser's caches whenever making these kinds of changes, just to make sure the changes

Make sure the domain, host and path are appropriate as well. Your browser can - tell you where you are specifically and you should use that information for - your configuration settings. Note that above it is not referenced as + tell you where you are specifically and you should use that information for + your configuration settings. Note that above it is not referenced as gmail.comUser Manual for a list of actions, and how the default +> for a list of actions, and how the default profiles are set.

"problem" sites are included, but in general, the more aggressive your default settings are, the more exceptions - you will have to make later. New users are best to start off in + you will have to make later. New users are best to start off in "Cautious" setting. This is safest and will have the fewest +> setting. This is safest and will have the fewest problems. See the It should be noted that the "Advanced" profile (formerly known +> profile (formerly known as the "Adventuresome" profile) is more - aggressive, and will make use of some of + aggressive, and will make use of some of Privoxy's3.10. Why can I change the configuration +>3.10. Why can I change the configuration with a browser? Does that not raise security issues?

Privoxy for multiple untrusted users (e.g. in a LAN) or aren't entirely in control of your own browser, you will probably want - to make sure that the the web-based editor and remote toggle features are + to make sure that the web-based editor and remote toggle features are "off"

3.11. What is the default.filter action in one of the actions files. Content filtering is automatically - disabled for inappropriate MIME types, but if you now better than Privoxy + disabled for inappropriate MIME types, but if you know better than Privoxy what should or should not be filtered you can filter any content you like.

Filters should @@ -712,28 +682,28 @@ CLASS="LITERAL" is a completely different action, and is more typically used to block ads and unwanted sites.

If you are familiar with regular expressions, and HTML, you can look at +> If you are familiar with regular expressions, and HTML, you can look at the provided default.filter with a text editor and define your own filters. This is potentially a very powerful feature, but - requires some expertise in both regular expressions and HTML/HTTP. - You should - place any modifications to the default filters, or any new ones you create + requires some expertise in both regular expressions and HTML/HTTP. + You should + place any modifications to the default filters, or any new ones you create in a separate file, such as user.filter, so they won't - be overwritten during upgrades. - The ability to define multiple filter files +>, so they won't + be overwritten during upgrades. + The ability to define multiple filter files in config is a new feature as of v. 3.0.5.

There is no GUI editor option for this part of the configuration, - but you can disable/enable the various pre-defined filters of the included +> There is no GUI editor option for this part of the configuration, + but you can disable/enable the various pre-defined filters of the included default.filter

If you intend to develop your own filters, you might want to have a look at Privoxy-Filter-Test.

3.12. How can I set up Privoxy to act as a proxy for my +>3.12. How can I set up Privoxy to act as a proxy for my LAN?

By default, Privoxy only responds to requests +> only responds to requests from 127.0.0.1Privoxy on port 8118, this line should look like:

Save the file, and restart Privoxy. Configure +>. Configure all browsers on the network then to use this address and port number.

Alternately, you can have Privoxy listen on +> listen on all available interfaces:

And then use Privoxy's +> permit-access - feature to limit connections. A firewall in this situation is recommended +> + feature to limit connections. A firewall in this situation is recommended as well.

The above steps should be the same for any TCP network, regardless of @@ -870,7 +836,7 @@ CLASS="SECT2" >

3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.

to "blank". This can be done by editing the +>. This can be done by editing the user.action

3.14. Why would anybody want to see a checkerboard pattern?

"see"

3.15. I see some images being replaced with text instead of the checkerboard image. Why and how do I get rid of this?

The substitute page adapts to the available space and shows itself as a miniature two-liner if loaded into small frames, or full-blown with a @@ -999,7 +965,7 @@ CLASS="SECT2" CLASS="SECT2" >3.16. Can Privoxy run as a service +>3.16. Can Privoxy run as a service on Win2K/NT/XP?

User Manual for details on how to install and configure +> for details on how to install and configure Privoxysrvany.exe. See the discussion at http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118https://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118, for details, and a sample configuration.

3.17. How can I make Privoxy work with other -proxies like Squid or Tor?3.17. How can I make Privoxy work with other proxies?

This can be done and is often useful to combine the benefits of Privoxy with those of a another proxy. +> with those of a another proxy, + for example to cache content. See the User Manual which - describes how to do this, and the How do I use Privoxy together with - Tor section below.

How do I use Privoxy together with Tor.

No, its more complicated than that. This only works with special kinds +> No, its more complicated than that. This only works with special kinds of proxies known as "intercepting" proxies (see below).

proxies + (see below).

"intercepting proxy". If you are one of them, please read the next entry.

Host - header is present. + header is present.

As the Outlook Express (see above), OE uses +> (see above), OE uses IE anyway, and there is no way for Privoxy to ever +> to ever be able to distinguish between them (nor could any other proxy type application for that matter).

For a good discussion of some of the issues involved (including privacy and - security issues), see +> For a good discussion of some of the issues involved (including privacy and + security issues), see http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118https://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118.

Cookies can be - set in several ways. The classic method is via the +> can be + set in several ways. The classic method is via the Set-CookiePrivoxy concept of +> concept of session-cookies-only. - There is also the possibility of using + There is also the possibility of using 3.24. Are all cookies bad? Why?

No, in fact there are many beneficial uses of +> No, in fact there are many beneficial uses of to be there.

See the +> See the 3.25. How can I allow permanent cookies for my trusted sites?

There are several actions that relate to cookies. The default behavior is to +> There are several actions that relate to cookies. The default behavior is to allow only "session cookies", which means the cookies only last - for the current browser session. This eliminates most kinds of abuse related + for the current browser session. This eliminates most kinds of abuse related to cookies. But there may be cases where you want cookies to last.

To disable all cookie actions, so that cookies are allowed unrestricted, both in and out, for example.com:

:

Place the above in Privoxy, each with - a unique +>, each with + a unique

- Simple enough for a few users, but for large installations, consider having +> Simple enough for a few users, but for large installations, consider having groups of users that might share like configurations.

+block } / # Block *all* URLs - + ############################################################ # Whitelist ############################################################ @@ -1462,17 +1429,17 @@ TARGET="_top" >

This allows access to only those three sites by first blocking all URLs, and +> This allows access to only those three sites by first blocking all URLs, and then subsequently allowing three specific exceptions.

Another approach is Privoxy's +> trustfile concept, which incorporates the notion of +> concept, which incorporates the notion of "trusted referrers" Ad blocking is achieved through a complex application of various Privoxy +> actions. These - actions are deployed against simple images, banners, flash animations, +>. These + actions are deployed against simple images, banners, flash animations, text pages, JavaScript, pop-ups and pop-unders, etc., so its not as simple as just turning one or two actions off. The various actions that make up Privoxy is interested in this - particular feature. + particular feature.

If you want to do without this, there are several approaches you can take: @@ -1547,10 +1514,9 @@ CLASS="EMPHASIS" following very simple rule in your user.action: +>:

- Or even a more comprehensive reversing of various ad related actions:

Or even a more comprehensive reversing of various ad related actions:

This last 3.29. How can I have custom template pages, like the +>3.29. How can I have custom template pages, like the templdir option.

option.

3.30. How can I remove the "Go There Anyway" link from +> link from the Privoxy from source, and disable various features that are - available as compile-time options. You should + available as compile-time options. You should configure the sources as follows:

This will create an executable with hard-coded security features so that