X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fquickstart.html;h=4746ebc153922c13b5ec32a55d0b744c11d7243a;hp=ed0a5010ce9838440414af84435eec3e22963fd6;hb=21e4d72fa6918226a74b9f034b230172bf2a570c;hpb=56d03106907472899fa6e8933e81058744ce0fed diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index ed0a5010..4746ebc1 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -1,23 +1,28 @@ +
Privoxy User Manual | Privoxy 3.0.11 User Manual|
---|---|
Prev | Next |
- # /usr/sbin/privoxy /etc/privoxy/config - - | pattern - a checkerboard pattern, so that an ad
+ replacement is obvious. This is the default.
+
See below for other command line options.
An init script is provided for SuSE and Red Hat.
blank - A very small empty GIF image is displayed. + This is the so-called "invisible" configuration option. + |
For for SuSE: rcprivoxy start
For Red Hat and Debian: /etc/rc.d/init.d/privoxy start
http://<URL> - A redirect to any image anywhere + of the user's choosing (advanced usage). + |
If no configuration file is specified on the command line, - Privoxy will look for a file named - config in the current directory. Except on Win32 where - it will try config.txt. If no file is specified on the - command line and no default configuration file can be found, - Privoxy will fail to start.
The included default configuration files should give a reasonable starting - point. Most of the per site configuration is done in the - "actions" files. These are where various cookie actions are - defined, ad and banner blocking, and other aspects of - Advanced users will eventually want to explore Privoxy configuration. There are several such - files included, with varying levels of aggressiveness.
You will probably want to keep an eye out for sites that require persistent - cookies, and add these to default.action as needed. By - default, most of these will be accepted only during the current browser - session (aka "session cookies"), until you add them to the - configuration. If you want the browser to handle this instead, you will need - to edit default.action and disable this feature. If you - use more than one browser, it would make more sense to let - Privoxy handle this. In which case, the - browser(s) should be set to accept all cookies.
Another feature where you will probably want to define exceptions for trusted - sites is the popup-killing (through the +popup and +> +filter{popups} actions), because your favorite shopping, - banking, or leisure site may need popups.
Privoxy is HTTP/1.1 compliant, but not all of - the optional 1.1 features are as yet supported. In the unlikely event that - you experience inexplicable problems with browsers that use HTTP/1.1 per default - (like Mozilla or recent versions of I.E.), you might - try to force HTTP/1.0 compatibility. For Mozilla, look under filters as well. Filters + are very different from Edit -> - Preferences -> Debug -> Networkingblocks. - Alternatively, set the "+downgrade" config option in - default.action which will downgrade your browser's HTTP - requests from HTTP/1.1 to HTTP/1.0 before processing them.
"block" blocks a site, page, or unwanted contented. Filters + are a way of filtering or modifying what is actually on the page. An example + filter usage: a text replacement of "no-no" for + "nasty-word". That is a very simple example. This process can be + used for ad blocking, but it is more in the realm of advanced usage and has + some pitfalls to be wary off.After running The quickest way to adjust any of these settings is with your browser through + the special Privoxy for a while, you can - start to fine tune the configuration to suit your personal, or site, - preferences and requirements. There are many, many aspects that can - be customized. "Actions" (as specified in default.action) - can be adjusted by pointing your browser to - editor at http://config.privoxy.org/http://config.privoxy.org/show-status (shortcut: http://p.p/), - and then follow the link to "edit the actions list". - (This is an internal page and does not require Internet access.)
http://p.p/show-status). This + is an internal page, and does not require Internet access.In fact, various aspects of Note that as of Privoxy - configuration can be viewed from this page, including - current configuration parameters, source code version numbers, - the browser's request headers, and 3.0.7 beta the + action editor is disabled by default. Check the + enable-edit-actions + section in the configuration file to learn why and in which + cases it's safe to enable again.
If you decided to enable the action editor, select the appropriate + "actions" that apply - to a given URL. In addition to the default.action file - editor mentioned above, Privoxy can also - be turned file, and click + "on" and "Edit". It is best to put personal or + local preferences in user.action since this is not + meant to be overwritten during upgrades, and will over-ride the settings in + other files. Here you can insert new "off" (toggled) from this page.
If you encounter problems, try loading the page without +>"actions", and URLs for ad + blocking or other purposes, and make other adjustments to the configuration. Privoxy. If that helps, enter the URL where - you have the problems into the browser - based rule tracing utility. See which rules apply and why, and - then try turning them off for that site one after the other, until the problem - is gone. When you have found the culprit, you might want to turn the rest on - again.
If the above paragraph sounds gibberish to you, you might want to read more about the actions concept - or even dive deep into the Appendix - on actions.
If you can't get rid of the problem at all, think you've found a bug in - Privoxy, want to propose a new feature or smarter rules, please see the - chapter "Contacting the Developers, .." below.
Privoxy may be invoked with the following - command-line options:
A quick and simple step by step example:
--version -
Print version info and exit. Unix only. -
Right click on the ad image to be blocked, then select + "Copy Link Location" from the + pop-up menu. +--help Set your browser to + http://config.privoxy.org/show-status -
Print short usage info and exit. Unix only. -
--no-daemon -
Find user.action in the top section, and click + on "Edit": ++
--pidfile FILE You should have a section with only + block listed under + "Actions:". + If not, click a "Insert new section below" - -
On startup, write the process ID to FILE. Delete the - FILE on exit. Failure to create or delete the - FILE is non-fatal. If no FILEEdit button right under the word "Actions:". + This will bring up a list of all actions. Find + block near the top, and click + in the "Enabled" column, then "Submit" - option is given, no PID file will be used. Unix only. + just below the list.
--user USER[.GROUP] - -
After (optionally) writing the PID file, assume the user ID of - USER, and if included the GID of GROUP. Exit if the - privileges are not sufficient to do so. Unix only. +> Now, in the block actions section, + click the "Add" button, and paste the URL the + browser got from "Copy Link Location". + Remove the http:// at the beginning of the URL. Then, click + "Submit" (or + "OK" if in a pop-up window).
configfile Now go back to the original page, and press SHIFT-Reload -
If no configfile is included on the command line, - Privoxy will look for a file named - "config" in the current directory (except on Win32 - where it will look for "config.txt" instead). Specify - full path to avoid confusion. If no config file is found, - Privoxy will fail to start. + (or flush all browser caches). The image should be gone now.
This is a very crude and simple example. There might be good reasons to use a + wildcard pattern match to include potentially similar images from the same + site. For a more extensive explanation of "patterns", and + the entire actions concept, see the Actions + section.
For advanced users who want to hand edit their config files, you might want + to now go to the Actions Files Tutorial. + The ideas explained therein also apply to the web-based editor.
There are also various + filters that can be used for ad blocking + (filters are a special subset of actions). These + fall into the "advanced" usage category, and are explained in + depth in later sections.