Andreas Rutkauskas
Bart Schelstraete
Gregory Seidman
+ Atman Sense
Chung-chieh Shan
Benjamin C. Wiley Sittler
Simon South
If we've missed you off this list, please let us know!
- Privoxy team. http://www.privoxy.org/
- <ijbswa-developers@lists.sourceforge.net>
+ Privoxy team. https://www.privoxy.org/
+ <privoxy-devel@lists.privoxy.org>
/*********************************************************************
*
- * File : $Source: /cvsroot/ijbswa/current/INSTALL,v $
+ * File : $Source: /cvsroot/ijbswa/current/doc/source/install.sgml,v $
*
* Purpose : INSTALL file to help with installing from source.
*
* Copyright : Written by and Copyright (C) 2001-2009 the
- * Privoxy team. http://www.privoxy.org/
+ * Privoxy team. https://www.privoxy.org/
*
* Based on the Internet Junkbuster originally written
* by and Copyright (C) 1997 Anonymous Coders and
/*********************************************************************
*
- * File : $Source: /cvsroot/ijbswa/current/README,v $
+ * File : $Source: /cvsroot/ijbswa/current/doc/source/readme.sgml,v $
*
* Purpose : README file to give a short intro.
*
* Copyright : Written by and Copyright (C) 2001-2011 the
- * Privoxy team. http://www.privoxy.org/
+ * Privoxy team. https://www.privoxy.org/
*
* Based on the Internet Junkbuster originally written
* by and Copyright (C) 1997 Anonymous Coders and
*********************************************************************/
This README is included with the development version of Privoxy 3.0.25. See
-http://www.privoxy.org/ for more information. The current code maturity level
+https://www.privoxy.org/ for more information. The current code maturity level
is "UNRELEASED", but seems stable to us :).
-------------------------------------------------------------------------------
Helping hands and donations are welcome:
- * http://www.privoxy.org/faq/general.html#PARTICIPATE
+ * https://www.privoxy.org/faq/general.html#PARTICIPATE
- * http://www.privoxy.org/faq/general.html#DONATE
+ * https://www.privoxy.org/faq/general.html#DONATE
-------------------------------------------------------------------------------
customizations. On Unix-like systems, these files are typically installed in /
etc/privoxy. On Windows, then wherever the executable itself is installed.
There are many significant changes and advances from earlier versions. The User
-Manual has an explanation of all configuration options, and examples: http://
+Manual has an explanation of all configuration options, and examples: https://
www.privoxy.org/user-manual/.
Be sure to set your browser(s) for HTTP/HTTPS Proxy at <IP>:<Port>, or whatever
the top-level source directory.
Included documentation may vary according to platform and packager. All
-documentation is posted on http://www.privoxy.org, in case you don't have it,
+documentation is posted on https://www.privoxy.org, in case you don't have it,
or can't find it.
-------------------------------------------------------------------------------
Please send feedback on ads that slipped through, innocent images that were
blocked, sites that don't work properly, and other configuration related
-problem of default.action file, to http://sourceforge.net/tracker/?group_id=
+problem of default.action file, to https://sourceforge.net/tracker/?group_id=
11118&atid=460288, the Actions File Tracker.
-------------------------------------------------------------------------------
completely diagnosed yet, please use the Privoxy users list. Technically
interested users and people who wish to contribute to the project are always
welcome on the developers list. You can find an overview of all Privoxy-related
-mailing lists, including list archives, at: http://sourceforge.net/mail/?
-group_id=11118.
+mailing lists, including list archives, at: https://lists.privoxy.org/mailman/
+listinfo. The lists hosted on privoxy.org have been created in 2016, the
+previously-used lists hosted at SourceForge are deprecated but the archives may
+still be useful: https://sourceforge.net/mail/?group_id=11118.
-------------------------------------------------------------------------------
to Privoxy Development</a></h2>
<p>The first step is to join the <a href=
- "mailto:ijbswa-developers@lists.sourceforge.net" target=
- "_top">developer's mailing list</a>. You can submit your ideas, or even
- better patches. Patches are best submitted to the Sourceforge tracker
- set up for this purpose, but can be sent to the list for review
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-devel" target=
+ "_top">privoxy-devel mailing list</a>. You can submit your ideas, or
+ even better patches. Patches are best submitted to the Sourceforge
+ tracker set up for this purpose, but can be sent to the list for review
too.</p>
<p>You will also need to have a cvs package installed, which will
<p>When all (or: most of the) packages have been uploaded and made
available, send an email to the <a href=
- "mailto:ijbswa-announce@lists.sourceforge.net" target="_top">announce
+ "mailto:privoxy-announce@lists.privoxy.org" target="_top">announce
mailing list</a>, Subject: "Version X.Y.Z available for download". Be
sure to include the <a href=
"https://sourceforge.net/project/showfiles.php?group_id=11118" target=
<p>If you wish to receive an email notification whenever we release
updates of <span class="APPLICATION">Privoxy</span> or the actions
file, <a href=
- "https://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" target=
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-announce" target=
"_top">subscribe to our announce mailing list</a>,
- ijbswa-announce@lists.sourceforge.net.</p>
+ privoxy-announce@lists.privoxy.org.</p>
</div>
<div class="SECT2">
Get Support</a></h2>
<p>All users are welcome to discuss their issues on the <a href=
- "https://lists.sourceforge.net/lists/listinfo/ijbswa-users" target=
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
"_top">users mailing list</a>, where the developers also hang
around.</p>
contribute to the project are always welcome on the developers list.
You can find an overview of all <span class=
"APPLICATION">Privoxy</span>-related mailing lists, including list
- archives, at: <a href="https://sourceforge.net/mail/?group_id=11118"
+ archives, at: <a href="https://lists.privoxy.org/mailman/listinfo"
+ target="_top">https://lists.privoxy.org/mailman/listinfo</a>. The lists
+ hosted on privoxy.org have been created in 2016, the previously-used
+ lists hosted at SourceForge are deprecated but the archives may still
+ be useful: <a href="https://sourceforge.net/mail/?group_id=11118"
target="_top">https://sourceforge.net/mail/?group_id=11118</a>.</p>
</div>
<p>Copyright © 2001-2016 by Privoxy Developers <code class=
"EMAIL"><<a href=
- "mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p>
+ "mailto:privoxy-devel@lists.privoxy.org">privoxy-devel@lists.privoxy.org</a>></code></p>
<p>Some source code is based on code Copyright © 1997 by Anonymous
Coders and Junkbusters, Inc. and licensed under the <i class=
"APPLICATION">Privoxy</span>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1484" id="AEN1484">7.1. License</a></h2>
+ <h2 class="SECT2"><a name="AEN1480" id="AEN1480">7.1. License</a></h2>
<p><span class="APPLICATION">Privoxy</span> is free software; you can
redistribute it and/or modify it under the terms of the <i class=
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1493" id="AEN1493">7.2. History</a></h2>
+ <h2 class="SECT2"><a name="AEN1489" id="AEN1489">7.2. History</a></h2>
<p>A long time ago, there was the <span class="APPLICATION">Internet
Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation.
lists.</p>
<p>So first thing, subscribe to the <a href=
- "https://lists.sourceforge.net/lists/listinfo/ijbswa-users" target=
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
"_top">Privoxy Users</a> or the <a href=
- "https://lists.sourceforge.net/lists/listinfo/ijbswa-developers"
- target="_top">Privoxy Developers</a> mailing list, join the
- discussion, help out other users, provide general feedback or report
- problems you noticed.</p>
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-devel" target=
+ "_top">Privoxy Developers</a> mailing list, join the discussion, help
+ out other users, provide general feedback or report problems you
+ noticed.</p>
<p>If you intend to help out with the trackers, you also might want
to <a href="https://sourceforge.net/user/registration" target=
upgraded to Mac OS X 10.9 (Mavericks) and now <span class=
"APPLICATION">Privoxy</span> has stopped working.</a></dt>
- <dt>5.11. <a href="trouble.html#BLANKPAGE">I get a completely
- blank page at one site. <span class="QUOTE">"View Source"</span>
- shows only: <span class=
- "MARKUP"><html><body></body></html></span>.
- Without Privoxy the page loads fine.</a></dt>
-
- <dt>5.12. <a href="trouble.html#NOHOSTNAME">My logs show many
+ <dt>5.11. <a href="trouble.html#NOHOSTNAME">My logs show many
<span class="QUOTE">"Unable to get my own hostname"</span> lines.
Why?</a></dt>
- <dt>5.1
3. <a href="trouble.html#INUSE">When I try to launch
+ <dt>5.1
2. <a href="trouble.html#INUSE">When I try to launch
Privoxy, I get an error message <span class="QUOTE">"port 8118 is
already in use"</span> (or similar wording). Why?</a></dt>
- <dt>5.1
4. <a href="trouble.html#DEMORONIZER">Pages with UTF-8
+ <dt>5.1
3. <a href="trouble.html#DEMORONIZER">Pages with UTF-8
fonts are garbled.</a></dt>
- <dt>5.1
5. <a href="trouble.html#DEMORONIZER2">Why are binary
+ <dt>5.1
4. <a href="trouble.html#DEMORONIZER2">Why are binary
files (such as images) corrupted when Privoxy is used?</a></dt>
- <dt>5.1
6. <a href="trouble.html#DEMORONIZER3">What is the
+ <dt>5.1
5. <a href="trouble.html#DEMORONIZER3">What is the
<span class="QUOTE">"demoronizer"</span> and why is it
there?</a></dt>
- <dt>5.1
7. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing
+ <dt>5.1
6. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing
<span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw source
code?</a></dt>
- <dt>5.1
8. <a href="trouble.html#DNSERRORS">I am getting too many
+ <dt>5.1
7. <a href="trouble.html#DNSERRORS">I am getting too many
DNS errors like <span class="QUOTE">"404 No Such Domain"</span>.
Why can't Privoxy do this better?</a></dt>
- <dt>5.1
9. <a href="trouble.html#ALLCPU">At one site Privoxy just
+ <dt>5.1
8. <a href="trouble.html#ALLCPU">At one site Privoxy just
hangs, and starts taking all CPU. Why is this?</a></dt>
- <dt>5.
20. <a href="trouble.html#SLOWCRAWL">I just installed
+ <dt>5.
19. <a href="trouble.html#SLOWCRAWL">I just installed
Privoxy, and all my browsing has slowed to a crawl. What
gives?</a></dt>
- <dt>5.2
1. <a href="trouble.html#PREVENTCOMP">Why do my filters
+ <dt>5.2
0. <a href="trouble.html#PREVENTCOMP">Why do my filters
work on some sites but not on others?</a></dt>
- <dt>5.2
2. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites
+ <dt>5.2
1. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites
my browser warns me about unauthenticated content, the URL bar
doesn't get highlighted and the lock symbol appears to be broken.
What's going on?</a></dt>
- <dt>5.2
3. <a href="trouble.html#SE-LINUX">I get selinux error
+ <dt>5.2
2. <a href="trouble.html#SE-LINUX">I get selinux error
messages. How can I fix this?</a></dt>
- <dt>5.2
4. <a href="trouble.html#GENTOO-RICERS">I compiled
+ <dt>5.2
3. <a href="trouble.html#GENTOO-RICERS">I compiled
<span class="APPLICATION">Privoxy</span> with Gentoo's portage
and it appears to be very slow. Why?</a></dt>
- <dt>5.2
5. <a href="trouble.html#TAINTED-SOCKETS">What are tainted
+ <dt>5.2
4. <a href="trouble.html#TAINTED-SOCKETS">What are tainted
sockets and how do I prevent them?</a></dt>
+
+ <dt>5.25. <a href="trouble.html#PCRE-STACK-LIMIT">After adding my
+ custom filters, <span class="APPLICATION">Privoxy</span> crashes
+ when visitting certain websites</a></dt>
</dl>
</dd>
<dd>
<dl>
- <dt>7.1. <a href="copyright.html#AEN1484">License</a></dt>
+ <dt>7.1. <a href="copyright.html#AEN1480">License</a></dt>
- <dt>7.2. <a href="copyright.html#AEN1493">History</a></dt>
+ <dt>7.2. <a href="copyright.html#AEN1489">History</a></dt>
</dl>
</dd>
</dl>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.11. I get a
- completely blank page at one site. <span class="QUOTE">"View
- Source"</span> shows only: <span class=
- "MARKUP"><html><body></body></html></span>.
- Without Privoxy the page loads fine.</a></h3>
-
- <p>Chances are that the site suffers from a bug in <a href=
- "http://www.php.net/" target="_top"><span class=
- "APPLICATION">PHP</span></a>, which results in empty pages being sent
- if the client explicitly requests an uncompressed page, like
- <span class="APPLICATION">Privoxy</span> does. This bug has been fixed
- in PHP 4.2.3.</p>
-
- <p>To find out if this is in fact the source of the problem, try adding
- the site to a <tt class="LITERAL">-prevent-compression</tt> section in
- <tt class="FILENAME">user.action</tt>:</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- # Make exceptions for ill-behaved sites:
- #
- {-prevent-compression}
- .example.com
-</pre>
- </td>
- </tr>
- </table>
-
- <p>If that works, you may also want to report the problem to the site's
- webmasters, telling them to use zlib.output_compression instead of
- ob_gzhandler in their PHP applications (workaround) or upgrade to PHP
- 4.2.3 or later (fix).</p>
- </div>
-
- <div class="SECT2">
- <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.12. My logs
+ <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs
show many <span class="QUOTE">"Unable to get my own hostname"</span>
lines. Why?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="INUSE" id="INUSE">5.13. When I try to launch
+ <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch
Privoxy, I get an error message <span class="QUOTE">"port 8118 is
already in use"</span> (or similar wording). Why?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.14. Pages
+ <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages
with UTF-8 fonts are garbled.</a></h3>
<p>This may be the result of an overly aggressive filter. The filters
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.15. Why
+ <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why
are binary files (such as images) corrupted when Privoxy is
used?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.16. What
+ <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What
is the <span class="QUOTE">"demoronizer"</span> and why is it
there?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.17. Why do I
+ <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I
keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw
source code?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.18. I am getting
+ <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting
too many DNS errors like <span class="QUOTE">"404 No Such
Domain"</span>. Why can't Privoxy do this better?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.19. At one site
+ <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site
Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3>
<p>This is probably a manifestation of the <span class="QUOTE">"100%
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.20. I just
+ <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just
installed Privoxy, and all my browsing has slowed to a crawl. What
gives?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.21. Why do
+ <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do
my filters work on some sites but not on others?</a></h3>
<p>It's probably due to compression. It is a common practice for web
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.22. On
+ <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On
some HTTPS sites my browser warns me about unauthenticated content, the
URL bar doesn't get highlighted and the lock symbol appears to be
broken. What's going on?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.23. I get selinux
+ <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux
error messages. How can I fix this?</a></h3>
<p>Please report the problem to the creator of your selinux
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.24. I
+ <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I
compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage
and it appears to be very slow. Why?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="TAINTED-SOCKETS" id="TAINTED-SOCKETS">5.25.
+ <h3 class="SECT2"><a name="TAINTED-SOCKETS" id="TAINTED-SOCKETS">5.24.
What are tainted sockets and how do I prevent them?</a></h3>
<p><span class="APPLICATION">Privoxy</span> marks sockets as tainted
problem that may be worth fixing, the problem will be explicitly logged
as error.</p>
</div>
+
+ <div class="SECT2">
+ <h3 class="SECT2"><a name="PCRE-STACK-LIMIT" id=
+ "PCRE-STACK-LIMIT">5.25. After adding my custom filters, <span class=
+ "APPLICATION">Privoxy</span> crashes when visitting certain
+ websites</a></h3>
+
+ <p>This can happen if your custom filters require more memory than
+ <span class="APPLICATION">Privoxy</span> is allowed to use. Usually the
+ problem is that the operating system enforces a stack size limit that
+ isn't sufficient.</p>
+
+ <p>Unless the problem occurs with the filters available in the default
+ configuration, this is not considered a Privoxy bug.</p>
+
+ <p>To prevent the crashes you can rewrite your filter to use less
+ ressources, increase the relevant memory limit or recompile pcre to use
+ less stack space. For details please see the <a href=
+ "http://pcre.org/original/doc/html/pcrestack.html" target=
+ "_top">pcrestack man page</a> and the documentation of your operating
+ system.</p>
+ </div>
</div>
<div class="NAVFOOTER">
in <tt class="FILENAME">default.action</tt> are:</p>
<div class="TABLE">
- <a name="AEN2682" id="AEN2682"></a>
+ <a name="AEN2712" id="AEN2712"></a>
<p><b>Table 1. Default Configurations</b></p>
<ul>
<li>
- <p>Privoxy main page:</p><a name="AEN5854" id="AEN5854"></a>
+ <p>Privoxy main page:</p><a name="AEN5885" id="AEN5885"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/" target=
<li>
<p>Show information about the current configuration, including
- viewing and editing of actions files:</p><a name="AEN5862" id=
- "AEN5862"></a>
+ viewing and editing of actions files:</p><a name="AEN5893" id=
+ "AEN5893"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-status" target=
</li>
<li>
- <p>Show the source code version numbers:</p><a name="AEN5867" id=
- "AEN5867"></a>
+ <p>Show the source code version numbers:</p><a name="AEN5898" id=
+ "AEN5898"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-version" target=
</li>
<li>
- <p>Show the browser's request headers:</p><a name="AEN5872" id=
- "AEN5872"></a>
+ <p>Show the browser's request headers:</p><a name="AEN5903" id=
+ "AEN5903"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-request" target=
</li>
<li>
- <p>Show which actions apply to a URL and why:</p><a name="AEN5877"
- id="AEN5877"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN5908"
+ id="AEN5908"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-url-info" target=
<span class="QUOTE">"off"</span>, <span class=
"QUOTE">"Privoxy"</span> continues to run, but only as a
pass-through proxy, with no actions taking place:</p><a name=
- "AEN5885" id="AEN5885"></a>
+ "AEN5916" id="AEN5916"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle" target=
"_top">http://config.privoxy.org/toggle</a></p>
</blockquote>
- <p>Short cuts. Turn off, then on:</p><a name="AEN5889" id=
- "AEN5889"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN5920" id=
+ "AEN5920"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=disable" target=
"_top">http://config.privoxy.org/toggle?set=disable</a></p>
- </blockquote><a name="AEN5892" id="AEN5892"></a>
+ </blockquote><a name="AEN5923" id="AEN5923"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=enable" target=
# Increase the time to life for temporarily enabled tags to 3 minutes
client-tag-lifetime 180
+</pre>
+ </td>
+ </tr>
+ </table>
+ </dd>
+ </dl>
+ </div>
+ </div>
+
+ <div class="SECT3">
+ <h4 class="SECT3"><a name="TRUST-X-FORWARDED-FOR" id=
+ "TRUST-X-FORWARDED-FOR">7.6.16. trust-x-forwarded-for</a></h4>
+
+ <div class="VARIABLELIST">
+ <dl>
+ <dt>Specifies:</dt>
+
+ <dd>
+ <p>Whether or not Privoxy should use IP addresses specified
+ with the X-Forwarded-For header</p>
+ </dd>
+
+ <dt>Type of value:</dt>
+
+ <dd>
+ <p><tt class="REPLACEABLE"><i>0 or one</i></tt></p>
+ </dd>
+
+ <dt>Default value:</dt>
+
+ <dd>
+ <p>0</p>
+ </dd>
+
+ <dt>Notes:</dt>
+
+ <dd>
+ <div class="WARNING">
+ <table class="WARNING" border="1" width="90%">
+ <tr>
+ <td align="center"><b>Warning</b></td>
+ </tr>
+
+ <tr>
+ <td align="left">
+ <p>This is an experimental feature. The syntax is
+ likely to change in future versions.</p>
+ </td>
+ </tr>
+ </table>
+ </div>
+
+ <p>If clients reach Privoxy through another proxy, for example
+ a load balancer, Privoxy can't tell the client's IP address
+ from the connection. If multiple clients use the same proxy,
+ they will share the same client tag settings which is usually
+ not desired.</p>
+
+ <p>This option lets Privoxy use the X-Forwarded-For header
+ value as client IP address. If the proxy sets the header,
+ multiple clients using the same proxy do not share the same
+ client tag settings.</p>
+
+ <p>This option should only be enabled if Privoxy can only be
+ reached through a proxy and if the proxy can be trusted to set
+ the header correctly. It is recommended that ACL are used to
+ make sure only trusted systems can reach Privoxy.</p>
+
+ <p>If access to Privoxy isn't limited to trusted systems, this
+ option would allow malicious clients to change the client tags
+ for other clients or increase Privoxy's memory requirements by
+ registering lots of client tag settings for clients that don't
+ exist.</p>
+ </dd>
+
+ <dt>Examples:</dt>
+
+ <dd>
+ <table border="0" bgcolor="#E0E0E0" width="90%">
+ <tr>
+ <td>
+ <pre class="SCREEN">
+ # Allow systems that can reach Privoxy to provide the client
+ # IP address with a X-Forwarded-For header.
+ trust-x-forwarded-for 1
+
</pre>
</td>
</tr>
Get Support</a></h2>
<p>All users are welcome to discuss their issues on the <a href=
- "https://lists.sourceforge.net/lists/listinfo/ijbswa-users" target=
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
"_top">users mailing list</a>, where the developers also hang
around.</p>
contribute to the project are always welcome on the developers list.
You can find an overview of all <span class=
"APPLICATION">Privoxy</span>-related mailing lists, including list
- archives, at: <a href="https://sourceforge.net/mail/?group_id=11118"
+ archives, at: <a href="https://lists.privoxy.org/mailman/listinfo"
+ target="_top">https://lists.privoxy.org/mailman/listinfo</a>. The lists
+ hosted on privoxy.org have been created in 2016, the previously-used
+ lists hosted at SourceForge are deprecated but the archives may still
+ be useful: <a href="https://sourceforge.net/mail/?group_id=11118"
target="_top">https://sourceforge.net/mail/?group_id=11118</a>.</p>
</div>
<p>Copyright © 2001-2016 by Privoxy Developers <code class=
"EMAIL"><<a href=
- "mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p>
+ "mailto:privoxy-devel@lists.privoxy.org">privoxy-devel@lists.privoxy.org</a>></code></p>
<p>Some source code is based on code Copyright © 1997 by Anonymous
Coders and Junkbusters, Inc. and licensed under the <i class=
<dt>7.6.15. <a href=
"config.html#CLIENT-TAG-LIFETIME">client-tag-lifetime</a></dt>
+
+ <dt>7.6.16. <a href=
+ "config.html#TRUST-X-FORWARDED-FOR">trust-x-forwarded-for</a></dt>
</dl>
</dd>
<p>If you wish to receive an email notification whenever we release
updates of <span class="APPLICATION">Privoxy</span> or the actions
file, <a href=
- "https://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" target=
+ "https://lists.privoxy.org/mailman/listinfo/privoxy-announce" target=
"_top">subscribe to our announce mailing list</a>,
- ijbswa-announce@lists.sourceforge.net.</p>
+ privoxy-announce@lists.privoxy.org.</p>
<p>In order not to lose your personal changes and adjustments when
updating to the latest <tt class="LITERAL">default.action</tt> file we
projects / privoxy.git / commitdiff