nginx配置文件讲解超详细

原创

xinxinzaiwai12 2013-04-28 10:27:18 博主文章分类：web服务器 ©著作权

©著作权归作者所有：来自51CTO博客作者xinxinzaiwai12的原创作品，请联系作者获取转载授权，否则将追究法律责任

#使用的用户和组(可以只设置用户而已)
user www-data www-data;
#启动进程,通常设置成和cpu的数量相等（一般等于CPU的总核数或者总核数的两倍），每个进程耗费10MB-12MB内存
worker_processes 8;
#指定错误日志存放的路径，错误日志记录级别可选项为：[debug | info | noticd | warn | error | crit]
error_log logs/error.log;
#指定错误日志级别
#error_log logs/error.log notice;
#error_log logs/error.log info;
#指定pid存放的路径，文件内记录当前nginx主进程的ID，kill -HUP 'logs/nginx.pid'

#pid logs/nginx.pid;

#指定文件描述符数量
worker_rlimit_nofile 51200;

#工作模式及连接数上限
events {
use epoll; #提高linux的io操作选项，Linux系统推荐采用epoll模型，FreeBSD系统推荐采用kequeue，linux下建议开启
worker_connections 51200; #允许最大连接数，即单个后台worker process进程的最大并发链接数
}
#设定http服务器，利用它的反向代理功能提供负载均衡支持
http {
#mimie.types 浏览器请求的文件媒体类型，类型由mime.type文件定义
include mime.types;
#用来告诉浏览器请求的文件媒体类型
default_type application/octet-stream;
#设置使用的字符集，如果一个网站有多种字符集，请不要随便设置，应该让程序员在HTML代码中通过Meta标签设置
#charset gb2312;

#日志记录格式
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';

#日志名称，和日志记录格式采用main
#access_log logs/access.log main;

#设定请求缓冲

#保存服务器名字的hash表是由指令server_names_hash_max_size 和server_names_hash_bucket_size所控制的。参数hash bucket size总是等于hash表的大小，并且是一路处理器缓存大小的倍数。在减少了在内存中的存取次数后，使在处理器中加速查找hash表键值成为可能。如果 hash bucket size等于一路处理器缓存的大小，那么在查找键的时候，最坏的情况下在内存中查找的次数为2。第一次是确定存储单元的地址，第二次是在存储单元中查找键值。因此，如果Nginx给出需要增大hash max size 或 hash bucket size的提示，那么首要的是增大前一个参数的大小.

server_names_hash_bucket_size 128;

#用于设置客户端请求的Header头缓冲区大小，大部分情况1KB大小足够。不能超过large_client_header_buffers缓冲区大小的设置
client_header_buffer_size 32k;
#该指令用于设置客户端请求的Header头缓冲区大小，默认值为4KB。
large_client_header_buffers 4 32k;
#设置客户端能够上传的文件大小，默认为1m
client_max_body_size 8m;

#sendfile 指令指定 nginx 是否调用 sendfile 函数（zero copy 方式）来输出文件，对于普通应用，
#必须设为 on,如果用来进行下载等应用磁盘IO重负载应用，可设置为 off，以平衡磁盘与网络I/O处理速度，降低系统的uptime.

sendfile on;
#该指令允许或禁止使用FreeBSD上的TCP_NOPUSH,或者Linux上的TCP_CORK套接字选项。
#tcp_nopush on;

#连接超时时间

#keepalive_timeout 0该指令可以使客户端到服务器端的连接持续有效
keepalive_timeout 60; #客户端到服务器端的连接持续有效时间为60
#该指令允许或禁止使用套接字选项TCP_NODELAY,仅适用于keep-alive连接
tcp_nodelay on;

fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
#该指令用于设置upstream模块等待FastCGI进程发送数据的超时时间，默认值为60s；

fastcgi_read_timeout 200;

#设置FastCGI服务器相应头部的缓冲区

#该指令设置FastCGI服务器相应头部的缓冲区大小。通常情况，该缓冲区大小设置等于fastcgi_buffers指令设置的一个缓冲区的大小。
fastcgi_buffer_size 64k;
#该指令设置了读取FastCGI进程返回信息的缓冲区数量和大小。
fastcgi_buffers 4 64k;

fastcgi_busy_buffers_size 128k;
fastcgi_temp_file_writer_size 128k;
#开启gzip压缩
#开启gzip压缩,对网页文件、css、js、xml等启动gzip压缩，减少数据传输量，提高访问速度。
gzip on;
#该指令允许压缩的页面最小字节数，页面字节数从header头中的Content-Length中进行获取。
gzip_min_length 1k;
#设置系统获取几个单位的缓存用于存储gzip的压缩结果数据流。下面的设置代表16k为单位，按照原始数据大小以16k为单位的4倍申请内存。
gzip_buffers 4 16k;
#识别http的协议版本。
gzip_http_version 1.1;
#gzip压缩比，1 压缩比最小处理速度最快，9 压缩比最大但处理速度最慢（传输快但比较消耗cpu）
gzip_comp_level 2;
#匹配mime类型进行压缩，无论是否指定，“text/html”类型总是会被压缩的。
gzip_types text/plain application/x-javascript text/css application/xml;
gzip_vary on;
#该指令定义了一个数据区，其中记录会话状态信息。定义一个叫“crawler”的记录去，总容量为10MB，以变量$binary_remote_addr作为会话的判断基准（即一个地址一个会话）
#limit_zone crawler $binary_remote_addr 10m;

#允许客户端请求的最大单个文件字节数
client_max_body_size 300m;

#缓冲区代理缓冲用户端请求的最大字节数，可以理解为先保存到本地再传给用户

如果把它设置为比较大的数值，例如256k，那么，无论使用firefox还是IE浏览器，来提交任意小于256k的图片，都很正常。如果注释该指令，使用默认的client_body_buffer_size设置，也就是操作系统页面大小的两倍，8k或者16k，问题就出现了。
无论使用firefox4.0还是IE8.0，提交一个比较大，200k左右的图片，都返回500 Internal Server Error错误

client_body_buffer_size 128k;

#跟后端服务器连接的超时时间_发起握手等候响应超时时间
proxy_connect_timeout 600;

#连接成功后_等候后端服务器响应时间_其实已经进入后端的排队之中等候处理
proxy_read_timeout 600;

#后端服务器数据回传时间_就是在规定时间内后端服务器必须传完所有的数据
proxy_send_timeout 600;

#代理请求缓存区_这个缓存区会保存用户的头信息以供Nginx进行规则处理_一般只要能保存下头信息即可
proxy_buffers 16k;

#同上告诉Nginx保存单个用的几个Buffer最大用多大空间
proxy_buffers 4 32k;

#如果系统很忙的时候可以申请更大的proxy_buffers 官方推荐*2
proxy_busy_buffers_size 64k;

#proxy缓存临时文件的大小
proxy_temp_file_write_size 64k;

#nginx的缓存配置主要使用 proxy_cache模块实现，工作原理就是就用户请求缓存到本地的某个目录下，当再次请求时候，直接读取缓存，从而减轻服务器鸭梨

#缓存 proxy_temp_path和proxy_cache_path必须在同一个分区
proxy_temp_path /data2/proxy_temp_path;
#该指令用于设置缓存文件的存放路径，设置缓存区名称为cache_one ，内存缓存空间大小为200M，自动清除超过1天没有被访问的缓存数据，硬盘缓存空间大小为30GB
proxy_cache_path /data2/proxy_cache_path levels=1:2 keys_zone=cache_one:2000m inactive=1d max_size=30g;

#include指令，使用此指令，可以包含任何你想要包含的配置文件，支持文件名匹配。
#include vhosts/*.conf;
#设定负载均衡的服务器列表
upstream php_server_pool{
#weight=NUMBER ——设置服务器的权重，权重数高被分配访问数越高，默认权重1.
#max_fails=NUMBER——在参数fail_timeout指定的时间内对后端服务器请求失败的次数，如果检测到后端服务器无法连接及发生服务器错误（404错误除外），则标记为失败。默认值为1.设置为0这关闭这项检查
#fail_timeout=TIME——在经历参数max_fails设置的失败次数后，暂停的时间
#down——标记服务器为永久离线状态，用于ip_hash指令
#backup——仅仅在非backup服务器全部繁忙的时候才启动

#upstream模块拥有以下变量：
# $upstream_addr:处理请求的upstream服务器地址
# $upstream_status:upstream服务器的应答状态
# $upstream_response_time:Upstream服务器响应时间（毫秒），多个响应以逗号和冒号分隔。
# $upstream_http_$HEADER:任意的HTTP协议头信息，例如:$upstream_http_host

server 192.168.1.10:80 weight=1 max_fails=2 fail_timeout=30s;
server 192.168.1.11:80 weight=1 max_fails=2 fail_timeout=30s;
server 192.168.1.12:80 weight=1 max_fails=2 fail_timeout=30s;
}

upstream message_server_pool{
#ip_hash指令能够将某个客户端IP的请求通过哈希算法定位到同一台后端服务器。但无法保证后端服务器的负载均衡，所以建议后端服务器能做到session共享来代替nginx的ip_hash方式。
#且如果后端服务器有时要从Nginx负载均衡中摘除一段时间，你必须将其标记为“down”
#ip_hash;
server 192.168.1.13:3245;
server 192.168.1.14:3245 down;
}

upstream bbs_server_pool{
server 192.168.1.15:80 weight=1 max_fails=2 fail_timeout=30s;
server 192.168.1.16:80 weight=1 max_fails=2 fail_timeout=30s;
server 192.168.1.17:80 weight=1 max_fails=2 fail_timeout=30s;
}

#第一个虚拟主机，反向代理php_server_pool这组服务器
server
{
#该指令用于设置虚拟主机监听的服务器地址和端口号。
#listen127.0.0.1:8080;
#listen 8000;
#listen *:8000;
#listen localhost:8000;

listen 80;

#定义使用访问域名

server_name www.yourdomain.com;

#SSL加密浏览
ssl on
ssl_certificate www.yourdomain.com.crt;
ssl_certificate_key www.yourdomain.com.key;

#默认请求

location /

{

root
/root; #定义服务器的默认网站根目录位置

#限制下载速度256KB/秒
limit_rate 256k;
#如果后端的服务器返回502、504、执行超时等错误，自动将请求转发到upstream负载均衡池中的另一台服务器，实现故障转移
proxy_next_upstream http_502 http_504 error timeout invalid_header;
proxy_pass http://php_server_pool;
proxy_set_header Host www.yourdomain.com;
proxy_set_header X-Forwarded-For $remote_addr;
}
#设定本虚拟主机的访问日志

access_log /data1/logs/www.yourdomain.com_access.log;

# 定义错误提示页面
error_page 500 502 503 504 /50x.html;

}

#第二个虚拟主机，反向代理php_server_pool这组服务器
server
{
listen 80;
server_name www1.yourdomain.com;

#访问http://www1.yourdomain.com/message/***地址，反向代理message_server_pool这组服务器
location /
{
proxy_pass http://message_server_pool;
proxy_set_header Host $host;
}

#访问除了/message/之外的http://www1.yourdomain.com/***，反向代理php_server_pool这组服务器
location /message/
{
#DNS解析服务器的IP地址，可以在IE 工具-Internet选项-连接-局域网设置-代理服务器中设置代理服务器IP地址和端口
resolver 8.8.8.8；
#该指令用于设置被代理服务器端口或套接字，以及URI
proxy_pass http://php_server_pool;
#该指令可以设置哪些从后端服务器传送过来的文件被Nginx存储。on保持文件与alias或root指令设置的目录一致，参数off不存储文件
#proxy_store /data/www$original_uri;
proxy_store on;
#该指令用于指定创建文件和目录的权限
proxy_store_access user:rw group:rw all:r;
#指定一个本地目录来缓冲较大的代理请求
proxy_temp_path /data/temp;
#该指令用于在URL和文件系统路径之间实现映射。
alias /data/www;
#该指令允许重新定义或添加Header行道转发给被代理服务器的请求信息中，它的值可以是文本，也可以是变量，或者是文本和变量的组合。
#使用$host变量，它的值相当于服务器的主机名（如果使用域名访问，则该值为域名；如果使用IP访问，则该值为IP）。此外可以将主机名和被代理服务器的端口一起传递 $host:$proxy_port
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr;

}

access_log /data1/logs/www.yourdomain.com_access.log;
}

#第三个虚拟主机
server
{
listen 80;
server_name bbs.yourdomain.com *.bbs.yourdomain.com;

location /
{
proxy_pass http://bbs_server_pool;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr;
#禁止指定的IP地址或者IP段访问某些虚拟主机或目录
#deny 192.168.1.1/24;
#允许指定的IP地址或者IP段访问某些虚拟主机或目录
#allow 192.168.1.0/24;

}

#不记录日志
access_log off;
}
#静态文件，nginx自己处理
location ~ ^/(p_w_picpaths|javascript|js|css|flash|media|static)/ {
root /var/www/virtual/htdocs;
#过期30天，静态文件不怎么更新，过期可以设大一点，如果频繁更新，则可以设置得小一点。
expires 30d;

}

#PHP 脚本请求全部转发到 FastCGI处理. 使用FastCGI默认配置.
location ~ \.php$ {
root /root;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /home/www/www$fastcgi_script_name;
include fastcgi_params;
}

#设定查看Nginx状态的地址
location /NginxStatus {
stub_status on;
access_log on;
auth_basic "NginxStatus";
auth_basic_user_file conf/htpasswd;
}
#禁止访问 .htxxx 文件
location ~ /\.ht {
deny all;
}

}