iunx的squid 命令行选项分类

在开始其他事情之前，让我们先看一下squid 的命令行选项。这里的许多选项你从不会使用，另外有些仅仅在调试问题时有用。
-a port
指定新的http_port 值。该选项覆盖了来自squid.conf 的值。然而请注意，你能在squid.conf里指定多个值。-a 选项仅仅覆盖配置文件里的第一个值。（该选项使用字母a 是因为在Harvest
[url=javascript:;] cache[/url]
里，HTTP 端口被叫做ASCII 端口）
-d level
让squid 将它的调试信息写到标准错误（假如配置了，就是cache.log 和syslog）。level参数指定了显示在标准错误里的消息的最大等级。在多数情况下，d1 工作良好。请见16.2章关于调试等级的描述。
-f file
指定另一个配置文件。
-h
显示用法。
-k function
指示squid 执行不同的管理功能。功能参数是下列之一：reconfigure，rotate，shutdown，interrupt，kill，debug，check，or parse。
+ reconfigure 导致运行中的squid 重新读取配置文件。
+ rotate导致squid 滚动它的日志，这包括了关闭日志，重命名，和再次打开它们。
+ shutdown 发送关闭squid 进程的信号。
+ interrupt 立刻关闭squid，不必等待活动会话完成。
+ kill 发送KILL 信号给squid，这是关闭squid 的最后保证。
+ debug 将squid 设置成完全的调试模式，假如你的cache 很忙，它能迅速的用完你的磁盘空间。
+ check 简单的检查运行中的squid 进程，返回的值显示squid 是否在运行。
+ 最后，parse 简单的解析squid.conf 文件，如果配置文件包含错误，进程返回非零值。
-s
激活将日志记录到syslog 进程。squid 使用LOCAL4 syslog 设备。0
级别调试信息以优先级LOG_WARNING 被记录，1 级别消息以LOG_NOTICE
被记录。更高级的调试信息不会被发送到syslogd.你可以在/etc/syslogd.conf 文件里使用如下接口：
local4.warning /var/log/squid.log
-u port
指定另一个ICP 端口号，覆盖掉squid.conf 文件里的icp_port。
-v
打印版本信息。
-z
初始化cache，或者交换，目录。在首次运行squid，或者增加新的cache 目录时，你必须使用该选项。
-C
阻止安装某些信号句柄，它们捕获特定的致命信号例如SIGBUS 和SIGSEGV。正常的，这些信号被squid 捕获，以便它能干净的关闭。然而，捕获这些信号可能让以后调试问题困难。使用该选项，致命的信号导致它们的默认动作，通常是coredump。
-D
禁止初始化DNS 测试。正常情况下，squid 直到验证它的DNS 可用才能启动。该选项阻止了这样的检测。你也能在squid.conf 文件里改变或删除dns_testnames 选项。
-F
让squid 拒绝所有的请求，直到它重新建立起存储元数据。假如你的系统很忙，该选项可以减短重建存储元数据的时间。然而，如果你的cache 很大，重建过程可能会花费很长的时间。
-N
阻止squid 变成后台服务进程。
-R
阻止squid 在绑定HTTP 端口之前使用SO_REUSEADDR 选项。
-V
激活虚拟主机加速模式。类似于squid.conf 文件里的httpd_accel_host virtual 指令。
-X
强迫完整调试模式，如你在squid.conf 文件里指定debug_options ALL,9 一样。
-Y
在重建存储元数据时，返回ICP_MISS_NOFETCH 代替ICP_MISS.忙碌的父cache 在重建时，该选项可以导致最少的负载。请见10.6.1.2 章。
5.2 对配置文件查错
在开启squid 之前，你应该谨慎的验证配置文件。这点容易做到，运行如下命令即可：
%squid -k parse
假如你看不到输出，配置文件有效，你能继续后面的步骤。
然而，如果配置文件包含错误，squid 会告诉你：
squid.conf line 62: http_access allow okay2
aclParseAccessLine: ACL name 'okay2' not found.
这里你可以看到，62 行的http_access 指令指向的ACL 不存在。有时候错误信息很少：
FATAL: Bungled squid.conf line 76: memory_pools
在这个情形里，我们忘记了在76 行的memory_pools 指令后放置on 或off。
建议你养成习惯：在每次修改配置文件后，使用squid -k parse。假如你不愿麻烦，并且你的配置文件有错误，squid
会告诉你关于它们而且拒绝启动。假如你管理着大量的cache，也许你会编辑脚本来自动启动，停止和重配置squid。你能在脚本里使用该功能，来确认配
置文件是有效的。
5.3 初始化cache 目录
在初次运行squid 之前，或者无论何时你增加了新的cache_dir，你必须初始化cache 目录。命令很简单：
%squid –z
对UFS 相关的存储机制（ufs,aufs,and diskd;见第8 章），该命令在每个cache_dir 下面创建了所需的子目录。你不必担心squid 会破坏你的当前cache 目录（如果有的话）。
在该阶段属主和许可权是通常遇到的问题。squid 在特定的用户ID 下运行，这在squid.conf 文件里的cache_effective_user 里指定。用户ID 必须对每个cache_dir 目录有读和写权限。否则，你将看到如下信息：
Creating Swap Directories
FATAL: Failed to make swap directory /usr/local/squid/var/cache/00:
(13) Permission denied
在这样的情形下，你该确认/usr/local/squid/var/cache 目录的所有组成都可被squid.conf给定的用户ID 访问。最终的组件--cache 目录--必须对该用户ID 可写。
cache 目录初始化可能花费一些时间，依赖于cache 目录的大小和数量，以及磁盘驱动器的速度。假如你想观察这个过程，请使用-X 选项：
%squid –zX
5.4 在终端窗口里测试squid
一旦你已经初始化cache 目录，就可以在终端窗口里运行squid，将日志记录到标准错误。这样，你能轻易的定位任何错误或问题，并且确认squid 是否成功启动。使用-N 选项来保持squid 在前台运行，-d1 选项在标准错误里显示1 级别的调试信息。
%squid -N -d1
你将看到类似于以下的输出：
2003/09/29 12:57:52| Starting Squid Cache
version 2.5.STABLE4 for i386-unknown-freebsd4.8...
2003/09/29 12:57:52| Process ID 294
2003/09/29 12:57:52| With 1064 file descrīptors available
2003/09/29 12:57:52| DNS Socket created on FD 4
2003/09/29 12:57:52| Adding nameserver 206.107.176.2 from /etc/resolv.conf
2003/09/29 12:57:52| Adding nameserver 205.162.184.2 from /etc/resolv.conf
2003/09/29 12:57:52| Unlinkd pipe opened on FD 9
2003/09/29 12:57:52| Swap maxSize 102400 KB, estimated 7876 objects
2003/09/29 12:57:52| Target number of buckets: 393
2003/09/29 12:57:52| Using 8192 Store buckets
2003/09/29 12:57:52| Max Mem size: 8192 KB
2003/09/29 12:57:52| Max Swap size: 102400 KB
2003/09/29 12:57:52| Rebuilding storage in /usr/local/squid/var/cache (DIRTY)
2003/09/29 12:57:52| Using Least Load store dir selection
2003/09/29 12:57:52| Set Current Directory to /usr/local/squid/var/cache
2003/09/29 12:57:52| Loaded Icons.
2003/09/29 12:57:52| Accepting HTTP connections at 0.0.0.0, port 3128, FD 11.
2003/09/29 12:57:52| Accepting ICP messages at 0.0.0.0, port 3130, FD 12.
2003/09/29 12:57:52| WCCP Disabled.
2003/09/29 12:57:52| Ready to serve reques
假如你看到错误消息，你该首先修正它。请检查输出信息的开始几行以发现警告信息。最普通的错误是文件/目录许可问题，和配置文件语法错误。假如你看
到一条不引起注意的错误消息，请见16 章中关于squid 故障处理的建议和信息。如果还不行，请检查squid FAQ，或查找邮件列表来获得解释。
一旦你见到"Ready to serve requests"消息，就可用一些HTTP 请求来测试squid。配置你的浏览器使用squid
作为代理，然后打开某个web 页面。假如squid 工作正常，页面被迅速载入，就象没使用squid
一样。另外，你可以使用squidclient 程序，它随squid
[url=javascript:;] 发布[/url]
：
% squidclient
http://www.squid-cache.org/
假如它正常工作，squid 的主页html 文件会在你的终端窗口里滚动。一旦确认squid 工作正常，你能中断squid 进程（例如使用ctrl-c）并且在后台运行squid。
5.5 将squid 作为服务进程运行
正常情况下你想将squid 以后台进程运行（不出现在终端窗口里）。最容易的方法是简单执行如下命令：
%squid –s
-s 选项导致squid 将重要的状态和警告信息写到syslogd。squid 使用LOCAL4 设备，和LOG_WARNING
和LOG_NOTICE 优先权。syslog 进程实际可能会或不会记录squid
的消息，这依赖于它被如何配置。同样的消息被写进cache.log 文件，所以假如你愿意，忽略-s 选项也是安全的。
当你不使用-N 选项来启动squid，squid
自动在后台运行并且创建父/子进程对。子进程做所有的实际工作。父进程确认子进程总在运行。这样，假如子进程意外终止，父进程启动另外一个子进程以使
squid 正常工作。通过观察syslog 消息，你能看到父/子进程交互作用。
Jul 31 14:58:35 zapp squid[294]: Squid Parent: child process 296 started
这里显示的父进程ID 是294，子进程是296。当你查看ps 的输出，你可以看到子进程以(squid)形式出现：
%ps ax | grep squid
294 ?? Is 0:00.01 squid -sD
296 ?? S 0:00.27 (squid) -sD (squid)
假如squid 进程意外终止，父进程启动另一个。例如：
Jul 31 15:02:53 zapp squid[294]: Squid Parent: child process 296 exited due to signal 6
Jul 31 15:02:56 zapp squid[294]: Squid Parent: child process 359 started
在某些情形下，squid 子进程可能立即终止。为了防止频繁的启动子进程，假如子进程连续5 次没有运行至少10 秒钟，父进程会放弃。
Jul 31 15:13:48 zapp squid[455]: Squid Parent: child process 474 exited with status 1
Jul 31 15:13:48 zapp squid[455]: Exiting due to repeated, frequent failures
如果发生这样的事，请检查syslog 和squid 的cache.log 以发现错误。
5.5.1 squid_start 脚本
当squid 以后台进程运行时，它查找squid 执行程序目录下的名为squid_start
的文件。假如发现，该程序在父进程创建子进程之前被执行。你能使用该脚本完成特定的管理任务，例如通知某人squid
在运行，管理日志文件等。除非squid_start 程序存在，squid 不会创建子进程。
squid_start 脚本在你使用绝对或相对路径启动squid 时才开始工作。换句话说，squid 不使用PATH 环境变量来定位squid_start.这样，你应该养成习惯这样启动squid：
% /usr/local/squid/sbin/squid –sD
而不要这样：
%squid –sD
5.6 启动脚本
通常你希望squid 在每次计算机重启后自动启动。对不同的
[url=javascript:;] 操作系统[/url]
，它们的启动脚本如何工作也很不同。我在这里描述一些通用的环境，但对你自己的特殊操作系统，也许该有特殊的处理方法。
5.6.1 /etc/rc.local
最容易的机制之一是/etc/rc.local 脚本。这是个简单的shell 脚本，在每次系统启动时以root 运行。使用该脚本来启动squid 非常容易，增加一行如下：
/usr/local/squid/sbin/squid –s
当然你的安装位置可能不同，还有你可能要使用其他命令行选项。不要在这里使用-N选项。
假如因为某些理由，你没有使用cache_effective_user 指令，你可以尝试使用su 来让squid以非root 用户运行：
/usr/bin/su nobody -c '/usr/local/squid/sbin/squid -s'
5.6.2 init.d 和rc.d
init.d 和rc.d 机制使用独立的shell 脚本来启动不同的服务。这些脚本通常在下列目录之中：/sbin/init.d,
/etc/init.d, /usr/local/etc/rc.d.脚本通常获取单一命令行参数，是start
或stop。某些系统仅仅使用start 参数。如下是启动squid 的基本脚本：
#!/bin/sh
# this scrīpt starts and stops Squid
case "$1" in
start)
/usr/local/squid/sbin/squid -s
echo -n ' Squid'
;;
stop)
/usr/local/squid/sbin/squid -k shutdown
;;
esac
[url=javascript:;] Linux[/url]
用户可能在启动squid 之前需要设置文件描述符限制。例如：
echo 8192 >; /proc/sys/fs/file-max
limit -HSn 8192
为了使用该脚本，先找到脚本存放的目录。给它一个有意义的名字，类似于其他的系统启动脚本。可以是S98squid 或squid.sh。通过重启计算机来测试该脚本，而不要假想它会正常工作。
5.6.3 /etc/inittab
某些操作系统支持另一种机制，是/etc/inittab 文件。在这些系统中，init 进程启动和停止基于运行等级的服务。典型的inittab 接口类似如此：
sq:2345nce:/usr/local/squid/sbin/squid –s
使用该接口，init 进程启动squid 一次并且随后忘记它。squid 确认它驻留在运行状态，象前面描述的一样。或者，你能这样做:
sq:2345:respawn:/usr/local/squid/sbin/squid –Ns
这里我们使用了respawn 选项，假如进程不存在init 会重启squid。假如使用respawn，请确认使用-N 选项。
在编辑完inittab 文件后，使用下面的命令来使init 重新读取它的配置文件和启动squid：
# init q
5.7 chroot 环境
某些人喜欢在chroot 环境运行squid。这是unix 的功能，给予进程新的root 文件系统目录。在squid
受安全威胁时，它提供额外等级的安全保护。假如攻击者在某种程度上通过squid获取了对操作系统的访问权，她仅仅能访问在chroot
文件系统中的文件。在chroot 树之外的系统文件，她不可访问。
最容易在chroot 环境里运行squid 的方法是，在squid.conf 文件里指定新的root 目录，如下：
chroot /new/root/directory
chroot()系统调用需要超级用户权限，所以你必须以root 来启动squid。
chroot 环境不是为unix 新手准备的。它有点麻烦，因为你必须在新的root
目录里重复放置大量的文件。例如，假如默认的配置文件正常在/usr/local/squid/etc/squid.conf，并且你使用chroot
指令，那么文件必须位于/new/root/directory/usr/local/squid/etc/squid.conf.你必须将位于$
prefix/etc,$prefix/share,$prefix/libexec 下的所有文件拷贝到chroot
目录。请确认$prefix/var 和cache 目录在chroot 目录中存在和可写。
同样的，你的操作系统需要将大量的文件放在chroot 目录里，例如/etc/resolv.conf
和/dev/null.假如你使用外部辅助程序，例如重定向器（见11 章）或者验证器（见12 章），你也需要来自/usr/lib
的某些共享库。你可以使用ldd 工具来查找给定的程序需要哪些共享库：
% ldd /usr/local/squid/libexec/ncsa_auth
/usr/local/squid/libexec/ncsa_auth:
libcrypt.so.2 =>; /usr/lib/libcrypt.so.2 (0x28067000)
libm.so.2 =>; /usr/lib/libm.so.2 (0x28080000)
libc.so.4 =>; /usr/lib/libc.so.4 (0x28098000)
你可以使用chroot 命令来测试辅助程序：
# chroot /new/root/directory /usr/local/squid/libexec/ncsa_auth
/usr/libexec/ld-elf.so.1: Shared object "libcrypt.so.2" not found
更多的关于chroot 的信息，请见你系统中chroot()的manpage。
5.8 停止squid
最安全的停止squid 的方法是使用squid -k shutdown 命令：
%squid -k shutdown
该命令发送TERM 信号到运行中的squid 进程。在接受到TERM 信号后，squid 关闭进来的套接字以拒收新请求。然后它等待一段时间，用以完成外出请求。默认时间是30 秒，你可以在shutdown_lifetime 指令里更改它。
假如因为某些理由，squid.pid 文件丢失或不可读，squid -k 命令会失败。在此情形下，你可以用ps 找到squid 的进程ID，然后手工杀死squid。例如：
%ps ax |grep squid
假如你看到不止一个squid 进程，请杀死以(squid)显示的那个。例如：
% ps ax | grep squid
294 ?? Is 0:00.01 squid -sD
296 ?? S 0:00.27 (squid) -sD (squid)
% kill -TERM 296
在发送TERM 信号后，你也许想查看日志，以确认squid 已关闭：
% tail -f logs/cache.log
2003/09/29 21:49:30| Preparing for shutdown after 9316 requests
2003/09/29 21:49:30| Waiting 10 seconds for active connections to finish
2003/09/29 21:49:30| FD 11 Closing HTTP connection
2003/09/29 21:49:31| Shutting down...
2003/09/29 21:49:31| FD 12 Closing ICP connection
2003/09/29 21:49:31| Closing unlinkd pipe on FD 9
2003/09/29 21:49:31| storeDirWriteCleanLogs: Starting...
2003/09/29 21:49:32| Finished. Wrote 253 entries.
2003/09/29 21:49:32| Took 0.1 seconds (1957.6 entries/sec).
2003/09/29 21:49:32| Squid Cache (Version 2.5.STABLE4): Exiting normally.
假如你使用squid -k interrupt 命令，squid 立即关闭，不用等待完成活动请求。这与在kill 里发送INT 信号相同。
5.9 重配置运行中的squid 进程
在你了解了更多关于squid 的知识后，你会发现对squid.conf 文件做了许多改动。为了让新设置生效，你可以关闭和重启squid,或者在squid 运行时，重配置它。
重配置运行中的squid 最好的方法是使用squid -k reconfigure 命令：
%squid -k reconfigure
当你运行该命令时，HUP 信号被发送到运行中的squid 进程。然后squid 读取和解析squid.conf 文件。假如操作成功，你可以在cache.log 里看到这些：
2003/09/29 22:02:25| Restarting Squid Cache (version 2.5.STABLE4)...
2003/09/29 22:02:25| FD 12 Closing HTTP connection
2003/09/29 22:02:25| FD 13 Closing ICP connection
2003/09/29 22:02:25| Cache dir '/usr/local/squid/var/cache' size remains unchanged
at 102400 KB
2003/09/29 22:02:25| DNS Socket created on FD 5
2003/09/29 22:02:25| Adding nameserver 10.0.0.1 from /etc/resolv.conf
2003/09/29 22:02:25| Accepting HTTP connections at 0.0.0.0, port 3128, FD 9.
2003/09/29 22:02:25| Accepting ICP messages at 0.0.0.0, port 3130, FD 11.
2003/09/29 22:02:25| WCCP Disabled.
2003/09/29 22:02:25| Loaded Icons.
2003/09/29 22:02:25| Ready to serve requests.
在使用reconfigure 选项时你须谨慎，因为所做的改变可能会导致致命错误。例如，请注意squid 关闭和重新打开进来的HTTP 和ICP 套接字；假如你将http_port 改变为squid 不能打开的端口，它会发生致命错误并退出。
在squid 运行时，某些指令和和选项不能改变，包括：
+ 删除cache 目录（cache_dir 指令）
+ 改变store_log 指令
+ 改变coss cache_dir 的块大小数值。事实上，无论何时你改变了该值，你必须重新初始化coss cache_dir。
+ coredump_dir 指令在重配置过程中不被检查。所以，在squid 已经启动了后，你不能让squid 改变它的当前目录。
solaris 用户在重配置squid 过程中可能遇到其他问题。solaris 的stdio
执行组件里的fopen()调用要求使用小于256 的未用文件描述符。FILE 结构以8
位值存储该文件描述符。正常情况下这不构成问题，因为squid 使用底层I/O（例如open()）来打开cache
文件。然而，在重配置过程中的某些任务使用fopen()，这就有可能失败，因为前面的256 个文件描述符已被分配出去。
5.10 滚动日志文件
除非你在squid.conf 里禁止，squid 会写大量的日志文件。你必须周期性的滚动日志文件，以阻止它们变得太大。squid 将大量的重要信息写入日志，假如写不进去了，squid 会发生错误并退出。为了合理控制磁盘空间消耗，在cron 里使用如下命令：
%squid -k rotate
例如，如下任务接口在每天的早上4 点滚动日志：
0 4 * * * /usr/local/squid/sbin/squid -k rotate
该命令做两件事。首先，它关闭当前打开的日志文件。然后，通过在文件名后加数字扩展名，它重命名cache.log,store.log,和
access.log。例如，cache.log
变成cache.log.0,cache.log.0变成cache.log.1,如此继续，滚动到logfile_rotate 选项指定的值。
squid 仅仅保存每个日志文件的最后logfile_rotate 版本。更老的版本在重命名过程中被删除。假如你想保存更多的拷贝，你需要增加logfile_rotate 限制，或者编写脚本用于将日志文件移动到其他位置。