Nginx文档-初学者指南

原文档： 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上运行的代理服务器。