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; 

 } 

}

---

#使用小号
  user  nobody;
  #开启进程数
  worker_processes  8;
  #制定进程到cpu（四cpu：0001 0010 0100 1000）
  worker_cpu_affinity 0001 0010 0100 1000 0001 0010 0100 1000;
  #每个进程最大打开文件数
  worker_rlimit_nofile 10240;
  #进程号保存文件
  pid        logs/nginx.pid;
  events {
  #使用epoll（linux2.6的高性能方式）
  use epoll;
  #每个进程最大连接数（最大连接=连接数x进程数）
  worker_connections  10240;
  }
  http {
  #文件扩展名与文件类型映射表
  include       mime.types;
  #默认文件类型
  default_type  text/html;
  #日志文件格式
  log_format  main  ’$remote_addr – $remote_user [$time_local] $request ‘
  ‘”$status” $body_bytes_sent “$http_referer” ‘
  ‘”$http_user_agent” “$http_x_forwarded_for”‘;
  #日志文件
  access_log  /dev/null;
  #长链接超时时间
  keepalive_timeout  30;
  #打开gzip压缩
  gzip  on;
  #最小压缩文件大小
  gzip_min_length  1000;
  #压缩缓冲区
  gzip_buffers     4 8k;
  #压缩类型
  gzip_types       text/* text/css application/javascript application/x-javascript;
  #压缩比率
  gzip_comp_level  9;
  #压缩通过代理的所有文件
  gzip_proxied     any;
  #vary header支持
  gzip_vary        on;
  #压缩版本（默认1.1，前端为squid2.5使用1.0）
  gzip_http_version 1.0;
  #输出缓冲区
  output_buffers   4 32k;
  #输出拆包大小
  postpone_output  1460;
  #接收header的缓冲区大小
  client_header_buffer_size 128k;
  large_client_header_buffers 4 256k;
  #客户端发送header超时
  client_header_timeout  1m;
  #客户端发送内容超时
  client_body_timeout    1m;
  #发送到客户端超时
  send_timeout           1m;
  #开启高效文件传输模式
  sendfile                on;
  #捕捉代理端的http错误
  #proxy_intercept_errors  on;
  #默认编码
  charset GBK;
  #默认域名（不能访问）
  server {include port.conf;server_name null;location / {root /dev/null;log_not_found off;}}
  #嵌套upstream.conf
  include upstream.conf;
  #嵌套servers/*.com;
  include servers/*.com;
  include servers/*.net;
  include servers/*.org;
  include servers/*.com.cn;
  include servers/*.cn;
  }