X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fwebserver%2Fuser-manual%2Findex.html;h=62d00c5d4cb63ee356f843cf4ba7dbe19a5b0e33;hb=42c361793c45b0d5fc0c116707ca12b2f60f4c52;hp=a54b6e2dfd40897f4d895ae63dc2f16a24ecab0f;hpb=19b550bdce33da481e983408956839b85693cee5;p=privoxy.git diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html index a54b6e2d..62d00c5d 100644 --- a/doc/webserver/user-manual/index.html +++ b/doc/webserver/user-manual/index.html @@ -1,641 +1,803 @@ - - + - - Privoxy 3.0.25 User Manual - - - - - - - - -
-
-

Privoxy 3.0.25 User - Manual

- -

Copyright © - 2001-2016 by Privoxy - Developers

- -

$Id: user-manual.sgml,v 2.213 2016/05/27 15:24:13 - fabiankeil Exp $

- -
-
- - -

The Privoxy User Manual gives users - information on how to install, configure and use Privoxy.

- -

Privoxy is a non-caching web proxy with advanced filtering - capabilities for enhancing privacy, modifying web page data and - HTTP headers, controlling access, and removing ads and other - obnoxious Internet junk. Privoxy has a flexible configuration and - can be customized to suit individual needs and tastes. It has - application for both stand-alone systems and multi-user - networks.

- -

Privoxy is Free Software and licensed under the GNU GPLv2.

- -

Privoxy is an associated project of Software in the Public - Interest (SPI).

- -

Helping hands and donations are welcome:

- - - -

You can find the latest version of the Privoxy User Manual at https://www.privoxy.org/user-manual/. Please see the - Contact section on how to contact the - developers.

+ + + Privoxy 3.0.26 User Manual + + + + + + + + +
+
+

+ Privoxy 3.0.26 User Manual +

+

+ Copyright © 2001-2016 by Privoxy + Developers
+

+

+ $Id: user-manual.sgml,v 2.214 2016/07/26 10:46:19 fabiankeil Exp + $
+

+
+
+ +

+ The Privoxy User Manual gives users + information on how to install, configure and use Privoxy. +

+

+ Privoxy is a non-caching web proxy with advanced filtering + capabilities for enhancing privacy, modifying web page data and + HTTP headers, controlling access, and removing ads and other + obnoxious Internet junk. Privoxy has a flexible configuration + and can be customized to suit individual needs and tastes. It + has application for both stand-alone systems and multi-user + networks. +

+

+ Privoxy is Free Software and licensed under the GNU GPLv2. +

+

+ Privoxy is an associated project of Software in the Public + Interest (SPI). +

+

+ Helping hands and donations are welcome: +

+ + +

+ You can find the latest version of the Privoxy User Manual at https://www.privoxy.org/user-manual/. Please see the + Contact section on how to contact + the developers. +

+
+
+
+
+
+
+ Table of Contents +
+
+ 1. Introduction +
+
+
+
+ 1.1. Features +
+
+
+
+ 2. Installation +
+
+
+
+ 2.1. Binary + Packages +
+
+
+
+ 2.1.1. Debian and + Ubuntu +
+
+ 2.1.2. Windows +
+
+ 2.1.3. OS/2 +
+
+ 2.1.4. Mac + OS X +
+
+ 2.1.5. Installation + from ready-built package +
+
+ 2.1.6. Installation + from source +
+
+ 2.1.7. FreeBSD +
+
+
+
+ 2.2. Building + from Source +
+
+ 2.3. Keeping your + Installation Up-to-Date +
+
+
+
+ 3. What's New in this Release +
+
+
+
+ 3.1. Note to + Upgraders +
+
+
+
+ 4. Quickstart to Using Privoxy +
+
+
+
+ 4.1. Quickstart to Ad + Blocking +
+
+
+
+ 5. Starting Privoxy +
+
+
+
+ 5.1. Debian +
+
+ 5.2. FreeBSD and + ElectroBSD +
+
+ 5.3. Windows +
+
+ 5.4. Generic instructions + for Unix derivates (Solaris, NetBSD, HP-UX etc.) +
+
+ 5.5. OS/2 +
+
+ 5.6. Mac OS X +
+
+ 5.7. Command Line + Options +
+
+
+
+ 6. Privoxy Configuration +
+
+
+
+ 6.1. Controlling + Privoxy with Your Web Browser +
+
+ 6.2. Configuration + Files Overview +
+
+
+
+ 7. The Main Configuration File +
+
+
+
+ 7.1. Local Set-up + Documentation +
+
+
+
+ 7.1.1. user-manual +
+
+ 7.1.2. trust-info-url +
+
+ 7.1.3. admin-address +
+
+ 7.1.4. proxy-info-url +
+
+
+
+ 7.2. Configuration and Log + File Locations +
+
+
+
+ 7.2.1. confdir +
+
+ 7.2.2. templdir +
+
+ 7.2.3. temporary-directory +
+
+ 7.2.4. logdir +
+
+ 7.2.5. actionsfile +
+
+ 7.2.6. filterfile +
+
+ 7.2.7. logfile +
+
+ 7.2.8. trustfile +
+
+
+
+ 7.3. Debugging +
+
+
+
+ 7.3.1. debug +
+
+ 7.3.2. single-threaded +
+
+ 7.3.3. hostname +
+
+
+
+ 7.4. Access Control and + Security +
+
+
+
+ 7.4.1. listen-address +
+
+ 7.4.2. toggle +
+
+ 7.4.3. enable-remote-toggle +
+
+ 7.4.4. enable-remote-http-toggle +
+
+ 7.4.5. enable-edit-actions +
+
+ 7.4.6. enforce-blocks +
+
+ 7.4.7. ACLs: permit-access and + deny-access +
+
+ 7.4.8. buffer-limit +
+
+ 7.4.9. enable-proxy-authentication-forwarding +
+
+
+
+ 7.5. Forwarding +
+
+
+
+ 7.5.1. forward +
+
+ 7.5.2. forward-socks4, + forward-socks4a, forward-socks5 and forward-socks5t +
+
+ 7.5.3. Advanced + Forwarding Examples +
+
+ 7.5.4. forwarded-connect-retries +
+
+
+
+ 7.6. Miscellaneous +
+
+
+
+ 7.6.1. accept-intercepted-requests +
+
+ 7.6.2. allow-cgi-request-crunching +
+
+ 7.6.3. split-large-forms +
+
+ 7.6.4. keep-alive-timeout +
+
+ 7.6.5. tolerate-pipelining +
+
+ 7.6.6. default-server-timeout +
+
+ 7.6.7. connection-sharing +
+
+ 7.6.8. socket-timeout +
+
+ 7.6.9. max-client-connections +
+
+ 7.6.10. handle-as-empty-doc-returns-ok +
+
+ 7.6.11. enable-compression +
+
+ 7.6.12. compression-level +
+
+ 7.6.13. client-header-order +
+
+ 7.6.14. client-specific-tag +
+
+ 7.6.15. client-tag-lifetime +
+
+ 7.6.16. trust-x-forwarded-for +
+
+
+
+ 7.7. Windows GUI + Options +
+
+
+
+ 8. Actions Files +
+
+
+
+ 8.1. Finding the Right + Mix +
+
+ 8.2. How to Edit +
+
+ 8.3. How Actions + are Applied to Requests +
+
+ 8.4. Patterns +
+
+
+
+ 8.4.1. The Host + Pattern +
+
+ 8.4.2. The Path + Pattern +
+
+ 8.4.3. The + Request Tag Pattern +
+
+ 8.4.4. The Negative + Request Tag Patterns +
+
+ 8.4.5. The + Client Tag Pattern +
+
+
+
+ 8.5. Actions +
+
+
+
+ 8.5.1. add-header +
+
+ 8.5.2. block +
+
+ 8.5.3. change-x-forwarded-for +
+
+ 8.5.4. client-header-filter +
+
+ 8.5.5. client-header-tagger +
+
+ 8.5.6. content-type-overwrite +
+
+ 8.5.7. crunch-client-header +
+
+ 8.5.8. crunch-if-none-match +
+
+ 8.5.9. crunch-incoming-cookies +
+
+ 8.5.10. crunch-server-header +
+
+ 8.5.11. crunch-outgoing-cookies +
+
+ 8.5.12. deanimate-gifs +
+
+ 8.5.13. downgrade-http-version +
+
+ 8.5.14. external-filter +
+
+ 8.5.15. fast-redirects +
+
+ 8.5.16. filter +
+
+ 8.5.17. force-text-mode +
+
+ 8.5.18. forward-override +
+
+ 8.5.19. handle-as-empty-document +
+
+ 8.5.20. handle-as-image +
+
+ 8.5.21. hide-accept-language +
+
+ 8.5.22. hide-content-disposition +
+
+ 8.5.23. hide-if-modified-since +
+
+ 8.5.24. hide-from-header +
+
+ 8.5.25. hide-referrer +
+
+ 8.5.26. hide-user-agent +
+
+ 8.5.27. limit-connect +
+
+ 8.5.28. limit-cookie-lifetime +
+
+ 8.5.29. prevent-compression +
+
+ 8.5.30. overwrite-last-modified +
+
+ 8.5.31. redirect +
+
+ 8.5.32. server-header-filter +
+
+ 8.5.33. server-header-tagger +
+
+ 8.5.34. session-cookies-only +
+
+ 8.5.35. set-image-blocker +
+
+ 8.5.36. Summary +
+
+
+
+ 8.6. Aliases +
+
+ 8.7. Actions Files + Tutorial +
+
+
+
+ 8.7.1. match-all.action +
+
+ 8.7.2. default.action +
+
+ 8.7.3. user.action +
+
+
+
+
+
+ 9. Filter Files +
+
+
+
+ 9.1. Filter File + Tutorial +
+
+ 9.2. The + Pre-defined Filters +
+
+ 9.3. External filter + syntax +
+
+
+
+ 10. Privoxy's Template Files +
+
+ 11. Contacting the Developers, Bug + Reporting and Feature Requests +
+
+
+
+ 11.1. Please + provide sufficient information +
+
+ 11.2. Get Support +
+
+ 11.3. Reporting Problems +
+
+
+
+ 11.3.1. Reporting Ads + or Other Configuration Problems +
+
+ 11.3.2. Reporting + Bugs +
+
+
+
+ 11.4. Reporting + security problems +
+
+ 11.5. Mailing Lists +
+
+ 11.6. SourceForge support + trackers +
+
+
+
+ 12. Privoxy Copyright, License and + History +
+
+
+
+ 12.1. License +
+
+ 12.2. History +
+
+ 12.3. Authors +
+
+
+
+ 13. See Also +
+
+ 14. Appendix +
+
+
+
+ 14.1. Regular Expressions +
+
+ 14.2. Privoxy's + Internal Pages +
+
+ 14.3. Chain of Events +
+
+ 14.4. Troubleshooting: + Anatomy of an Action +
+
+
+
-
- -
-
-
Table of Contents
- -
1. Introduction
- -
-
-
1.1. Features
-
-
- -
2. Installation
- -
-
-
2.1. Binary - Packages
- -
-
-
2.1.1. Debian and - Ubuntu
- -
2.1.2. Windows
- -
2.1.3. OS/2
- -
2.1.4. Mac - OS X
- -
2.1.5. Installation - from ready-built package
- -
2.1.6. Installation - from source
- -
2.1.7. FreeBSD
-
-
- -
2.2. Building - from Source
- -
2.3. Keeping your - Installation Up-to-Date
-
-
- -
3. What's New in this Release
- -
-
-
3.1. Note to - Upgraders
-
-
- -
4. Quickstart to Using Privoxy
- -
-
-
4.1. Quickstart to Ad - Blocking
-
-
- -
5. Starting Privoxy
- -
-
-
5.1. Debian
- -
5.2. FreeBSD and - ElectroBSD
- -
5.3. Windows
- -
5.4. Generic instructions - for Unix derivates (Solaris, NetBSD, HP-UX etc.)
- -
5.5. OS/2
- -
5.6. Mac OS X
- -
5.7. Command Line - Options
-
-
- -
6. Privoxy Configuration
- -
-
-
6.1. Controlling Privoxy - with Your Web Browser
- -
6.2. Configuration - Files Overview
-
-
- -
7. The Main Configuration File
- -
-
-
7.1. Local Set-up - Documentation
- -
-
-
7.1.1. user-manual
- -
7.1.2. trust-info-url
- -
7.1.3. admin-address
- -
7.1.4. proxy-info-url
-
-
- -
7.2. Configuration and Log - File Locations
- -
-
-
7.2.1. confdir
- -
7.2.2. templdir
- -
7.2.3. temporary-directory
- -
7.2.4. logdir
- -
7.2.5. actionsfile
- -
7.2.6. filterfile
- -
7.2.7. logfile
- -
7.2.8. trustfile
-
-
- -
7.3. Debugging
- -
-
-
7.3.1. debug
- -
7.3.2. single-threaded
- -
7.3.3. hostname
-
-
- -
7.4. Access Control and - Security
- -
-
-
7.4.1. listen-address
- -
7.4.2. toggle
- -
7.4.3. enable-remote-toggle
- -
7.4.4. enable-remote-http-toggle
- -
7.4.5. enable-edit-actions
- -
7.4.6. enforce-blocks
- -
7.4.7. ACLs: permit-access and - deny-access
- -
7.4.8. buffer-limit
- -
7.4.9. enable-proxy-authentication-forwarding
-
-
- -
7.5. Forwarding
- -
-
-
7.5.1. forward
- -
7.5.2. forward-socks4, - forward-socks4a, forward-socks5 and forward-socks5t
- -
7.5.3. Advanced - Forwarding Examples
- -
7.5.4. forwarded-connect-retries
-
-
- -
7.6. Miscellaneous
- -
-
-
7.6.1. accept-intercepted-requests
- -
7.6.2. allow-cgi-request-crunching
- -
7.6.3. split-large-forms
- -
7.6.4. keep-alive-timeout
- -
7.6.5. tolerate-pipelining
- -
7.6.6. default-server-timeout
- -
7.6.7. connection-sharing
- -
7.6.8. socket-timeout
- -
7.6.9. max-client-connections
- -
7.6.10. handle-as-empty-doc-returns-ok
- -
7.6.11. enable-compression
- -
7.6.12. compression-level
- -
7.6.13. client-header-order
- -
7.6.14. client-specific-tag
- -
7.6.15. client-tag-lifetime
- -
7.6.16. trust-x-forwarded-for
-
-
- -
7.7. Windows GUI - Options
-
-
- -
8. Actions Files
- -
-
-
8.1. Finding the Right - Mix
- -
8.2. How to - Edit
- -
8.3. How Actions - are Applied to Requests
- -
8.4. Patterns
- -
-
-
8.4.1. The Host - Pattern
- -
8.4.2. The Path - Pattern
- -
8.4.3. The - Request Tag Pattern
- -
8.4.4. The Negative - Request Tag Patterns
- -
8.4.5. The - Client Tag Pattern
-
-
- -
8.5. Actions
- -
-
-
8.5.1. add-header
- -
8.5.2. block
- -
8.5.3. change-x-forwarded-for
- -
8.5.4. client-header-filter
- -
8.5.5. client-header-tagger
- -
8.5.6. content-type-overwrite
- -
8.5.7. crunch-client-header
- -
8.5.8. crunch-if-none-match
- -
8.5.9. crunch-incoming-cookies
- -
8.5.10. crunch-server-header
- -
8.5.11. crunch-outgoing-cookies
- -
8.5.12. deanimate-gifs
- -
8.5.13. downgrade-http-version
- -
8.5.14. external-filter
- -
8.5.15. fast-redirects
- -
8.5.16. filter
- -
8.5.17. force-text-mode
- -
8.5.18. forward-override
- -
8.5.19. handle-as-empty-document
- -
8.5.20. handle-as-image
- -
8.5.21. hide-accept-language
- -
8.5.22. hide-content-disposition
- -
8.5.23. hide-if-modified-since
- -
8.5.24. hide-from-header
- -
8.5.25. hide-referrer
- -
8.5.26. hide-user-agent
- -
8.5.27. limit-connect
- -
8.5.28. limit-cookie-lifetime
- -
8.5.29. prevent-compression
- -
8.5.30. overwrite-last-modified
- -
8.5.31. redirect
- -
8.5.32. server-header-filter
- -
8.5.33. server-header-tagger
- -
8.5.34. session-cookies-only
- -
8.5.35. set-image-blocker
- -
8.5.36. Summary
-
-
- -
8.6. Aliases
- -
8.7. Actions Files - Tutorial
- -
-
-
8.7.1. match-all.action
- -
8.7.2. default.action
- -
8.7.3. user.action
-
-
-
-
- -
9. Filter Files
- -
-
-
9.1. Filter File - Tutorial
- -
9.2. The - Pre-defined Filters
- -
9.3. External filter - syntax
-
-
- -
10. Privoxy's Template Files
- -
11. Contacting the Developers, Bug - Reporting and Feature Requests
- -
-
-
11.1. Please - provide sufficient information
- -
11.2. Get - Support
- -
11.3. Reporting - Problems
- -
-
-
11.3.1. Reporting Ads - or Other Configuration Problems
- -
11.3.2. Reporting - Bugs
-
-
- -
11.4. Reporting - security problems
- -
11.5. Mailing - Lists
- -
11.6. SourceForge support - trackers
-
-
- -
12. Privoxy Copyright, License and - History
- -
-
-
12.1. License
- -
12.2. History
- -
12.3. Authors
-
-
- -
13. See Also
- -
14. Appendix
- -
-
-
14.1. Regular - Expressions
- -
14.2. Privoxy's - Internal Pages
- -
14.3. Chain of Events
- -
14.4. Troubleshooting: - Anatomy of an Action
-
-
-
+
+
+ + + + + + + + + + + +
+   + +   + + Next +
+   + +   + + Introduction +
-
- -
-
- - - - - - - - - - - - - - - - - -
  Next
  Introduction
-
- + +