配置文件语法

  • 配置由指令和指令块构成
  • 每条指令以;分号结尾，指令与参数间以空格符号分隔
  • 指令块以{}大括号将多条指令组织在一起
  • include语句允许组合多个配置文件以提升可维护性
  • 使用#符号添加注释，提高可读性
  • 使用$符号使用变量
  • 部分指令的参数支持正则表达式

    Nginx配置文件全局变量

    arg_PARAMETER #这个变量包含GET请求中，如果有变量PARAMETER时的值。
    args #这个变量等于请求行中(GET请求)的参数，如：foo=123&bar=blahblah;
    binary_remote_addr #二进制的客户地址。
    body_bytes_sent #响应时送出的body字节数数量。即使连接中断，这个数据也是精确的。
    content_length #请求头中的Content-length字段。
    content_type #请求头中的Content-Type字段。
    cookie_COOKIE #cookie COOKIE变量的值
    document_root #当前请求在root指令中指定的值。
    document_uri #与uri相同。
    host #请求主机头字段，否则为服务器名称。
    hostname #Set to themachine’s hostname as returned by gethostname
    http_HEADER
    is_args #如果有args参数，这个变量等于”?”，否则等于””，空值。
    http_user_agent #客户端agent信息
    http_cookie #客户端cookie信息
    limit_rate #这个变量可以限制连接速率。
    query_string #与args相同。
    request_body_file #客户端请求主体信息的临时文件名。
    request_method #客户端请求的动作，通常为GET或POST。
    remote_addr #客户端的IP地址。
    remote_port #客户端的端口。
    remote_user #已经经过Auth Basic Module验证的用户名。
    request_completion #如果请求结束，设置为OK. 当请求未结束或如果该请求不是请求链串的最后一个时，为空(Empty)。
    request_method #GET或POST
    request_filename #当前请求的文件路径，由root或alias指令与URI请求生成。
    request_uri #包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。不能修改。
    scheme #HTTP方法（如http，https）。
    server_protocol #请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
    server_addr #服务器地址，在完成一次系统调用后可以确定这个值。
    server_name #服务器名称。
    server_port #请求到达服务器的端口号。

    nginx.conf配置文件

    指令介绍
  • worker_processes:nginx进程数，建议设置为等于CPU总核心数.例子:worker_processes 8;
  • error_log：指定全局错误日志定义类型,[ debug | info | notice | warn | error | crit],例子:error_log /var/log/nginx/error.log info;
  • pid:进程文件,例子:pid /var/run/nginx.pid;
  • worker_rlimit_nofile:一个nginx进程打开的最多文件描述符数目，理论值应该是最多打开文件数（系统的值ulimit -n）与nginx进程数相除，但是nginx分配请求并不均匀，所以建议与ulimit -n的值保持一致。例子:worker_rlimit_nofile 65535;
    指令块

  • events：工作模式与连接数上限
    例子:

    1
    2
    3
    4
    5
    6
    7
    events
    {
    　　#参考事件模型，use [ kqueue | rtsig | epoll | /dev/poll | select | poll ]; epoll模型是Linux 2.6以上版本内核中的高性能网络I/O模型，如果跑在FreeBSD上面，就用kqueue模型。
    　　use epoll;
    　　#单个进程最大连接数（最大连接数=连接数*进程数）
    　　worker_connections 65535;
    }

  • http:设定http服务器
    例子:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    http
    {

    	include mime.types; #文件扩展名与文件类型映射表
    	default_type application/octet-stream; #默认文件类型
    	charset utf-8; #默认编码
    	server_names_hash_bucket_size 128; #服务器名字的hash表大小
    	client_header_buffer_size 32k; #上传文件大小限制
    	large_client_header_buffers 4 64k; #设定请求缓
    	client_max_body_size 8m; #设定请求缓
    	sendfile on; #开启高效文件传输模式，sendfile指令指定nginx是否调用sendfile函数来输出#文件，对于普通应用设为 on，如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平
    	#衡磁盘与网络I/O处理速度，降低系统的负载。注意：如果图片显示不正常把这个改成off。
    	autoindex on; #开启目录列表访问，合适下载服务器，默认关闭。
    	tcp_nopush on; #防止网络阻塞
    	tcp_nodelay on; #防止网络阻塞
    	keepalive_timeout 120; #长连接超时时间，单位是秒

    	#FastCGI相关参数是为了改善网站的性能：减少资源占用，提高访问速度。下面参数看字面意思都#能理解。
    	fastcgi_connect_timeout 300;
    	fastcgi_send_timeout 300;
    	fastcgi_read_timeout 300;
    	fastcgi_buffer_size 64k;
    	fastcgi_buffers 4 64k;
    	fastcgi_busy_buffers_size 128k;
    	fastcgi_temp_file_write_size 128k;

    	#gzip模块设置
    	gzip on; #开启gzip压缩输出
    	gzip_min_length 1k; #最小压缩文件大小
    	gzip_buffers 4 16k; #压缩缓冲区
    	gzip_http_version 1.0; #压缩版本（默认1.1，前端如果是squid2.5请使用1.0）
    	gzip_comp_level 2; #压缩等级
    	gzip_types text/plain application/x-javascript text/css application/xml;
    	#压缩类型，默认就已经包含text/html，所以下面就不用再写了，写上去也不会有问题，但是会有#一个warn。
    	gzip_vary on;
    	#limit_zone crawler $binary_remote_addr 10m; #开启限制IP连接数的时候需要使用

    	upstream hongningexpro.github.io {
    		#upstream的负载均衡，weight是权重，可以根据机器配置定义权重。weigth参数表示权
    		#值，权值越高被分配到的几率越大。
    		server 192.168.80.121:80 weight=3;
    		server 192.168.80.122:80 weight=2;
    		server 192.168.80.123:80 weight=3;
    	}
    	#虚拟主机的配置
    	server
    	{

    		listen 80;　　　　#监听端口

    　　　　	server_name aa.cn www.aa.cn ; #server_name end  #域名可以有多个，用空格隔开

    		index index.html index.htm index.php;  # 设置访问主页

    　　　　	set $subdomain '';  # 绑定目录为二级域名 bbb.aa.com  根目录 /bbb  文件夹
    　　　　	if ( $host ~* "(?:(\w+\.){0,})(\b(?!www\b)\w+)\.\b(?!(com|org|gov|net|cn)\b)\w+\.[a-zA-Z]+" ) { set $subdomain "/$2"; }

    		root /home/wwwroot/aa.cn/web$subdomain;# 访问域名跟目录  

    		include rewrite/dedecms.conf; #rewrite end   #载入其他配置文件


    		location ~ .*.(php|php5)?$
    		{
    　　			fastcgi_pass 127.0.0.1:9000;
    　　			fastcgi_index index.php;
    　　			include fastcgi.conf;
    		}
    		#图片缓存时间设置
    		location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
    		{
    　　			expires 10d;
    		}
    		#JS和CSS缓存时间设置
    		location ~ .*.(js|css)?$
    		{
    		　　expires 1h;
    		}

    	}

    	#日志格式设定	
    	log_format access '$remote_addr - $remote_user [$time_local] "$request" '
    	'$status $body_bytes_sent "$http_referer" '
    	'"$http_user_agent" $http_x_forwarded_for';
    	#定义本虚拟主机的访问日志
    	access_log /var/log/nginx/test.log access;
    	
    	#对 "/" 启用反向代理
    	location / {

    		proxy_pass http://127.0.0.1:88;
    		proxy_redirect off;
    		proxy_set_header X-Real-IP $remote_addr;
    		#后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
    		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    		#以下是一些反向代理的配置，可选。
    		proxy_set_header Host $host;
    		client_max_body_size 10m; #允许客户端请求的最大单文件字节数
    		client_body_buffer_size 128k; #缓冲区代理缓冲用户端请求的最大字节数，
    		proxy_connect_timeout 90; #nginx跟后端服务器连接超时时间(代理连接超时)
    		proxy_send_timeout 90; #后端服务器数据回传时间(代理发送超时)
    		proxy_read_timeout 90; #连接成功后，后端服务器响应时间(代理接收超时)
    		proxy_buffer_size 4k; #设置代理服务器（nginx）保存用户头信息的缓冲区大小
    		proxy_buffers 4 32k; #proxy_buffers缓冲区，网页平均在32k以下的设置
    		proxy_busy_buffers_size 64k; #高负荷下缓冲大小（proxy_buffers*2）
    		proxy_temp_file_write_size 64k;
    		#设定缓存文件夹大小，大于这个值，将从upstream服务器传
    	
    	}
    	
    	#设定查看Nginx状态的地址
    	location /NginxStatus {

    		stub_status on;
    		access_log on;
    		auth_basic "NginxStatus";
    		auth_basic_user_file conf/htpasswd;
    		#htpasswd文件的内容可以用apache提供的htpasswd工具来产生。
    	
    	}
    	#本地动静分离反向代理配置
    	#所有jsp的页面均交由tomcat或resin处理
    	location ~ .(jsp|jspx|do)?$ {

    		proxy_set_header Host $host;
    		proxy_set_header X-Real-IP $remote_addr;
    		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    		proxy_pass http://127.0.0.1:8080;
    	
    	}
    	#所有静态文件由nginx直接读取不经过tomcat或resin
    	location ~ .*.(htm|html|gif|jpg|jpeg|png|bmp|swf|ioc|rar|zip|txt|flv|mid|doc|ppt|pdf|xls|mp3|wma)$
    	{　　 expires 15d;　　 }
    	location ~ .*.(js|css)?$
    	{ 　　expires 1h;　　 }
    }