X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fstartup.html;h=9eb42583e982d46c6cb8bbf70edf288b10bc3edb;hp=df6da50ab16038c8562d83573d04fc24a6be8296;hb=60cbbc5f5d7514135bc5afc02d24e77a231c47f4;hpb=6d810395712f0337682205c4ea304009c86c128f diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html index df6da50a..9eb42583 100644 --- a/doc/webserver/user-manual/startup.html +++ b/doc/webserver/user-manual/startup.html @@ -1,533 +1,389 @@ - + + -
- -- Before launching Privoxy for the - first time, you will want to configure your browser(s) to use Privoxy as a HTTP and HTTPS (SSL) proxy. - 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 that - must be done! -
-- Please note that Privoxy can only - proxy HTTP and HTTPS traffic. It will not work with FTP or other - protocols. -
--
-- Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and - HTTPS (SSL) Settings -
-- -
-- With Firefox, this is typically set - under: -
-
- Tools -> Options -> Advanced -> Network ->Connection -> Settings
-
-
- Or optionally on some platforms: -
-
- Edit -> Preferences -> General -> Connection Settings -> Manual Proxy Configuration
-
-
- With Netscape (and Mozilla), this can be set under: -
-
- Edit -> Preferences -> Advanced -> Proxies -> HTTP Proxy
-
-
- For Internet Explorer v.5-7: -
-- Tools -> Internet Options -> Connections -> LAN Settings -
-- Then, check "Use Proxy" 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 "Secure"). Make sure any checkboxes like "Use the same proxy server for all protocols" is - UNCHECKED. You - want only HTTP and HTTPS (SSL)! -
--
-- Figure 3. Proxy Configuration Showing Internet Explorer HTTP and - HTTPS (Secure) Settings -
-- -
-Privoxy 3.0.21 User Manual | +
---|
-- # /etc/rc.d/init.d/privoxy start -- |
-
- Or ... -
--
-
-- # service privoxy start -- |
-
- We use a script. Note that Debian typically starts Privoxy upon booting per default. It will use - the file /etc/privoxy/config as its main - configuration file. -
--
-
-- # /etc/init.d/privoxy start -- |
-
- Click on the Privoxy Icon to start - Privoxy. If no configuration file - is specified on the command line, Privoxy will look for a file named config.txt. Note that Windows will automatically - start Privoxy when the system - starts if you chose that option when installing. -
-- Privoxy can run with full Windows - service functionality. On Windows only, the Privoxy program has two new command line - arguments to install and uninstall Privoxy as a service. See the Windows Installation - instructions for details. -
-- Example Unix startup command: -
--
-
-- # /usr/sbin/privoxy /etc/privoxy/config -- |
-
- During installation, Privoxy is - configured to start automatically when the system restarts. You can - start it manually by double-clicking on the Privoxy icon in the Privoxy folder. -
-- 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. -
-- The privoxy service will automatically start after a successful - installation. In addition, the privoxy service will automatically - start every time your computer starts up. -
-- To prevent the privoxy service from automatically starting when - your computer starts up, remove or rename the folder named - /Library/StartupItems/Privoxy. -
-- A simple application named Privoxy Utility has been created which - enables administrators to easily start and stop the privoxy - service. -
-- 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. -
-- An administrator username and password must be supplied in order - for the Privoxy Utility to perform any of the tasks. -
-- Start Privoxy (with RUN - <>NIL:) in your startnet script - (AmiTCP), in s:user-startup (RoadShow), - as startup program in your startup script (Genesis), or as startup - action (Miami and MiamiDx). Privoxy will automatically quit when you quit - your TCP/IP stack (just ignore the harmless warning your TCP/IP - stack may display that Privoxy is - still running). -
-- A script is again used. It will use the file /etc/privoxy/config as its main configuration file. -
--
-
-- /etc/init.d/privoxy start -- |
-
- Note that Privoxy is not - automatically started at boot time by default. You can change this - with the rc-update command. -
--
-
-- rc-update add privoxy default -- |
-
Before launching Privoxy for the + first time, you will want to configure your browser(s) to use + Privoxy as a HTTP and HTTPS (SSL) + proxy. 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 that must + be done!
+ +Please note that Privoxy can only + proxy HTTP and HTTPS traffic. It will not work with FTP or other + protocols.
+ +Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and + HTTPS (SSL) Settings
+ +- Privoxy may be invoked with the - following command-line options: -
--
-- --version -
-- Print version info and exit. Unix only. -
-- --help -
-- Print short usage info and exit. Unix only. -
-- --no-daemon -
-- Don't become a daemon, i.e. don't fork and become process group - leader, and don't detach from controlling tty. Unix only. -
-- --pidfile - FILE -
-- 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 FILE option is given, - no PID file will be used. Unix only. -
-- --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. -
-- --chroot -
-- Before changing to the user ID given in the --user option, chroot - to that user's home directory, i.e. make the kernel pretend to - the Privoxy process that the - directory tree starts there. If set up carefully, this can - limit the impact of possible vulnerabilities in Privoxy to the files contained in that - hierarchy. Unix only. -
-- --pre-chroot-nslookup hostname -
-- 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. -
-- 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. -
-- configfile -
-- 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. -
-- On MS Windows only there are two - additional command-line options to allow Privoxy to install and run as a service. See the Window Installation - section for details. -
+With Firefox, this is typically set + under:
+ + Tools -> Options -> Advanced -> Network ->Connection -> Settings
Or optionally on some platforms:
+ + Edit -> Preferences -> General -> Connection Settings -> Manual Proxy Configuration
With Netscape (and Mozilla), this can be set under:
+ + Edit -> Preferences -> Advanced -> Proxies -> HTTP
+ Proxy
For Internet Explorer v.5-7:
+ +Tools -> Internet + Options -> Connections -> LAN Settings
+ +Then, check "Use Proxy" 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 "Secure"). Make sure any checkboxes like "Use the same proxy server for all protocols" is + UNCHECKED. You want + only HTTP and HTTPS (SSL)!
+ +Figure 3. Proxy Configuration Showing Internet Explorer HTTP and + HTTPS (Secure) Settings
+ +- Prev - | -- Home - | -- Next + |
+ + # /etc/init.d/privoxy start + |
Click on the Privoxy Icon to start + Privoxy. If no configuration file is + specified on the command line, Privoxy + will look for a file named config.txt. Note + that Windows will automatically start Privoxy when the system starts if you chose that + option when installing.
+ +Privoxy can run with full Windows + service functionality. On Windows only, the Privoxy program has two new command line arguments + to install and uninstall Privoxy as a + service. See the Windows Installation + instructions for details.
+Example Unix startup command:
+ +- Quickstart to Using Privoxy - | -- - | -- Privoxy Configuration + |
+ + # /usr/sbin/privoxy /etc/privoxy/config + |
During installation, Privoxy is + configured to start automatically when the system restarts. You can + start it manually by double-clicking on the Privoxy icon in the Privoxy folder.
+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.
+ +The privoxy service will automatically start after a successful + installation. In addition, the privoxy service will automatically start + every time your computer starts up.
+ +To prevent the privoxy service from automatically starting when your + computer starts up, remove or rename the folder named + /Library/StartupItems/Privoxy.
+ +A simple application named Privoxy Utility has been created which + enables administrators to easily start and stop the privoxy + service.
+ +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.
+ +An administrator username and password must be supplied in order for + the Privoxy Utility to perform any of the tasks.
+Privoxy may be invoked with the + following command-line options:
+ +--config-test
+ +Exit after loading the configuration files before binding to the + listen address. The exit code signals whether or not the + configuration files have been successfully loaded.
+ +If the exit code is 1, at least one of the configuration files + is invalid, if it is 0, all the configuration files have been + successfully loaded (but may still contain errors that can + currently only be detected at run time).
+ +This option doesn't affect the log setting, combination with + --no-daemon + is recommended if a configured log file shouldn't be used.
+--version
+ +Print version info and exit. Unix only.
+--help
+ +Print short usage info and exit. Unix only.
+--no-daemon
+ +Don't become a daemon, i.e. don't fork and become process group + leader, and don't detach from controlling tty. Unix only.
+--pidfile + FILE
+ +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 FILE option is given, no + PID file will be used. Unix only.
+--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.
+--chroot
+ +Before changing to the user ID given in the --user option, chroot to + that user's home directory, i.e. make the kernel pretend to the + Privoxy process that the directory + tree starts there. If set up carefully, this can limit the impact + of possible vulnerabilities in Privoxy to the files contained in that + hierarchy. Unix only.
+--pre-chroot-nslookup + hostname
+ +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.
+ +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.
+configfile
+ +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.
+On MS Windows only there are two + additional command-line options to allow Privoxy to install and run as a service. See the Window Installation + section for details.
+