nginx 初学者指引

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 的服务器上。