文档章节

nginx 初学者指引

guli3057
 guli3057
发布于 2016/06/28 17:52
字数 2897
阅读 720
收藏 96

nginx 初学者指引
==================

编译自:
http://nginx.org/en/docs/beginners_guide.html


目录:
    nginx 启动、停止、重新加载配置
    nginx 配置文件的结构
    nginx 提供静态内容的服务
    将 nginx 配置为简单的代理服务器
    nginx 设置 FastCGI 代理,连接 FastCGI 应用


本文会简单介绍 nginx 并演示相关的简单任务。首先你需要安装好 nginx。

nginx 拥有一个主进程和几个 worker 进程。主进程的主要工作是读取和处理配置,维护 worker 进程。worker 进程负责处理实际的用户请求。nginx 采用 event-based 模型和 OS-dependent 机制对用户请求进行高效的分发。worker 进程的数量在配置文件中定义,可在配置中修改,或者根据可用的 CPU 核心数进行自动调整。

参考 http://nginx.org/en/docs/ngx_core_module.html#worker_processes
    
    Syntax:    worker_processes number | auto;
    Default:     worker_processes 1;
    Context:    main
    Defines the number of worker processes.

    worker 进程的最佳个数受许多因素影响,比如 CPU 核心数,磁盘驱动的个数,nginx 负载模式等。如果不确定设为多少合适,可设置为 CPU 核心数。如果设置为 auto,nginx 会尝试自动检测CPU核心数并设置为 worker 进程数。(auto 参数从 1.3.8 和 1.2.5 版开始支持)

nginx 及其模块的工作由配置文件定义,默认的配置文件为 nginx.conf,该配置文件可能位于:
/usr/local/nginx/conf, /etc/nginx, or /usr/local/etc/nginx.

 

nginx 启动、停止、重新加载配置
-------------------------------

执行 nginx 命令启动 nginx。启动 nginx 之后,可使用如下命令:
 

    nginx -s stop  快速关闭 nginx
    nginx -s quit  优雅的关闭 nginx
    nginx -s reload  重新加载配置
    nginx -s reopen  重新打开日志文件


    

优雅地关闭 nginx,这是说 nginx 主进程会等待 worker 进程完成当前用户请求的处理。
执行:nginx -s quit (以启动 nginx 时的用户身份执行该命令)

更改配置之后,必须执行重新加载配置的命令,或者重新启动 nginx,以使得配置生效:

nginx -s reload 

    
当主进程接收到 reload 信号,它会检查配置文件的语法,然后尝试应用该配置。如果成功,主进程启动新的 worker 进程,并发送消息给原来的 worker 进程要求他们关闭。如果加载配置失败,主进程会对改动进行回滚,继续以原来的配置进行工作。当原来的 worker 进程接收到消息要他们关闭,他们会停止接收新的连接,并继续处理当前的请求直到完成。完成之后,原来的 worker 进程将会退出。

给 nginx 发送信号,可借助于 kill 命令。kill 命令使用进程 pid 发送信号。nginx 主进程的 pid 存储在pid 文件中,默认为 nginx.pid,位于 /usr/local/nginx/logs 或 /var/run 目录下。

例如,如果 nginx 主进程 pid 为 1628,使用 kill 命令发送 QUIT 信号给 nginx,使其优雅地关闭:

    kill -s QUIT 1628

    
如果要获取所有运行中的 nginx 进程的列表,使用 ps 命令:

    ps -ax | grep nginx

    

关于发送信号给 nginx 的更多信息,请参考:http://nginx.org/en/docs/control.html

 

配置文件的结构
-------------------

nginx 由许多模块组成,这些模块可在配置文件中进行配置。nginx 的配置指令分为:简单配置指令,区块配置指令。

简单配置指令由 “名称” 和 “参数” 组成, “名称” 和 “参数” 以空格分隔,指令的最后以分号 “;” 为结尾。

区块配置指令和简单配置指令拥有同样的结构,区块指令不以分号结尾。区块指令使用花括号 “{}” 将一组设置包含于其中。如果在区块指令的括号中包含其他指令,这个区块指令就被称为 “context” (上下文)。例如 events,http,server,location 指令。

所有在 context 之外的指令,被认为处于 main context 之中。

events 和 http 指令用于 main context 之中。

server 指令用于 http 之中。

location 指令用于 server 指令之中。

配置文件中以 # 起始的行为注释行。

 

nginx 提供静态内容的服务
---------------------------

web 服务器的重要任务之一是提供文件服务(比如 image 文件、静态 HTML 页面等)。
我们将实现一个示例,根据请求的不同,nginx 通过不同的目录提供文件给用户。我们通过
/data/www 目录提供 HTML 文件,通过 /data/images 目录提供 image 文件。

为达到这个目标,需要在配置文件中设置 server 区块,并在 server 区块中设置两个 location 区块。server 区块位于 http 区块之中。首先,创建 /data/www 目录,并在其中创建 index.html 文件,文件内容任意,比如:

    echo "<h1>HTML File</h1>" > /data/www/index.html

然后创建 /data/images 目录,放一些图像文件到该目录中。之后打开配置文件。默认的配置文件已经包含一些 server 区块的示例,大多数被注释了。
现在将所有 server 区块注释掉,然后创建一个新的 server 区块:
  

    http {
        server {
        }
    }

一般来说,配置文件可能包含几个 server 区块,它们拥有不同的监听端口和 server name。
一旦 nginx 决定好使用哪一个 server 处理用户请求,nginx 测试请求首部的 URI 字段,
将它与 server 区块中的 location 指令定义的参数进行对比。

在 server 区块中添加如下 location 区块:
    
 

   location / {
        root /data/www;
    }

这个 location 区块指定 “/” 前缀,并将它和请求首部中的 URI 进行比较。对于匹配的请求,
URI 将被添加到 root 指令所指定的路径的末尾,这里 root 指令定义的路径是 /data/www,
这样形成用户所请求的文件的本地路径。如果有多个 location 区块与请求的 URI 匹配,nginx
选择其中前缀最长的那个 location 区块。

这里的 location 提供了最短的前缀,长度为 1,所以只有当所有其他 location 区块都匹配失败,
才会选择这个 location 区块。

下一步,添加第二个 location 区块:

    location /images/ {
        root /data;
    }


这个 location 区块能够匹配 URI 以 /images/ 起始的请求 (location / 也能匹配这样的请求,但它的
前缀比 /images/ 短,所以优先匹配 location /images/)

我们的 server 区块的配置是这样的:

    server {
        location / {
            root /data/www;
        }

        location /images/ {
            root /data;
        }
    }


这已经是一个可工作的服务配置,nginx 监听于 80 端口,可通过本地访问 http://localhost/ 。
对于 URI 以 /images/ 起始的请求,nginx 会将 /data/images 目录中的文件发送给客户端。

例如,对于访问请求:http://localhost/images/example.png,nginx 会发送 /data/images/example.png 文件。如果这个文件不存在,nginx 会发送 404 error 响应给客户端。

对于 URI 不是以 /images/ 起始的请求,会被映射到 /data/www 目录。
例如,对于访问请求:http://localhost/some/example.html,nginx 会发送 /data/www/some/example.html 文件。

修改了配置文件之后,为使新配置生效,可重启 nginx ,或者使用 nginx 命令发送 reload 信号给 nginx 主进程:

    nginx -s reload

    
    Note:
    当出现了错误,请查看 access.log 和 error.log 文件寻找可能的原因。
    这两个文件的位置如果是 yum 安装,在 /var/log/nginx 目录下,如果是编译安装,
    默认在 prefix/logs/ 目录下。

 

将 nginx 配置为简单的代理服务器
--------------------------------

nginx 经常被用来设置成一个代理服务器,这时 nginx 接收请求,然后将请求转发给被代理的后端服务器,并从后端服务器取回响应报文,然后发送给客户端。

我们将配置一个基础的代理服务器,服务器对于 image 文件的请求选择从本地响应,对于其他请求,服务器转发给一个后端服务器。在这个示例中,这两个服务器将被定义在同一个 nginx 实例之上。首先定义后端服务器,添加一个 server 区块定义:
    

server {
        listen 8080;
        root /data/up1;

        location / {
        }
    }


    
这个服务器监听在 8080 端口(在前一小节的配置中,我们并没有指定 listen 指令,nginx 默认使用 80 端口),并将所有请求映射到本地的 /data/up1 目录中。创建 /data/up1 目录,并在其中创建一个 index.html 文件。注意 root 指令被放置于 server context 中,这样只有当一个没有包含自己的 root 指令的 location 区块被选中时,这个 server 区块中的 root 指令才会被使用。

[root@lamp1 nginx]# mkdir /data/up1
[root@lamp1 nginx]# echo "<h1>backend server</h1>" > /data/up1/index.html


下一步,沿用前一小节的配置,将其修改为一个代理服务器的配置。在第一个 locaiton 区块中加入 proxy_pass 指令,指定后端服务器的:协议、主机名、端口(本例中,指定为 http://localhost:8080):
    

    server {
        location / {
            proxy_pass http://localhost:8080/;
        }

        location /images/ {
            root /data;
        }
    }

我们将修改第二个 location 区块,目前这个 location 区块将 URI 以 /images/ 起始的请求映射到
/data/images 目录。将其修改为能够匹配对于典型图像文件的请求,这些图像文件有典型的后缀名:

    location ~ \.(gif|jpg|png)$ {
        root /data/images;
    }

在 “location ~ \.(gif|jpg|png)$” 语句中, ~ EXPRESSION 表示使用正则表达式匹配,
正则表达式为:\.(gif|jpg|png)$。

这个正则表达式能够匹配所有以 .gif, .jpg, .png 结尾的 URI。匹配的请求将被映射到 /data/images 目录中。

当 nginx 选择以哪个 location 区块匹配请求时,nginx 首先检查指定了 prefix 前缀的 location 指令,nginx 会记住被匹配的拥有最长 prefix 的 location 指令,然后开始检查正则表达式。
如果有一个正则表达式被匹配了,nginx 会选择这个正则表达式的 location,如果没有正则表达式被匹配,它选择之前记下的那个拥有最长前缀的 location。

最终我们的配置文件是这样的:

    server {
        location / {
            proxy_pass http://localhost:8080/;
        }

        location ~ \.(gif|jpg|png)$ {
            root /data/images;
        }
    }

nginx 服务器会过滤以 .gif, .jpg, .png 为结尾的 URI 的请求,将它们映射到 /data/images 目录中(将 URI 添加到 root 指令的参数后面),并将其他请求转发给后端服务器。

使新的配置生效,执行 nginx -s reload。

在另一个 Linux 虚拟机中测试访问:

[root@vm1 nginx]# curl http://192.168.0.171
<h1>backend server</h1>


    
在浏览器中访问:
http://192.168.0.171/p1035007771.jpg

关于配置代理连接,更深入的探讨可参考:

http://nginx.org/en/docs/http/ngx_http_proxy_module.html

 

设置 FastCGI 代理
------------------------

nginx 可用于将请求路由到 FastCGI 服务器,在 FastCGI 服务器上运行着以各种框架和编程语言构建的应用,比如 PHP。

配置 nginx 与 FastCGI 服务器协同工作,最基础的配置包括:使用 fastcgi_pass 指令替代 proxy_pass指令,并使用 fastcgi_param 指令设置传递给 FastCGI 服务器的参数。

假设 FastCGI 服务器可通过 localhost:9000 访问,我们以前面的配置为基础,首先将 proxy_pass 指令替换为 fastcgi_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;
        }
    }

通过这个配置,对于静态图形文件的请求由本地服务响应,除此之外的请求将通过 FastCGI 协议
被路由到工作于 localhost:9000 的服务器上。

 

 

© 著作权归作者所有

guli3057
粉丝 6
博文 31
码字总数 21074
作品 0
渝中
运维
私信 提问
加载中

评论(2)

一个菜鸟
一个菜鸟
Roders
Roders
很通俗易懂啊
android初学者,学习前疑问?

android初学者,我想请教一个各位一个问题,麻烦大家回答一下,指引我让我走太多的弯路。 1、android 开发用什么框架开发效率最高或相对高。 2、开发时候用的工具集(IDE,常规是Eclipse)哪...

深爱着你们
2014/12/10
220
4
Phabricator配置向导

配置向导 该文档包含了Phabricator所需的最基本的配置指引。 前提 该文档假定你已经安装了所有必需的组件。如果没有,请查看安装向导。 下一步: 配置你的webserver(Apache,nginx或lighttp...

悠悠客
2013/05/02
0
2
Cengos5下安装Nginx服务器

本文为Centos5下安装Nginx提供指引,按下面的步骤完成安装过程: 1、设置nginx的yum repository,下载对应的RPM安装包,并安装; 下载RPM包: wget http://nginx.org/packages/centos/5/noar...

彭苏云
2013/03/09
0
0
给大家介绍一本开发的书

一本仍然在创作中的关于开源和软件开发的图书--《利用开源项目,学习软件开发》可以下载阅读了,国内社区合力创作,内容涵盖如何从一个开源项目入手,循序渐进的学习开发,乃至有详尽的“H...

Foundation
2015/11/23
134
0
nginx与mogilefs配置搭建分布式文件存储

这里有人知道如何在nginx中配置mogilefs吗,能在windows中实现吗,资料介绍mogilefs是运行在linux上的,但老大说nginx中有mogilefs模块只需稍加配置就可以,我找了两天还没找到相关的解决方案...

hebeijpp
2012/07/16
2.1K
1

没有更多内容

加载失败,请刷新页面

加载更多

IPv4如何转换为IPv6?

导读 ipv6已经逐渐在应用,现在已经有很多的运营商支持ipv6,前天我们也发布了如何让电脑使用ipv6地址?有很多朋友在问?ipv6有什么作用,它的表示方式是什么,今天我们来一起来详细了解下ipv...

问题终结者
13分钟前
1
0
SpringBoot2.0高级案例(05):整合 Swagger2 ,构建接口管理界面

一、Swagger2简介 1、Swagger2优点 整合到Spring Boot中,构建强大RESTful API文档。省去接口文档管理工作,修改代码,自动更新,Swagger2也提供了强大的页面测试功能来调试RESTful API。 2、...

知了一笑
25分钟前
4
0
关于观察者模式总结

观察者模式(发布订阅模式):在对象之间定义一对多的依赖,这样一来,当一个对象改变状态,依赖他的对象都会收到通知,并自动更新。 使用场景:当一个对象状态改变同时需要改变其他对象,且...

cherryboy
31分钟前
1
0
Gradle Sync太慢?你需要使用阿里云仓库服务的代理仓库地址代替jcenter()、maven

在天朝使用jcenter、mavenCentral及google三个远程仓库,Gradle Sync会很慢,goole仓库甚至需要科学上网才能访问。为了加快Gradle Sync速度,一招教你优先用 阿里云仓库服务 的仓库作为下载源...

丁佳辉
44分钟前
2
0
maven打包后运行提示“没有主清单属性”的解决办法

在项目的pom.xml文件里添加如下内容: <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>m......

shatian
46分钟前
5
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部