作者：lownr
日期：2003/04/10
--------------------------------------------------
摘要：
通过带宽控制模块，控制通过 apache 进行下载的流量。
--------------------------------------------------
环境：
FreeBSD 4.7
gcc 2.95.4
apache 1.3.27
mod_bandwidth 2.0.4
--------------------------------------------------
步骤
1、下载模块 mod_bandwidth
ftp://ftp.cohprog.com/pub/apache/module/
2、编译和安装
a) 编译：
由于 apache 是用编译好的包安装的，因此只有采用 apxs 方式编译
/usr/local/sbin/apxs -c mod_bandwidth.c -o /usr/local/libexec/apache/mod_bandwidth.so
b) 创建 mod_bandwidth 运行需要的目录：
mkdir /tmp/apachebw
mkdir /tmp/apachebw/link
mkdir /tmp/apachebw/master
chmod -R 777 /tmp/apachebw
c) 修改 /usr/local/etc/apache/httpd.conf 文件：
c.1) 增加下列内容
LoadModule bandwidth_module libexec/apache/mod_bandwidth.so
AddModule mod_bandwidth.c
注意：这两行必须分别加在相应区域的最前面，使得这个模块以最低的优先级运行。
c.2) 增加下列内容
<IfModule mod_bandwidth.c>
BandWidthDataDir "/tmp/apachebw/"
BandWidthModule on
</IfModule>
c.3) 修改 <Directory> 的设置
<Directory />
# 不限制局域网内用户的下载速度
BandWidth 192.168.0 0
# 限制其他用户的下载速度为每秒 8192 字节
BandWidth all 8192
....
</Directory>
按照上面的方式修改其他 <Directory> 小节
d) 重新启动 apache：
apachectl configtest
apachectl restart
--------------------------------------------------
mod_bandwidth 的选项简单说明：
..............................
BandWidthDataDir
格式： BandWidthDataDir <目录>
默认： "/tmp/apachebw"
上下文： server config
设置 mod_bandwidth 保存运行时数据的目录。需要在该目录下创建 ./master
和 ./link 两个子目录，并设置为权限为 777。
注意：有些系统会定时清理 /tmp 目录，所以在这些系统上最好把
BandWidthDataDir 设置到其他地方。
..............................
BandWidthModule
格式： BandWidthModule <On|Off>
默认： Off
上下文： per server config
允许或者禁止模块。
..............................
BandWidthPulse
格式： BandWidthPulse <毫秒（千分之一秒>
默认： 1000
上下文： per server config
改变计算带宽的时间间隔，默认为1000毫秒（1秒）。使用更低的间隔可以获得
更精确的带宽控制，但消耗更多的CPU时间，反之亦然。
注意：这个选项的详细说明请参考 mod_bandwidth 的文档。
..............................
BandWidth
格式： BandWidth <domain|ip|all> <速率>
默认： 无
上下文： per directory, .htaccess
限制这个目录下文件下载的速率。
domain 指定来自哪个域的连接受到这个设置的影响。
ip 指定来自哪个ip地址（或者ip段）的连接受到影响。
all 所有连接都受到影响。
示例：
<Directory />
# 来自 dualface.com 的连接不限制下载速度
BandWidth dualface.com 0
# 来自 192.168.0.0/16（或者192.168.0） 网段的连接不限制下载速度
BandWidth 192.168.0.0/16 0
# 其他连接限制下载速度为每秒1024字节
BandWidth all 1024
# 越前面的设置优先权越高
</Directory>
..............................
LargeFileLimit
格式： LargeFileLimit <文件大小> <速率>
默认： 无
上下文： per directory, .htaccess
对于超过指定大小的文件，下载时使用的速率。如果速率设置0即不限制速度，
但下载速度仍然要受到BandWidth设置的影响。如果设置成-1，则完全不受影响。
通过设置不同的文件大小和速率，可以设置不同大小范围内文件的下载速度。
示例：
# 文件尺寸大于等于200千字节的文件，下载速率为每秒3072字节
LargeFileLimit 200 3072
LargeFileLimit 1024 2048
..............................
MaxConnection
格式： MaxConnection <连接数>
默认： 0 （不限制）
上下文： per directory, .htaccess
当超过指定连接数时，拒绝新的连接。
..............................
MinBandWidth
格式： MinBandWidth <domain|ip|all> <速率>
默认： all 256
上下文： per directory, .htaccess
设置最小带宽，默认为每秒256字节。根据BandWidth和LargeFileLimit设置的速
率。mod_bandwidth会计算允许的连接数。例如BandWidth为4096字节，而
MinBandWidth为1024字节，则最大并发连接数为4。
注意：这个选项的详细说明请参考 mod_bandwidth 的文档。
--------------------------------------------------
参考资料：
mod_bandwidth documents
