459 lines
17 KiB
HTML
459 lines
17 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content=
|
|
"HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">
|
|
|
|
<title>Starting Privoxy</title>
|
|
<meta name="GENERATOR" content=
|
|
"Modular DocBook HTML Stylesheet Version 1.79">
|
|
<link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html">
|
|
<link rel="PREVIOUS" title="Quickstart to Using Privoxy" href=
|
|
"quickstart.html">
|
|
<link rel="NEXT" title="Privoxy Configuration" href="configuration.html">
|
|
<link rel="STYLESHEET" type="text/css" href="../p_doc.css">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
|
<link rel="STYLESHEET" type="text/css" href="p_doc.css">
|
|
<style type="text/css">
|
|
body {
|
|
background-color: #EEEEEE;
|
|
color: #000000;
|
|
}
|
|
:link { color: #0000FF }
|
|
:visited { color: #840084 }
|
|
:active { color: #0000FF }
|
|
table.c4 {background-color: #E0E0E0}
|
|
p.c3 {font-weight: bold}
|
|
span.c2 {font-style: italic}
|
|
hr.c1 {text-align: left}
|
|
</style>
|
|
</head>
|
|
|
|
<body class="SECT1">
|
|
<div class="NAVHEADER">
|
|
<table summary="Header navigation table" width="100%" border="0"
|
|
cellpadding="0" cellspacing="0">
|
|
<tr>
|
|
<th colspan="3" align="center">Privoxy 3.0.19 User Manual</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td width="10%" align="left" valign="bottom"><a href=
|
|
"quickstart.html" accesskey="P">Prev</a></td>
|
|
|
|
<td width="80%" align="center" valign="bottom"></td>
|
|
|
|
<td width="10%" align="right" valign="bottom"><a href=
|
|
"configuration.html" accesskey="N">Next</a></td>
|
|
</tr>
|
|
</table>
|
|
<hr class="c1" width="100%">
|
|
</div>
|
|
|
|
<div class="SECT1">
|
|
<h1 class="SECT1"><a name="STARTUP" id="STARTUP">5. Starting
|
|
Privoxy</a></h1>
|
|
|
|
<p>Before launching <span class="APPLICATION">Privoxy</span> for the
|
|
first time, you will want to configure your browser(s) to use
|
|
<span class="APPLICATION">Privoxy</span> as a HTTP and HTTPS (SSL)
|
|
<a href="http://en.wikipedia.org/wiki/Proxy_server" target=
|
|
"_top">proxy</a>. The default is 127.0.0.1 (or localhost) for the proxy
|
|
address, and port 8118 (earlier versions used port 8000). This is the one
|
|
configuration step <span class="emphasis EMPHASIS c2">that must be
|
|
done</span>!</p>
|
|
|
|
<p>Please note that <span class="APPLICATION">Privoxy</span> can only
|
|
proxy HTTP and HTTPS traffic. It will not work with FTP or other
|
|
protocols.</p>
|
|
|
|
<div class="FIGURE">
|
|
<a name="AEN899" id="AEN899"></a>
|
|
|
|
<p class="c3">Figure 2. Proxy Configuration Showing Mozilla/Netscape
|
|
HTTP and HTTPS (SSL) Settings</p>
|
|
|
|
<div class="MEDIAOBJECT">
|
|
<p><img src="proxy_setup.jpg"></p>
|
|
</div>
|
|
</div>
|
|
|
|
<p>With <span class="APPLICATION">Firefox</span>, this is typically set
|
|
under:</p>
|
|
|
|
<p class="LITERALLAYOUT"> <span class=
|
|
"GUIBUTTON">Tools</span> -> <span class=
|
|
"GUIBUTTON">Options</span> -> <span class=
|
|
"GUIBUTTON">Advanced</span> -> <span class=
|
|
"GUIBUTTON">Network</span> -><span class=
|
|
"GUIBUTTON">Connection</span> -> <span class=
|
|
"GUIBUTTON">Settings</span><br></p>
|
|
|
|
<p>Or optionally on some platforms:</p>
|
|
|
|
<p class="LITERALLAYOUT"> <span class=
|
|
"GUIBUTTON">Edit</span> -> <span class=
|
|
"GUIBUTTON">Preferences</span> -> <span class=
|
|
"GUIBUTTON">General</span> -> <span class=
|
|
"GUIBUTTON">Connection Settings</span> -> <span class=
|
|
"GUIBUTTON">Manual Proxy Configuration</span><br></p>
|
|
|
|
<p>With <span class="APPLICATION">Netscape</span> (and <span class=
|
|
"APPLICATION">Mozilla</span>), this can be set under:</p>
|
|
|
|
<p class="LITERALLAYOUT"> <span class=
|
|
"GUIBUTTON">Edit</span> -> <span class=
|
|
"GUIBUTTON">Preferences</span> -> <span class=
|
|
"GUIBUTTON">Advanced</span> -> <span class=
|
|
"GUIBUTTON">Proxies</span> -> <span class="GUIBUTTON">HTTP
|
|
Proxy</span><br></p>
|
|
|
|
<p>For <span class="APPLICATION">Internet Explorer v.5-7</span>:</p>
|
|
|
|
<p class="LITERALLAYOUT"> <span class=
|
|
"GUIBUTTON">Tools</span> -> <span class="GUIBUTTON">Internet
|
|
Options</span> -> <span class=
|
|
"GUIBUTTON">Connections</span> -> <span class=
|
|
"GUIBUTTON">LAN Settings</span></p>
|
|
|
|
<p>Then, check <span class="QUOTE">"Use Proxy"</span> and fill in the
|
|
appropriate info (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL),
|
|
if you want HTTPS proxy support too (sometimes labeled <span class=
|
|
"QUOTE">"Secure"</span>). Make sure any checkboxes like <span class=
|
|
"QUOTE">"Use the same proxy server for all protocols"</span> is
|
|
<span class="emphasis EMPHASIS c2">UNCHECKED</span>. You want only HTTP
|
|
and HTTPS (SSL)!</p>
|
|
|
|
<div class="FIGURE">
|
|
<a name="AEN944" id="AEN944"></a>
|
|
|
|
<p class="c3">Figure 3. Proxy Configuration Showing Internet Explorer
|
|
HTTP and HTTPS (Secure) Settings</p>
|
|
|
|
<div class="MEDIAOBJECT">
|
|
<p><img src="proxy2.jpg"></p>
|
|
</div>
|
|
</div>
|
|
|
|
<p>After doing this, flush your browser's disk and memory caches to force
|
|
a re-reading of all pages and to get rid of any ads that may be cached.
|
|
Remove any <a href="http://en.wikipedia.org/wiki/Browser_cookie" target=
|
|
"_top">cookies</a>, if you want <span class="APPLICATION">Privoxy</span>
|
|
to manage that. You are now ready to start enjoying the benefits of using
|
|
<span class="APPLICATION">Privoxy</span>!</p>
|
|
|
|
<p><span class="APPLICATION">Privoxy</span> itself is typically started
|
|
by specifying the main configuration file to be used on the command line.
|
|
If no configuration file is specified on the command line, <span class=
|
|
"APPLICATION">Privoxy</span> will look for a file named <tt class=
|
|
"FILENAME">config</tt> in the current directory. Except on Win32 where it
|
|
will try <tt class="FILENAME">config.txt</tt>.</p>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-REDHAT" id="START-REDHAT">5.1. Red Hat
|
|
and Fedora</a></h2>
|
|
|
|
<p>A default Red Hat installation may not start <span class=
|
|
"APPLICATION">Privoxy</span> upon boot. It will use the file <tt class=
|
|
"FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p>
|
|
|
|
<table class="c4" border="0" width="100%">
|
|
<tr>
|
|
<td>
|
|
<pre class="SCREEN">
|
|
# /etc/rc.d/init.d/privoxy start
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>Or ...</p>
|
|
|
|
<table class="c4" border="0" width="100%">
|
|
<tr>
|
|
<td>
|
|
<pre class="SCREEN">
|
|
# service privoxy start
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.2.
|
|
Debian</a></h2>
|
|
|
|
<p>We use a script. Note that Debian typically starts <span class=
|
|
"APPLICATION">Privoxy</span> upon booting per default. It will use the
|
|
file <tt class="FILENAME">/etc/privoxy/config</tt> as its main
|
|
configuration file.</p>
|
|
|
|
<table class="c4" border="0" width="100%">
|
|
<tr>
|
|
<td>
|
|
<pre class="SCREEN">
|
|
# /etc/init.d/privoxy start
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-WINDOWS" id="START-WINDOWS">5.3.
|
|
Windows</a></h2>
|
|
|
|
<p>Click on the <span class="APPLICATION">Privoxy</span> Icon to start
|
|
<span class="APPLICATION">Privoxy</span>. If no configuration file is
|
|
specified on the command line, <span class="APPLICATION">Privoxy</span>
|
|
will look for a file named <tt class="FILENAME">config.txt</tt>. Note
|
|
that Windows will automatically start <span class=
|
|
"APPLICATION">Privoxy</span> when the system starts if you chose that
|
|
option when installing.</p>
|
|
|
|
<p><span class="APPLICATION">Privoxy</span> can run with full Windows
|
|
service functionality. On Windows only, the <span class=
|
|
"APPLICATION">Privoxy</span> program has two new command line arguments
|
|
to install and uninstall <span class="APPLICATION">Privoxy</span> as a
|
|
service. See the <a href=
|
|
"installation.html#INSTALLATION-PACK-WIN">Windows Installation
|
|
instructions</a> for details.</p>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4.
|
|
Solaris, NetBSD, FreeBSD, HP-UX and others</a></h2>
|
|
|
|
<p>Example Unix startup command:</p>
|
|
|
|
<table class="c4" border="0" width="100%">
|
|
<tr>
|
|
<td>
|
|
<pre class="SCREEN">
|
|
# /usr/sbin/privoxy /etc/privoxy/config
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.5. OS/2</a></h2>
|
|
|
|
<p>During installation, <span class="APPLICATION">Privoxy</span> is
|
|
configured to start automatically when the system restarts. You can
|
|
start it manually by double-clicking on the <span class=
|
|
"APPLICATION">Privoxy</span> icon in the <span class=
|
|
"APPLICATION">Privoxy</span> folder.</p>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.6. Mac OS
|
|
X</a></h2>
|
|
|
|
<p>After downloading the privoxy software, unzip the downloaded file by
|
|
double-clicking on the zip file icon. Then, double-click on the
|
|
installer package icon and follow the installation process.</p>
|
|
|
|
<p>The privoxy service will automatically start after a successful
|
|
installation. In addition, the privoxy service will automatically start
|
|
every time your computer starts up.</p>
|
|
|
|
<p>To prevent the privoxy service from automatically starting when your
|
|
computer starts up, remove or rename the folder named
|
|
/Library/StartupItems/Privoxy.</p>
|
|
|
|
<p>A simple application named Privoxy Utility has been created which
|
|
enables administrators to easily start and stop the privoxy
|
|
service.</p>
|
|
|
|
<p>In addition, the Privoxy Utility presents a simple way for
|
|
administrators to edit the various privoxy config files. A method to
|
|
uninstall the software is also available.</p>
|
|
|
|
<p>An administrator username and password must be supplied in order for
|
|
the Privoxy Utility to perform any of the tasks.</p>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-AMIGAOS" id="START-AMIGAOS">5.7.
|
|
AmigaOS</a></h2>
|
|
|
|
<p>Start <span class="APPLICATION">Privoxy</span> (with RUN
|
|
<>NIL:) in your <tt class="FILENAME">startnet</tt> script
|
|
(AmiTCP), in <tt class="FILENAME">s:user-startup</tt> (RoadShow), as
|
|
startup program in your startup script (Genesis), or as startup action
|
|
(Miami and MiamiDx). <span class="APPLICATION">Privoxy</span> will
|
|
automatically quit when you quit your TCP/IP stack (just ignore the
|
|
harmless warning your TCP/IP stack may display that <span class=
|
|
"APPLICATION">Privoxy</span> is still running).</p>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="START-GENTOO" id="START-GENTOO">5.8.
|
|
Gentoo</a></h2>
|
|
|
|
<p>A script is again used. It will use the file <tt class=
|
|
"FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p>
|
|
|
|
<table class="c4" border="0" width="100%">
|
|
<tr>
|
|
<td>
|
|
<pre class="SCREEN">
|
|
/etc/init.d/privoxy start
|
|
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>Note that <span class="APPLICATION">Privoxy</span> is not
|
|
automatically started at boot time by default. You can change this with
|
|
the <tt class="LITERAL">rc-update</tt> command.</p>
|
|
|
|
<table class="c4" border="0" width="100%">
|
|
<tr>
|
|
<td>
|
|
<pre class="SCREEN">
|
|
rc-update add privoxy default
|
|
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="SECT2">
|
|
<h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.9. Command
|
|
Line Options</a></h2>
|
|
|
|
<p><span class="APPLICATION">Privoxy</span> may be invoked with the
|
|
following command-line options:</p>
|
|
|
|
<ul>
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--version</span></p>
|
|
|
|
<p>Print version info and exit. Unix only.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--help</span></p>
|
|
|
|
<p>Print short usage info and exit. Unix only.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--no-daemon</span></p>
|
|
|
|
<p>Don't become a daemon, i.e. don't fork and become process group
|
|
leader, and don't detach from controlling tty. Unix only.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--pidfile FILE</span></p>
|
|
|
|
<p>On startup, write the process ID to <span class=
|
|
"emphasis EMPHASIS c2">FILE</span>. Delete the <span class=
|
|
"emphasis EMPHASIS c2">FILE</span> on exit. Failure to create or
|
|
delete the <span class="emphasis EMPHASIS c2">FILE</span> is
|
|
non-fatal. If no <span class="emphasis EMPHASIS c2">FILE</span>
|
|
option is given, no PID file will be used. Unix only.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--user
|
|
USER[.GROUP]</span></p>
|
|
|
|
<p>After (optionally) writing the PID file, assume the user ID of
|
|
<span class="emphasis EMPHASIS c2">USER</span>, and if included the
|
|
GID of GROUP. Exit if the privileges are not sufficient to do so.
|
|
Unix only.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--chroot</span></p>
|
|
|
|
<p>Before changing to the user ID given in the <span class=
|
|
"emphasis EMPHASIS c2">--user</span> option, chroot to that user's
|
|
home directory, i.e. make the kernel pretend to the <span class=
|
|
"APPLICATION">Privoxy</span> process that the directory tree starts
|
|
there. If set up carefully, this can limit the impact of possible
|
|
vulnerabilities in <span class="APPLICATION">Privoxy</span> to the
|
|
files contained in that hierarchy. Unix only.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">--pre-chroot-nslookup
|
|
hostname</span></p>
|
|
|
|
<p>Specifies a hostname to look up before doing a chroot. On some
|
|
systems, initializing the resolver library involves reading config
|
|
files from /etc and/or loading additional shared libraries from
|
|
/lib. On these systems, doing a hostname lookup before the chroot
|
|
reduces the number of files that must be copied into the chroot
|
|
tree.</p>
|
|
|
|
<p>For fastest startup speed, a good value is a hostname that is
|
|
not in /etc/hosts but that your local name server (listed in
|
|
/etc/resolv.conf) can resolve without recursion (that is, without
|
|
having to ask any other name servers). The hostname need not exist,
|
|
but if it doesn't, an error message (which can be ignored) will be
|
|
output.</p>
|
|
</li>
|
|
|
|
<li>
|
|
<p><span class="emphasis EMPHASIS c2">configfile</span></p>
|
|
|
|
<p>If no <span class="emphasis EMPHASIS c2">configfile</span> is
|
|
included on the command line, <span class=
|
|
"APPLICATION">Privoxy</span> will look for a file named
|
|
<span class="QUOTE">"config"</span> in the current directory
|
|
(except on Win32 where it will look for <span class=
|
|
"QUOTE">"config.txt"</span> instead). Specify full path to avoid
|
|
confusion. If no config file is found, <span class=
|
|
"APPLICATION">Privoxy</span> will fail to start.</p>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>On <span class="APPLICATION">MS Windows</span> only there are two
|
|
additional command-line options to allow <span class=
|
|
"APPLICATION">Privoxy</span> to install and run as a <span class=
|
|
"emphasis EMPHASIS c2">service</span>. See the <a href=
|
|
"installation.html#INSTALLATION-PACK-WIN">Window Installation
|
|
section</a> for details.</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="NAVFOOTER">
|
|
<hr class="c1" width="100%">
|
|
|
|
<table summary="Footer navigation table" width="100%" border="0"
|
|
cellpadding="0" cellspacing="0">
|
|
<tr>
|
|
<td width="33%" align="left" valign="top"><a href="quickstart.html"
|
|
accesskey="P">Prev</a></td>
|
|
|
|
<td width="34%" align="center" valign="top"><a href="index.html"
|
|
accesskey="H">Home</a></td>
|
|
|
|
<td width="33%" align="right" valign="top"><a href=
|
|
"configuration.html" accesskey="N">Next</a></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td width="33%" align="left" valign="top">Quickstart to Using
|
|
Privoxy</td>
|
|
|
|
<td width="34%" align="center" valign="top"> </td>
|
|
|
|
<td width="33%" align="right" valign="top">Privoxy Configuration</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</body>
|
|
</html>
|