初学者指南
启动、停止和重新加载配置 配置文件结构 提供静态内容 设置简单代理服务器 设置 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
其中 signal 可以是以下之一:
-
stop
— 快速关闭 -
quit
— 优雅关闭 -
reload
— 重新加载配置文件 -
reopen
— 重新打开日志文件
例如,要在等待工作进程完成处理当前请求后停止 nginx 进程,可以执行以下命令:
nginx -s quit
此命令应在启动 nginx 的同一用户下执行。
配置文件中所做的更改在发送重新加载配置命令给 nginx 或重启 nginx 之前不会生效。要重新加载配置,请执行:
nginx -s reload
一旦主进程收到重新加载配置的信号,它会检查新配置文件的语法有效性并尝试应用其中提供的配置。如果成功,主进程将启动新的工作进程,并向旧的工作进程发送消息,请求它们关闭。否则,主进程将回滚更改,并继续使用旧配置。旧的工作进程收到关闭命令后,将停止接受新连接,并继续处理当前请求,直到所有此类请求都得到处理。之后,旧的工作进程退出。
也可以借助 Unix 工具(例如 kill
工具)向 nginx 进程发送信号。在这种情况下,信号直接发送到具有给定进程 ID 的进程。默认情况下,nginx 主进程的进程 ID 写入 /usr/local/nginx/logs
或 /var/run
目录下的 nginx.pid
文件中。例如,如果主进程 ID 为 1628,要发送导致 nginx 优雅关闭的 QUIT 信号,请执行:
kill -s QUIT 1628
要获取所有正在运行的 nginx 进程列表,可以使用 ps
工具,例如,以下方式:
ps -ax | grep nginx
有关向 nginx 发送信号的更多信息,请参阅控制 nginx。
配置文件结构
nginx 由模块组成,这些模块由配置文件中指定的指令控制。指令分为简单指令和块指令。简单指令由名称和参数(用空格分隔)组成,以分号 (;
) 结尾。块指令与简单指令结构相同,但它不以分号结尾,而是以一对花括号 ({
和 }
) 包围的一组附加指令结尾。如果一个块指令的花括号内可以包含其他指令,则称为上下文(例如:events、http、server 和 location)。
放置在配置文件中任何上下文之外的指令被认为位于 main 上下文中。events
和 http
指令位于 main
上下文,server
位于 http
上下文,location
位于 server
上下文中。
#
符号之后的一行其余部分被视为注释。
提供静态内容
一个重要的 Web 服务器任务是提供文件(例如图像或静态 HTML 页面)。您将实现一个示例,根据请求,文件将从不同的本地目录提供:/data/www
(可能包含 HTML 文件)和 /data/images
(包含图像)。这将需要编辑配置文件,并在 http 块内设置一个 server 块,该块包含两个 location 块。
首先,创建 /data/www
目录并在其中放入一个包含任意文本内容的 index.html
文件,然后创建 /data/images
目录并在其中放置一些图像。
接下来,打开配置文件。默认配置文件已包含几个 server
块示例,大部分都被注释掉了。现在注释掉所有这些块,并开始一个新的 server
块:
http { server { } }
通常,配置文件可以包含几个 server
块,它们通过监听的端口和服务器名称来区分。一旦 nginx 决定哪个 server
处理请求,它会将请求头中指定的 URI 与 server
块内定义的 location
指令的参数进行匹配测试。
将以下 location
块添加到 server
块中:
location / { root /data/www; }
这个 location
块指定了与请求中的 URI 进行比较的“/
”前缀。对于匹配的请求,URI 将添加到 root 指令中指定的路径,即添加到 /data/www
,以形成本地文件系统上请求文件的路径。如果存在多个匹配的 location
块,nginx 会选择前缀最长的一个。上面的 location
块提供了最短的前缀,长度为一,因此只有当所有其他 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 错误的响应。URI 不以 /images/
开头的请求将被映射到 /data/www
目录。例如,对于 http://localhost/some/example.html
请求,nginx 将发送 /data/www/some/example.html
文件。
要应用新配置,如果 nginx 尚未启动则启动它,或者通过执行以下命令向 nginx 主进程发送 reload
信号:
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(之前未指定 listen
指令是因为使用了标准端口 80),并将所有请求映射到本地文件系统上的 /data/up1
目录。创建此目录并在其中放入 index.html
文件。请注意,root
指令位于 server
上下文。当选择用于处理请求的 location
块不包含其自己的 root
指令时,会使用此类 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; }
参数是匹配所有以 .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; } }
该服务器将过滤以 .gif
、.jpg
或 .png
结尾的请求,并将它们映射到 /data/images
目录(通过将 URI 添加到 root
指令的参数中),并将所有其他请求传递给上面配置的被代理服务器。
要应用新配置,请按照前面几节所述向 nginx 发送 reload
信号。
还有许多其他指令可用于进一步配置代理连接。
设置 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; } }
这将设置一个服务器,它会将除了静态图像请求之外的所有请求通过 FastCGI 协议路由到在 localhost:9000
上运行的被代理服务器。