From: Source Maintenance Date: Thu, 26 Mar 2015 09:52:12 +0000 (+0000) Subject: Docs: update QUICKSTART and INSTALL X-Git-Tag: merge-candidate-3-v1~202 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=302e532292072f4355899454b33086cc1c80d75f;p=thirdparty%2Fsquid.git Docs: update QUICKSTART and INSTALL --- diff --git a/INSTALL b/INSTALL index c6731faee9..97721c1106 100644 --- a/INSTALL +++ b/INSTALL @@ -1,3 +1,11 @@ +/* + * Copyright (C) 1996-2015 The Squid Software Foundation and contributors + * + * Squid software is distributed under GPLv2+ license and includes + * contributions from numerous individuals and organizations. + * Please see the COPYING and CONTRIBUTORS files for details. + */ + To build and install the Squid Cache, type: % ./configure --prefix=/usr/local/squid @@ -16,5 +24,5 @@ To run a Cache, you will need to: % /usr/local/squid/sbin/squid If you want to use the WWW interface to the Cache Manager, copy -the cachemgr.cgi program into your httpd server's cgi-bin +the tools/cachemgr.cgi program into your httpd server's cgi-bin directory. diff --git a/QUICKSTART b/QUICKSTART index 06c6bda296..f0294bab5f 100644 --- a/QUICKSTART +++ b/QUICKSTART @@ -20,40 +20,38 @@ Uncomment and edit the following lines in /usr/local/squid/etc/squid.conf: acl, http_access Access control lists. This is important because it prevents people - from stealing your network resources. To fill in the - "localnet" ACL, use your network address (for instance 192.168.10.0 - your CIDR network mask (for instance 255.255.255.0 or /24): + from stealing your network resources. + + Edit the "localnet" ACL definition to be your LAN network address + ranges in CIDR format. For instance: - acl manager proto cache_object - acl localhost src 127.0.0.1 acl localnet src 192.168.10.0/24 - http_access deny manager all - http_access allow localnet - http_access deny all + Add any other ACLs and edit the http_access lines to match your policy + requirements for use of the proxy. See Squid FAQ for more details. cache_mgr - Put here the e-mail address of the manager: + Put here the e-mail address of the manager. + +============================================================================== + +Some configuration lines which are optional but may be needed. visible_hostname - The host name you advertise for the cache. + The publicly visible host name advertised for the cache. This will + be used for URLs generated by Squid for clients to fetch certain + objects from. cache_effective_user If building your own squid; use ./configure --with-default-user=X - If you must start Squid as root, find a safe user and group to run + You must start Squid as root, with a safe user and group to run as after startup (typically "nobody" and "nogroup"). Do not use "root", for security reasons. - -============================================================================== - -Some configuration lines which are optional but may be needed. - - cache_dir ufs /usr/local/squid/var/cache 100 16 256 Add here (first number, here 100) the amount of hard disk space @@ -98,5 +96,15 @@ Once you have Squid working from the command line, tell your Unix to start Squid at startup (it depends heavily on the Unix you use, you'll typically have to modify something in a /etc/rc_something). -This quick start file written by: Stephane Bortzmeyer and Duane -Wessels. +============================================================================== + +/* + * Copyright (C) 1996-2015 The Squid Software Foundation and contributors + * + * Squid software is distributed under GPLv2+ license and includes + * contributions from numerous individuals and organizations. + * Please see the COPYING and CONTRIBUTORS files for details. + */ + +This quick start file written by: + Stephane Bortzmeyer and Duane Wessels.