nginx 初学者指南

学习论坛：https://nginx.org/en/docs/beginners_guide.html
nginx 初学者指南 nginx 初学者指南

1. 启动，停止和重新加载配置

2. 配置文件的结构

3. 服务于静态内容

4. 设置简单的代理服务器

5. 设置FastCGI代理

   本指南对nginx进行了基本介绍，并描述了一些可以使用它完成的简单任务。假设已经在阅读器的计算机上安装了nginx。如果不是，请参阅“ 安装nginx”页面。本指南描述了如何启动和停止nginx以及重新加载其配置，解释了配置文件的结构，并描述了如何设置nginx以提供静态内容，如何将nginx配置为代理服务器以及如何将其与FastCGI应用程序。

   nginx有一个主进程和几个工作进程。主流程的主要目的是读取和评估配置，以及维护工作流程。工作进程对请求进行实际处理。nginx使用基于事件的模型和依赖于操作系统的机制来有效地在工作进程之间分配请求。工作进程的数量在配置文件中定义，可以针对给定的配置固定，也可以自动调整为可用CPU内核的数量（请参阅 worker_processes）。

   nginx及其模块的工作方式在配置文件中确定。默认情况下，该配置文件被命名nginx.conf ，并放入目录 /usr/local/nginx/conf， /etc/nginx或 /usr/local/etc/nginx。

启动，停止和重新加载配置

要启动nginx，请运行可执行文件。一旦启动nginx，就可以通过使用-s参数调用可执行文件来对其进行控制。使用以下语法：

nginx -s signal
其中信号可能是以下之一：

stop — 快速关机
quit — 正常关机
reload — reloading the configuration file
reopen — 重新打开日志文件
例如，要在等待工作进程完成对当前请求的服务的过程中停止nginx进程，可以执行以下命令：

nginx -s quit

此命令应在启动nginx的同一用户下执行。
在重新加载配置的命令发送到nginx或重新启动它之前，不会应用对配置文件所做的更改。要重新加载配置，请执行：

nginx -s reload

一旦主进程接收到重新加载配置的信号，它将检查新配置文件的语法有效性，并尝试应用其中提供的配置。如果成功，则主进程将启动新的工作进程，并将消息发送到旧的工作进程，要求它们关闭。否则，主进程将回滚所做的更改，并继续使用旧配置。旧的工作进程接收到关闭命令，停止接受新的连接并继续为当前请求提供服务，直到为所有此类请求提供服务为止。之后，旧的工作进程退出。

也可以借助Unix工具（如kill实用程序）将信号发送到nginx进程。在这种情况下，将信号直接发送给具有给定进程ID的进程。默认情况下，nginx主进程的进程ID写入 nginx.pid目录 /usr/local/nginx/logs或中的 /var/run。例如，如果主进程ID为1628，要发送导致NGINX正常关闭的QUIT信号，请执行：

kill -s QUIT 1628

为了获取所有正在运行的nginx进程的列表，ps 可以使用该实用程序，例如，通过以下方式使用：

ps -ax | grep nginx

有关将信号发送到nginx的更多信息，请参见 控制nginx。

配置文件的结构
nginx由受配置文件中指定的指令控制的模块组成。伪指令分为简单伪指令和块伪指令。一个简单的指令由名称和参数组成，这些名称和参数之间用空格分隔，并以分号（;）结尾。块指令的结构与简单指令的结构相同，但是它以分号（而不是分号）结尾，并带有一组用括号（{和}）括起来的附加指令。如果块指令在花括号内可以有其他指令，则称为上下文（示例： events， http， server和 location）。

放置在任何上下文外部的配置文件中的指令都被视为在 主上下文中。在events和http指令驻留在main上下文server 中http，并location在 server。

#符号 后的其余行被视为注释。

提供静态内容
Web服务器的一项重要任务是分发文件（例如图像或静态HTML页面）。您将实现一个示例，其中根据请求，文件将从不同的本地目录提供：（/data/www 可能包含HTML文件）和/data/images （包含图像）。这将需要编辑配置文件，并 在 带有两个位置块的http块内设置 服务器块。

首先，创建/data/www目录并在其中放置index.html包含任何文本内容的 文件，然后创建/data/images目录并在其中放置一些图像。

接下来，打开配置文件。默认配置文件已经包含该server块的几个示例，大部分已被注释掉。现在注释掉所有这样的块并开始一个新 server块：

http {
    server {
    }
}

通常，配置文件可以包括几个server块，这些 块 通过它们侦听的端口和服务器名称来 区分。一旦nginx决定了哪个处理请求，它就会根据块内定义的指令 的参数测试在请求标头中指定的URI 。 serverlocationserver

将以下location块添加到该 server块：

location / {
    root /data/www;
}

与请求中的URI相比， 此location块指定“ /”前缀。对于匹配的请求，会将URI添加到root 指令中指定的路径 ，即添加到/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/。响应以开头的URI请求/images/，服务器将从/data/images目录中发送文件。例如，响应 http://localhost/images/example.png请求，nginx将发送/data/images/example.png文件。如果该文件不存在，nginx将发送一个指示404错误的响应。URI不以开头的请求/images/将被映射到/data/www目录中。例如，响应 http://localhost/some/example.html请求，nginx将发送/data/www/some/example.html文件。

要应用新配置，请启动尚未启动reload的nginx，或通过执行以下命令将信号发送到nginx的主进程：

nginx -s reload

万一某些功能无法正常工作，您可以尝试在目录或中 查找原因access.log和 error.log文件 。
/usr/local/nginx/logs/var/log/nginx

设置简单的代理服务器
nginx的一种常用用法是将其设置为代理服务器，这意味着服务器可以接收请求，将请求传递给代理服务器，从请求中检索响应并将它们发送给客户端。

我们将配置一个基本的代理服务器，该服务器为图像请求和本地目录中的文件提供服务，并将所有其他请求发送到代理服务器。在此示例中，两个服务器都将在单个nginx实例上定义。

首先，通过向server nginx的配置文件添加一个以下内容来定义代理服务器：

server {
    listen 8080;
    root /data/up1;

    location / {
    }
}

这将是一个简单的服务器，它侦听端口8080（以前，listen由于使用了标准端口80 ，因此未指定伪指令）并将所有请求映射到/data/up1本地文件系统上的目录。创建此目录并将index.html文件放入其中。请注意，该root指令位于 server上下文中。这样root，当指令用于 location选择用于服务请求块不包括自己的root指令。

接下来，使用上一部分中的服务器配置并对其进行修改以使其成为代理服务器配置。在第一个location块中，将 proxy_pass 指令与参数中指定的代理服务器的协议，名称和端口（在本例中为http://localhost:8080）放置在一起：

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

    location /images/ {
        root /data;
    }
}

我们将修改第二个location 块，该块当前将带有/images/ 前缀的请求映射到目录下的/data/images文件，以使其与具有典型文件扩展名的图像的请求匹配。修改后的location块如下所示：

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

该参数是一个正则表达式匹配结尾的所有URI .gif，.jpg或.png。正则表达式应以开头~。相应的请求将被映射到/data/images 目录。

当nginx选择一个location块来服务请求时，它首先检查 指定前缀的位置指令，记住location 最长的前缀，然后检查正则表达式。如果存在与正则表达式匹配的内容，则nginx会选择此匹配项location，否则，它将选择之前记住的匹配项 。

代理服务器的最终配置如下所示：

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

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

该服务器将过滤以.gif， .jpg或结束的请求，.png 并将它们映射到/data/images目录（通过将URI添加到 root伪指令的参数），并将所有其他请求传递到上面配置的代理服务器。

要应用新配置，请reload按照前面几节中的说明将信号发送到nginx。

还有许多其他 指令可用于进一步配置代理连接。

设置FastCGI代理
nginx可用于将请求路由到FastCGI服务器，该服务器运行使用各种框架和编程语言（例如PHP）构建的应用程序。

与FastCGI服务器一起使用的最基本的nginx配置包括使用 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;
    }
}

这将设置一个服务器，该服务器将把对静态图像的请求以外的所有请求路由到localhost:9000通过FastCGI协议运行的代理服务器 。