Nginx配置系统简介


        Nginx的配置系统由一个主配置文件和一些辅助配置文件构成,这些配置文件默认在/usr/local/nginx/ 目录下。

        nginx的配置系统由一个主配置文件和其他一些辅助的配置文件构成。这些配置文件均是纯文本文件,全部位于nginx安装目录下的conf目录下。配置文件中以#开始的行,或者是前面有若干空格或者TAB,然后再跟#的行,都被认为是注释,也就是只对编辑查看文件的用户有意义,程序在读取这些注释行的时候,其实际的内容是被忽略的。由于除主配置文件nginx.conf以外的文件都是在某些情况下才使用的,而只有主配置文件是在任何情况下都被使用的。所以在这里我们就以主配置文件为例,来解释nginx的配置系统。

        在nginx.conf中,包含若干配置项。每个配置项由配置指令和指令参数2个部分构成。指令参数也就是配置指令对应的配置值。

指令概述

        配置指令是一个字符串,可以用单引号或者双引号括起来,也可以不括。但是如果配置指令包含空格,一定要引起来。

指令参数

        指令的参数使用一个或者多个空格或者TAB字符与指令分开。指令的参数有一个或者多个TOKEN串组成。TOKEN串之间由空格或者TAB键分隔。

        TOKEN串分为简单字符串或者是复合配置块。复合配置块即是由大括号括起来的一堆内容。一个复合配置块中可能包含若干其他的配置指令。

        如果一个配置指令的参数全部由简单字符串构成,也就是不包含复合配置块,那么我们就说这个配置指令是一个简单配置项,否则称之为复杂配置项。例如下面这个是一个简单配置项:

#
#
error_page 500 502 503 504 /50x.html;

        对于简单配置,配置项的结尾使用分号结束。对于复杂配置项,包含多个TOKEN串的,一般都是简单TOKEN串放在前面,复合配置块一般位于最后,而且其结尾,并不需要再添加分号。例如下面这个复杂配置项:

#
#
location / {
	root /home/jizhao/nginx-book/build/html;
	index index.html index.htm;
}

指令上下文

        nginx.conf中的配置信息,根据其逻辑上的意义对其进行分类,可以分成多个作用域或指令上下文,指令上下文层次关系如下:

Nginx_http.png

        1 main :Nginx在运行时与具体业务功能无关的参数,比如工作进程数、运行身份等。

        2 http :与提供http服务相关的参数,比如keepalive、gzip等。

        3 server :http服务上支持若干虚拟机,每个虚拟机一个对应的server配置项,配置 项里包含该虚拟机相关的配置。

        4 location :http服务中,某些特定的URL对应的一系列配置项。

        5 mail :实现email相关的SMTP/IMAP/POP3代理时,共享的一些配置项。

        更多配置信息可以参看Nginx安装后的缺省配置文件/usr/local/nginx/nginx.conf.default。

指令上下文,可能有包含的情况出现。

        例如:通常http上下文和mail上下文一定是出现在main上下文里的。在一个上下文里,可能包含另外一种类型的上下文多次。

        例如:如果http服务,支持了多个虚拟主机,那么在http上下文里,就会出现多个server上下文。

#
#
user nobody;
worker_processes 1;
error_log logs/error.log info;
events {
	worker_connections 1024;
}
http {
	server {
		listen 80;
		server_name www.linuxkiss.com;
		access_log logs/linuxkiss.access.log main;
		location / {
			index index.html;
			root /var/www/linuxkiss.com/htdocs;
		}
	}
	server {
		listen 80;
		server_name www.Androidj.com;
		access_log logs/androidj.access.log main;
		location / {
			index index.html;
			root /var/www/androidj.com/htdocs;
		}
	}
}
mail {
	auth_http 127.0.0.1:80/auth.php;
	pop3_capabilities "TOP" "USER";
	imap_capabilities "IMAP4rev1" "UIDPLUS";
	server {
		listen 110;
		protocol pop3;
		proxy on;
	}
	server {
		listen 25;
		protocol smtp;
		proxy on;
		smtp_auth login plain;
		xclient off;
	}
}


存在于main上下文中的配置指令如下:

        1 user

        2 worker_processes

        3 error_log

        4 events

        5 http

        6 mail

存在于http上下文中的指令如下:

        1 server

存在于mail上下文中的指令如下:

        1 server

        2 auth_http

        3 imap_capabilities

存在于server上下文中的配置指令如下:

        1 listen

        2 server_name

        3 access_log

        4 location

        5 protocol

        6 proxy

        7 smtp_auth

        8 xclient

存在于location上下文中的指令如下:

        1 index

        2 root

        当然,这里只是一些示例。具体有哪些配置指令,以及这些配置指令可以出现在什么样的上下文中,需要参考nginx的使用文档。

上一篇 下一篇