Nginx配置文件功能注释
最近在学配置Nginx做均衡负载，首先最重要的是Nginx的配置文件，参考网上查到的资料，并结合实践，
将该配置文件的详细功能注释在这里做下笔记，方便今后查阅。
官方的Nginx Wiki(英文) http://wiki.nginx.org/Configuration
环境：FreeBSD8.0+Nginx1.0.10_1
配置文件位置： /usr/local/etc/nginx（所有配置文件都在此文件夹）
可执行文件位置： /usr/local/sbin/nginx
服务所在位置： /usr/local/etc/rc.d/nginx
启动： /usr/local/etc/rc.d/nginx start
停止： /usr/local/etc/rc.d/nginx stop
重启： /usr/local/etc/rc.d/nginx restart
测试配置： /usr/local/etc/rc.d/nginx configtest
重载配置： /usr/local/etc/rc.d/nginx reload
服务状态： /usr/local/etc/rc.d/nginx status
主配置文件nginx.conf注释：
#运行服务的用户及用户组
user www www;
#服务开启的进程数
worker_processes 5;
#全局错误日志及PID文件
error_log logs/error.log notice;
pid logs/nginx.pid;
#限定允许打开的文件的文件描述符长度，包括配置文件、日志文件等，如不指定，则使用操作系统默认值worker_rlimit_nofile 8192;
#工作模式及连接数上限
events {
#工作模式有：
select(标准模式),
poll(标准模式),
kqueue(高效模式，适用FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 and MacOS X), epoll(高效模式，适用Linux 2.6+,SuSE 8.2,),
/dev/poll(高效模式,适用Solaris 7 11/99+,HP/UX 11.22+)
eventport(IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+)
use epoll;
#单个进程允许的最大连接数，总连接数为：worker_processes*worker_connections
worker_connections 1024; }
#设定http服务器，利用它的反向代理功能提供负载均衡支持
http {
#设定配置文件位置，这里的conf是指nginx.conf所在的目录，也可以用绝对路径指定其他地方的配置文件
include conf/mime.types;
include conf/fastcgi.conf;
#默认类型-8进制文件流
default_type application/octet-stream;
#全局首页类型
index index.html index.htm index.php
#设定日志格式
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $bytes_sent '
'"$http_referer" "$http_user_agent" '
'"$gzip_ratio"';
log_format download '$remote_addr - $remote_user [$time_local] '
'"$request" $status $bytes_sent '
'"$http_referer" "$http_user_agent" '
'"$http_range" "$sent_http_content_range"';
#是否激活sendfile()函数，比默认模式更有效率
sendfile on;
#将HTTP响应头压缩到一个包中发送，仅在sendfile开启时才能配合使用
tcp_nopush on;
#指定保存服务器名称的hash表的大小，存在多个域名或虚拟主机时指定
server_names_hash_bucket_size 128;
#设定用户请求header缓冲区大小
client_header_buffer_size 10k;
large_client_header_buffers 4 4k;
#开启gzip模块，要求安装gzip 在运行./config时要指定
gzip on;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain;
output_buffers 1 32k;
postpone_output 1460;
#设定访问日志
access_log logs/access.log main;
client_header_timeout 3m;
client_body_timeout 3m;
send_timeout 3m;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
#设定负载均衡的服务器列表
upstream backserver {
#weigth参数表示权值，权值越高被分配到的几率越大
#本例是指在同一台服务器，多台服务器改变ip即可
server 127.0.0.1:8081 weight=5;
server 127.0.0.1:8082;
server 127.0.0.1:8083;
}
#设定虚拟主机，默认为监听80端口
server {
listen 80;
server_name test.com www.test.com;
charset utf8;
#设定本虚拟主机的访问日志
access_log logs/test.com.log main;
#如果访问 /images/*, /js/*, /css/* 资源，则直接取本地文件，不用转发。
#但如果文件较多效果不是太好。
location ~ ^/(images|js|css)/ {
root /usr/local/testweb;
expires 30m;
}
#对 "/" 启用负载均衡
location / {
proxy_pass http://backserver;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; client_max_body_size 10m;
client_body_buffer_size 128k;
proxy_connect_timeout 90;
proxy_send_timeout 90;
proxy_read_timeout 90;
proxy_buffer_size 4k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_temp_file_write_size 64k;
}
#设定查看Nginx状态的地址,在运行./config 要指定，默认是不安装的。
location /NginxStatus {
stub_status on;
access_log on;
auth_basic "NginxStatus";
#是否要通过用户名和密码访问，测试时可以不加上。
#conf/htpasswd 文件的内容用apache提供的htpasswd工具来产生即可
#auth_basic_user_file conf/htpasswd;
}
}