Nginx文档-初学者指南
2017-07-26 20:21
211 查看
http://www.cnblogs.com/oopsguy/p/7239102.html
原文档: http://nginx.org/en/docs/beginners_guide.html译者:Oopsguy
本指南旨在介绍nginx基本内容和一些在Nginx上可以完成的简单任务。这里假设您已经安装了nginx,否则请参阅安装nginx页面。本指南介绍如何启动、停止nginx和重新加载配置,解释配置文件的结构,并介绍如何设置nginx以提供静态内容服务,如何配置nginx作为代理服务器,以及如何将其连接到一个FastCGI应用程序。
nginx有一个主进程(Master)和几个工作进程(Worker)。主进程的主要目的是读取和评估配置,并维护工作进程。工作进程对请求进行处理。nginx采用了基于事件模型和依赖于操作系统的机制来有效地在工作进程之间分配请求。工作进程的数量可在配置文件中定义,并且可以针对给定的配置进行修改,或者自动调整到可用CPU内核的数量(请参阅worker_processes)。
配置文件决定了nginx及其模块的工作方式。默认情况下,配置文件名为
nginx.conf,并放在目录
/usr/local/nginx/conf,
/etc/nginx或
/usr/local/etc/nginx中。
启动、停止和重新加载配置
要启动nginx,需要运行可执行文件。nginx启动之后,可以通过调用可执行文件附带-s参数来控制它。 使用以下语法:nginx -s 信号
信号可能是以下之一:
stop - 立即关闭
quit - 正常关闭
reload - 重新加载配置文件
reopen - 重新打开日志文件
例如,要等待工作进程处理完当前的请求才停止nginx进程,可以执行以下命令:
nginx -s quit
这个命令的执行用户应该是与启动nginx用户是一致的
在将重新加载配置的命令发送到nginx或重新启动之前,配置文件所做的内容更改将不会生效。要重新加载配置,请执行:
nginx -s reload
一旦主进程(Master)收到要重新加载配置(reload)的信号,它将检查新配置文件的语法有效性,并尝试应用其中提供的配置。如果成功,主进程将启动新的工作进程(Worker),并向旧工作进程发送消息,请求它们关闭。否则,主进程回滚更改,并继续使用旧配置。旧工作进程接收到关闭命令后,停止接受新的请求连接,并继续维护当前请求,直到这些请求都被处理完成之后,旧工作进程将退出。
可以借助Unix工具(如kill工具)将信号发送到nginx进程,信号直接发送到指定进程ID的进程。默认情况下,nginx主进程的进程ID是写入在
/usr/local/nginx/ logs或
/var/run中的nginx.pid文件中。例如,如果主进程ID为1628,则发送QUIT信号让nginx正常平滑关闭,可执行:
kill -s QUIT 1628
获取所有正在运行的nginx进程列表,可以使用
ps命令,如下:
ps -ax | grep nginx
有关向nginx发送信号的更多信息,请参阅控制nginx。
配置文件结构
nginx是由配置文件中指定的指令控制模块组成。指令可分为简单指令和块指令。一个简单的指令是由空格分隔的名称和参数组成,并以分号(;)结尾。块指令具有与简单指令相同的结构,但不是以分号结尾,而是以大括号({和})包围的一组附加指令结尾。如果块指令的大括号内部可以有其它指令,则称这个块指令为上下文(例如:events,
http,
server和
location)。
配置文件中被放置在任何上下文之外的指令都被认为是主上下文。
events和
http指令在主上下文中,
http在
server中,
location又在
server中。
#号之后的行的内容被视为注释。
提供静态内容服务
Web服务器的一个重要任务是提供文件(比如图片或者静态HTML页面)服务。您将实现一个示例,根据请求,将提供来自不同的本地目录的文件:/data/www(可能包含HTML文件)和
/data/images(包含图片)。这需要编辑配置文件,在
http中配置一个包含两个
location块的
server块指令。
http { server { } }
通常,配置文件可以包含几个由监听端口和服务器域名区分的
server块指令。一旦nginx决定由哪个
server来处理请求,它会根据
server块中定义的
location指令的参数来检验请求头中指定的URI。
添加如下
location块指令到
server块指令中:
location / { root /data/www; }
该
location块指令指定“/”前缀与请求中的URI相比较。对于匹配的请求,URI将被添加到根指令中指定的路径,即
/data/ www,以形成本地文件系统上所请求文件的路径。如果有几个匹配上的
location块指令,nginx将选择具有最长前缀的
location块。上面的位置块提供最短的前缀,长度为1,因此只有当所有其它
location块不能匹配时,才会使用该块。
接下来,添加第二个
location指令快:
location /images/ { root /data; }
以
/images/为开头的请求将会被匹配上(虽然
location /也能匹配上此请求,但是它的前缀更短)
最后,
server块指令应如下所示:
server {
location / { root /data/www; }
location /images/ { root /data; }
}
这已经是一个监听标准80端口并且可以在本地机器上通过
http://localhost/地址来访问的有效配置。响应以
/images/开头的URI请求,服务器将从
/data/images目录发送文件。例如,响应
http://localhost/images/example.png请求,nginx将发送
/data/images/example.png文件。如果此文件不存在,nginx将发送一个404错误响应。不以
/ images/开头的URI的请求将映射到
/data/www目录。例如,响应
http://localhost/some/example.html请求,nginx将发送
/data/www/some/example.html文件。
要让新配置立刻生效,如果nginx尚未启动可以启动它,否则通过执行以下命令将重新加载配置信号发送到nginx的主进程:
nginx -s reload
如果运行的效果没有在预期之中,您可以尝试从
/usr/local/nginx/logs或
/var/log/ nginx中的access.log和error.log日志文件中查找原因。
设置一个简单的代理服务器
nginx的一个常见用途是作为一个代理服务器,作用是接收请求并转发给被代理的服务器,从中取得响应,并将其发送回客户端。我们将配置一个基本的代理服务器,它为图片请求提供的文件来自本地目录,并将所有其它请求发送给代理的服务器。在此示例中,两个服务器在单个nginx实例上定义。
首先,通过向nginx的配置文件添加一个
server块来定义代理服务器,其中包含以下内容:
server { listen 8080; root /data/up1; location / { } }
这是一个监听8080端口的简单服务器(以前,由于使用了标准80端口,所以没有指定listen指令),并将所有请求映射到本地文件系统上的
/data/up1目录。创建此目录并将index.html文件放入其中。请注意,
root指令位于
server上下文中。当选择用于处理请求的
location块不包含
root指令时,将使用此
root指令。
接下来,在上一节中的服务器配置基础上进行修改,使其成为代理服务器配置。在第一个
location块中,使用参数指定的代理服务器的协议,域名和端口(在本例中为
http://localhost:8080)放置在proxy_pass指令处:
server {
location / {
proxy_pass http://localhost:8080; }
location /images/ { root /data; }
}
我们将修改使用了
/images/前缀将请求映射到
/data/images目录下的文件的第二个
location块,使其与附带常见的图片文件扩展名的请求相匹配。修改后的
location块如下所示:
location ~ \.(gif|jpg|png)$ { root /data/images; }
该参数是一个正则表达式,匹配所有以.gif,.jpg或.png结尾的URI。正则表达式之前应该是〜。相应的请求将映射到
/data/images目录。
当nginx选择一个
location块来提供请求时,它首先检查指定前缀的
location指令,记住具有最长前缀的
location,然后检查正则表达式。如果与正则表达式匹配,nginx会选择此
location,否则选择更早之前记住的那一个。
代理服务器的最终配置如下:
server {
location / {
proxy_pass http://localhost:8080/; }
location ~ \.(gif|jpg|png)$ { root /data/images; }
}
此
server将过滤以.gif,.jpg或.png结尾的请求,并将它们映射到
/data/images目录(通过向root指令的参数添加URI),并将所有其它请求传递到上面配置的代理服务器。
要使新配置立即生效,请将重新加载配置文件信号(reload)发送到nginx,如前几节所述。
还有更多的指令可用于进一步配置代理连接。
设置FastCGI代理
nginx可被用于将请求路由到运行了使用各种框架和PHP等编程语言构建的应用程序的FastCGI服务器。与FastCGI服务器协同工作的最基本的nginx配置是使用
fastcgi_pass指令而不是
proxy_pass指令,以及
fastcgi_param指令来设置传递给FastCGI服务器的参数。假设FastCGI服务器可以在localhost:9000上访问。以上一节的代理配置为基础,用
fastcgi_pass指令替换
proxy_pass指令,并将参数更改为localhost:9000。在PHP中,
SCRIPT_FILENAME参数用于确定脚本名称,
QUERY_STRING参数用于传递请求参数。最终的配置将是:
server {
location / {
fastcgi_pass localhost:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param QUERY_STRING $query_string;
}
location ~ \.(gif|jpg|png)$ { root /data/images; }
}
这里设置一个
server,将除了静态图片请求之外的所有请求路由到通过FastCGI协议在localhost:9000上运行的代理服务器。
相关文章推荐
- Nginx文档-初学者指南
- nginx 入门文档
- Nginx安装、配置文档
- nginx官方文档笔记4-压缩
- Nginx中文文档
- nginx学习文档之二 配置负载均衡-windows配置负载均衡
- nginx+uwsgi+django+python环境部署文档
- nginx学习文档持续不定期更新
- nginx配置文档,转
- nginx,apache,tomcat配置https的阿里提供的文档
- Nginx下构建nagios监控平台Nagios+nrpe+nagios-plugins+pnp安装文档 推荐
- nginx学习文档之二 配置负载均衡-linux配置负载均衡
- Nginx配置文档详解
- centos 6.6编译安装nginx--来自阿里云帮助文档
- Nginx Image 缩略图 模块#官方文档
- Nginx配置文档说明
- Nginx配置文档具体解释
- Nginx初步学习文档
- Linux CentOS 6.x 开发配置文档 - Nginx
- nginx学习文档之二 配置负载均衡-负载均衡发现的问题