nginx 基本入门

作者：villainthr

本文属于翻译文章，原文链接为 nginx Beginner’s Guide。是至今为止见过最好的 nginx 入门文章。额。。。没有之一。

这篇教程简单介绍了 nginx 并且讲解了一些 nginx 可以解决的简单任务。这里，我们假设 nginx 已经安装在读者的机器上。如果没有，可以看一下如何安装 nginx。这篇教程主要讲解的是如何启用和停止nginx，和重新加载配置，描述配置文件的基本结构和怎样搭建一个 nginx 静态辅助器，怎样配置 nginx 作为一个代理服务器来。

nginx 有一个主进程和其他子进程。主进程的主要工作是加载和执行配置文件，并且驻留子进程。子进程用来作为实际的请求处理。nginx 采取基于事件的模型和 OS 依赖的机制，在多个子进程之间高效的分配请求。子进程的个数会直接写在配置文件中并且，对于给定的配置可以是固定的，或者根据可用的 CPU 核数自动的进行调整（参考子进程）。

nginx 和它模块的工作方式是在配置文件中写好的。默认情况下，这个配置文件通常命名为 <code>nginx.conf</code> 并且会放置在 <code>/usr/local/nginx/conf</code>，<code>/etc/nginx</code>，或者 <code>/usr/local/etc/nginx</code>。

运行可执行文件就可以开启 nginx，比如：

如果，nginx 已经开启，那么它就可以通过使用 <code>-s</code> 参数的可执行命令控制。使用下列格式：

signal 可以为下列命令之一：

stop — 直接关闭 nginx

quit — 会在处理完当前正在的请求后退出，也叫优雅关闭

reload — 重新加载配置文件，相当于重启

reopen — 重新打开日志文件

比如，等待当前子进程处理完正在执行的请求后，结束 nginx 进程，可以使用下列命令：

执行该命令的用户需要和启动的 nginx 的用户一致。

如果重载配置文件的命令没有传递给 nginx 或者 nginx 没有重启，那么配置文件的改动是不会被使用的。重载配置文件的命令可以使用：

一旦主进程接收到重载配置文件的命令后，它会先检查配置文件语法的合法性，如果没有错误，则会重新加载配置文件。如果成功，则主进程会重新创建一个子进程并且发送关闭请求给以前的子进程。如果没有成功，主进程会回滚改动并且继续使用以前的配置。老的子进程在接受关闭的命令后，会停止接受新的请求并且继续处理当前的请求，直到处理完毕。之后，该子进程就直接退出了。

在 Unix 工具的帮助下，比如使用 kill 工具，该信号会被发送给 nginx 进程。在这种情况下，信号会被直接发送给带有进程 ID 的进程。nginx 的主进程的进程 ID 是写死在 nginx.pid 文件中的。该文件通常放在 <code>/usr/local/nginx/logs</code> 或者 <code>/var/run</code>目录下。比如，如果主进程的 ID 是 1628，为了发送 <code>QUIT</code> 信号来使 nginx 优雅退出，可以执行：

为了得到所有正在运行的 nginx 进程，我们可能会使用到 ps 工具，比如，像下列的方式：

更多关于发送信号给 nginx，可以参考 nginx 控制。

nginx 是由一些模块组成，我们一般在配置文件中使用一些具体的指令来控制它们。指令被分为简单指令和块级命令。一个简单的指令是由名字和参数组成，中间用空格分开，并以分号结尾。例如：

块级指令和简单指令一样有着类似的结构，但是末尾不是分号而是用 <code>{</code> 和 <code>}</code> 大括号包裹的额外指令集。如果一个块级指令的大括号里有其他指令，则它被叫做一个上下文（比如：events，http，server，和 location）。

在配置文件中，没有放在任何上下文中的指令都是处在主上下文中。<code>events</code> 和 <code>http</code> 的指令是放在主上下文中，<code>server</code> 放在 <code>http</code> 中, <code>location</code> 放在 <code>server</code> 中。

以 <code>#</code> 开头的行，会被当做注释。

一个重要的网络服务器的任务是处理文件（比如图片或者静态 HTML 文件）。这里，你会实践一个例子，文件会从不同的目录中映射（取决于请求）：<code>/data/www</code>（放置 HTML 文件）和 <code>/data/images</code>（放置图片）。这需要配置一下文件，将带有两个 <code>location</code> 的指令的 <code>server</code> 的块级命令放在 <code>server</code> 指令中。

首先，创建一个 <code>/data/www</code> 目录，然后放置一个事先写好内容的 index.html 文件。接着，创建一个 <code>/data/images</code> 目录，然后放置一些图片。

下一步，打开配置文件。默认的配置文件已经包含了一些关于 <code>server</code> 指令的样式，大多数情况下直接把他们给注释掉。现在，注释掉其他的区块，然后写一个新的 <code>server</code> 区块：

通常，该配置文件可能会包含多个 <code>server</code> 指令。这些 <code>server</code> 指令监听不同的端口和服务器名。一旦 nginx 决定哪个服务进程处理请求，它会根据在 server 块级指令中定义好的 <code>location</code> 指令的参数，来匹配请求头中指定的 URI。

将下列 location 指令添加到 server 指令中：

该 <code>location</code> 指令相对于请求中的 URI 执行了 “/” 的前缀。为了匹配请求，URI 会被添加到 <code>root</code> 命令指定的路径后，即 <code>/data/www</code>，得到本地文件系统中请求文件的路径。如果，有几个 <code>location</code> 匹配到，那么 nginx 会选择最长的前缀。上面的 <code>location</code> 提供了长度为 1 的前缀，所以，仅当其他的 <code>location</code> 匹配失败后，该指令才会使用。

接着，添加第二个 <code>location</code> 区块：

它会匹配到以 <code>/images/</code> 开头的请求（<code>location /</code> 也会匹配到该请求，只是前缀更短）

<code>server</code> 块级命令的配置结果如下：

这已经是一个可用的服务器配置，它监听标准的 80 端口并且可以在本地上通过 <code>http://localhost/</code> 访问。对于 URI 以 <code>/images/</code> 开头的请求，服务器会从 <code>/data/images</code> 目录中，返回对应的文件。例如，nginx 会返回 <code>/data/images/example.png</code> 文件，当接收到 <code>http://localhost/images/example.png</code> 的请求响应时。如果该文件不存在，nginx 会返回一个 404 错误的响应。没有以 <code>/images/</code> 开头的 URI 的请求，将会直接映射到 <code>/data/www</code> 目录中。比如，响应 <code>http://localhost/some/example.html</code> 的请求，nginx 会发送 <code>/data/www/some/example.html</code> 文件。

为了使用新的配置文件，如果还没开启 nginx 需要先开启，然后将重载信号发送给 nginx 的主进程，通过执行：

如果你发现有些地方出了问题，你可以在 <code>/usr/local/nginx/logs</code> 或者 <code>/var/log/nginx</code> 目录下的 <code>access.log</code> 和 <code>error.log</code> 文件中，找到原因。

nginx 常常用来作为代理服务器，这代表着服务器接收请求，然后将它们传递给被代理服务器，得到请求的响应，再将它们发送给客户端。

我们将配置一个基本的代理服务器，它会处理本地图片文件的请求并返回其他的请求给被代理的服务器。在这个例子中，两个服务器都会定义在一个 nginx 实例中。

首先，通过在 nginx 配置文件中添加另一个 <code>server</code> 区块，来定义一个被代理的服务器，像下面的配置：

上面就是一个简单的服务器，它监听在 8080 端口（之前，<code>listen</code> 并没被定义，是因为默认监听的 80 端口）并且会映射所有的请求给本地文件目录 <code>/data/up1</code>。创建该目录，然后添加 <code>index.html</code> 文件。注意，<code>root</code> 指令是放在 <code>server</code> 上下文中。当响应请求的 <code>location</code> 区块中，没有自己的 <code>root</code> 指令，上述的 <code>root</code>指令才会被使用。

接着，使用前面章节中的 <code>server</code> 配置，然后将它改为一个代理服务配置。在第一个 <code>location</code> 区块中，放置已经添加被代理服务器的协议，名字和端口等参数的 proxy_pass 指令（在这里，就是 <code>http://localhost:8080</code>）:

我们将修改第二个 <code>location</code> 区块，使他返回一些典型后缀的图片文件请求，现在它只会映射带有 <code>/images/</code> 前缀的请求到 <code>/data/images</code> 目录下。修改后的 <code>location</code> 指令如下：

该参数是一个正则表达式，它会匹配所有以 <code>.gif</code>，<code>.jpg</code> 或者 <code>.png</code> 结尾的 URIs。一个正则表达式需要以 <code>~</code> 开头。匹配到的请求会被映射到 <code>/data/images</code>目录下。

当 nginx 在选择 <code>location</code> 去响应一个请求时，它会先检测带有前缀的 <code>location</code>指令，记住先是检测带有最长前缀的 <code>location</code>，然后检测正则表达式。如果有一个正则的匹配的规则，nginx 会选择该 <code>location</code>，否则，会选择之前缓存的规则。

最终，一个代理服务器的配置结果如下：

该服务器会选择以 <code>.gif</code>，<code>.jpg</code>，或者 <code>.png</code> 结束的请求并且映射到 <code>/data/images</code> 目录（通过添加 URI 给 root 指令的参数），接着将其他所有的请求映射到上述被代理的服务器。

为了使用新的配置，像前几个章节描述的一样，需要向 nginx 发送重载信号。

这还有很多其他的指令，可以用于进一步配置代理连接。

原文链接：http://ivweb.io/topic/58427dfb270eedfd10a0f5ea