如何配置nginx

2017-08-22

nginx是一种轻量级的高性能Web服务器，旨在通过有效利用系统资源快速提供大量静态内容。nginx的优点是能够有效地提供静态内容，如纯HTML和媒体文件。有些人认为这是动态内容的理想服务器。

nginx

与使用线程或面向过程的方法来处理请求的Apache不同，nginx使用异步事件驱动模型，在负载下提供更可预测的性能。而不是使用嵌入式解释器方法，nginx将动态内容交给CGI，FastCGI或甚至Apache等其他Web服务器，然后将其传递回nginx以传送给客户端。

这导致某些部署更复杂的设置。由于这些和其他原因，起初，nginx的配置可能会感到复杂和不直观。本文档应该熟悉基本的nginx参数和约定。我们将通过nginx的主配置文件。

所有的nginx配置文件位于**/etc/nginx/目录中。主配置文件是/etc/nginx/nginx.conf**。

注:

如果从包管理器安装nginx，这是文件所在的位置。其他可能的位置包括/opt/nginx/conf/。

先决条件

在开始之前，请确保您已完成以下操作：

按照入门指南。

  • 安装nginx服务器。
  • 本指南要求的步骤需要root权限。请确保root使用sudo前缀运行以下步骤。有关权限的更多信息，请参阅我们的用户和组指南。

如果您刚接触Linux服务器管理员，您可能还对我们的“新手指南”和“ 管理基础指南”感兴趣。

开始之前

以下部分涵盖了在对nginx配置进行任何更改之前应该对其进行检查的几个概念和保护措施。

备份默认配置

有时候，服务器配置文件可能会被破坏或复杂化，使得它们变得不可用，所以始终是拥有必要文件的工作副本的好主意。一个很好的第一步是复制任何配置文件，然后再开始进行更改，如下所示：

# cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup

对于更好的恢复选项，我们建议定期备份您的nginx配置。您可能希望将整个/etc/nginx/目录存储在Git存储库中，以便您可以将原始设置和所有版本保存在所有不同的更改中。另一种选择是定期创建文件的日期副本。您可以通过发出以下命令来完成此操作：

# cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.$(date“+％b_％d_％Y_％H.％M.％S”）

Start, Stop, Reload

现在，您可以对nginx配置进行更改。每当您更改nginx.conf文件时，您需要重新加载配置，然后更改才会生效。您可以通过发出以下命令来执行此操作：

# service nginx reload

要完全停止或启动服务，请reload用start或替换stop。

语法简介

本部分将介绍从默认配置文件 /etc/nginx/nginx.conf：

# /etc/nginx/nginx.conf
user www-data;
worker_processes 4;
pid /run/nginx.pid;

events {
        worker_connections 768;
        # multi_accept on;
}

通常，您不需要在第一部分中更改任何内容。相反，我们将使用它作为解释配置文件语法的机会。

  • 前面有一个井号或hash（＃）的所有行都是注释。这意味着它们不被nginx解释。程序员使用注释来解释某些代码块的做法，或者提供如何编辑值的建议。默认文件有几个注释部分用于说明，如果需要，您可以添加自己的。程序员还将留下可选语句作为注释。如果需要，可以通过拆下井号来“打开”。 上面显示了一个例子。该指令multi_accept on;有一个#在它的前面。这不是对用户的评论，而是一个可以通过删除的“激活”的指令#。
  • 设置以变量名开始，然后声明由空格分隔的参数或一系列参数。例子包括worker_processes 1;和error_log logs/error.log notice;。所有语句以分号（;）结尾。
  • 一些设置，如events上面的变量，具有自变量参数的参数。所有子指令都包含在一组大括号（{ }）中。
  • 托架有时会嵌套在多个子指令集中。如果您添加或编辑具有嵌套括号的部分，请确保它们都进入打开和关闭对。
  • 标签或多个空格由nginx解释为单个空格。以标准化方式使用制表符或空格进行缩进将大大提高文件的可读性，并使其更容易维护。

了解nginx的工作原理

现在我们了解语法，让我们进入nginx的坚果。首先，我们将介绍nginx.conf文件中的核心指令，定义Web服务器的基本行为。然后我们HTTP将更详细地解释该块，以及一些更常用的调整变量。从那里我们将移动到server块和虚拟主机配置文件。这是您将使用nginx定义要托管的网站时，您将编辑的部分。

定义指令

我们将首先解释核心指令，/etc/nginx/nginx.conf让我们回到第一部分：

# /etc/nginx/nginx.conf
user www-data;
worker_processes 4;
pid /run/nginx.pid;

events {
        worker_connections 768;
        # multi_accept on;
}

user

定义哪个Linux系统用户将拥有和运行nginx服务器。大多数基于Debian的发行版都使用，www-data但在其他发行版中可能有所不同。有一些用例可以从改变用户的角度受益; 例如，如果您运行两个同时的Web服务器，或者需要另一个程序的用户来控制nginx。

worker_process

定义要运行的nginx有多少线程或并发实例。您可以了解有关此指令的更多信息以及在此处进行调整的值。

PID

定义nginx会写入其主进程ID或PID的位置。操作系统使用PID来跟踪和发送信号到nginx进程。

HTTP（通用配置）

该nginx.conf文件的下一部分涵盖了nginx在处理HTTP Web流量时的通用指令。HTTP块的第一部分如下所示：

# /etc/nginx/nginx.conf
http {

    ##
    # Basic Settings
    ##

    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;
    # server_tokens off;

    # server_names_hash_bucket_size 64;
    # server_name_in_redirect off;

    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    ##
    # Logging Settings
    ##

    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;

    ##
    # Gzip Settings
    ##

    gzip on;
    gzip_disable "msie6";

大多数http { }块应该按照大多数nginx配置工作。但是，我们希望提请您注意以下配置选项：

include

include本节开头的声明包含mime.types位于的文件/etc/nginx/mime.types。这意味着文件中写的任何东西都mime.types被解释为如果它被写入http { }块内。这允许您在http { }块中包含冗长的信息量，而不会使主配置文件混乱。尝试避免太多的链接包含（即，包括一个文件本身包含一个文件等）。如果可能，请保持一个或两个包含级别，以便可读性。您可以随时使用指令将所有文件包含在特定目录中：

include /etc/nginx/sites-enabled/*;

或者更具体地说，您可以将所有.conf文件包含在目录中：

include /etc/nginx/conf.d/*.conf;

gzip

gzip指令告诉服务器使用即时gzip压缩来限制使用的带宽量并加快一些传输。这相当于Apache的mod_deflate。可以在http块的此部分中取消注释其他设置，以修改gzip行为：

# /etc/nginx/nginx.conf
# gzip_vary on;
# gzip_proxied any;
# gzip_comp_level 6;
# gzip_buffers 16 8k;
# gzip_http_version 1.1;
# gzip_types text/plain text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript;

有关gzip选项的完整定义，请从nginx文档查看此页面。

注：

如果您在此处启用gzip压缩功能，请注意，您正在交易增加的CPU成本，以换取您的较低带宽使用。设置为gzip_comp_level1到9之间的值，其中9需要最大量的CPU资源，1需要最少。默认值为1。

请注意，上面显示的代码片段不包括关闭括号（}），因为HTTP部分未完成。有关HTTP块中每个指令的详细说明，请从nginx文档中查看此页面。

Server (Virtual Domains 配置)

nginx.conf文件的HTTP块包含该语句include /etc/nginx/sites-enabled/*;。这允许从sites-enabled子目录中找到的单独文件加载服务器块配置。通常这些是存储在文件中的符号链接**/etc/nginx/sites-available/**。通过使用符号链接，您可以快速启用或禁用虚拟服务器，同时保留其配置文件。nginx提供了一个默认的虚拟主机文件，可以将其用作为其他域创建虚拟主机文件的模板：

# cp /etc/nginx/sites-available/default /etc/nginx/sites-available/example.com

现在我们来看看组成server块的指令和设置：

# /etc/nginx/sites-available/default
server {
        listen 80 default_server;
        listen [::]:80 default_server ipv6only=on;

        root /usr/share/nginx/html;
        index index.html index.htm;

        # Make site accessible from http://localhost/
        server_name localhost;

        location / {
                # First attempt to serve request as file, then
                # as directory, then fall back to displaying a 404.
                try_files $uri $uri/ /index.html;
                # Uncomment to enable naxsi on this location
                # include /etc/nginx/naxsi.rules
        }
}

该server块是典型的nginx用户将其大部分更改作为默认配置的地方。通常，您将要为server服务器上的每个虚拟域制作一个单独的文件，其中包含自己的块。以下部分将显示服务器块的更多配置选项。

Listening Ports

listen位于server块中的指令告诉nginx主机名/ IP以及应该监听HTTP连接的TCP端口。默认情况下，nginx将侦听端口上的HTTP连接80。

接下来，我们将介绍一些常用的listen指令示例。

注：

listen如果需要，您可以使用多个指令。

# /etc/nginx/sites-available/default
listen 80 default_server;
listen [::]:80 default_server ipv6only=on;

这些是默认虚拟主机文件中的默认listen语句。该参数default_server意味着此虚拟主机将回答端口80上不专门匹配另一个虚拟主机的listen语句的请求。第二个语句监听IPv6，并以相同的方式运行。

# /etc/nginx/sites-available/example.com
listen     127.0.0.1:80;
listen     localhost:80;

这两个例子直接指向nginx来监听127.0.0.1; 即本地环回接口。localhost通常在**/etc/hosts设置为127.0.0.1**。

# /etc/nginx/sites-available/example.com
listen     127.0.0.1:8080;
listen     localhost:8080;

第三对示例也会侦听本地主机，但是它们会侦听端口上的响应8080而不是端口80。

listen     192.168.3.105:80;
listen     192.168.3.105:8080;

第四对示例指定监听IP地址上的请求的服务器192.168.3.105。第一个侦听端口80，第二个端口8080。

# /etc/nginx/sites-available/example.com
listen     80;
listen     *:80;
listen     8080;
listen     *:8080;

第五组示例告诉nginx监听特定端口上的所有域和IP地址。listen 80;相当于listen *:80;，listen 8080;相当于listen *:8080;。

# /etc/nginx/sites-available/example.com
listen     12.34.56.77:80;
listen     12.34.56.78:80;
listen     12.34.56.79:80;

最后，最后一组的例子指示服务器侦听端口请求80的IP地址12.34.56.77，12.34.56.78和12.34.56.79。

基于名称的虚拟主机

server_name位于server块中的指令允许管理员提供基于名称的虚拟主机。这允许从单个IP地址提供多个域。服务器根据接收到的请求报头来决定要提供哪个域（例如，当有人请求特定的URL时）。

通常，您将要为您要在服务器上托管的每个域创建一个文件。每个文件应该有自己的server块，并且该server_name指令是指定该文件影响哪个域的地方。

接下来我们将介绍一些常用的server_name指令示例：

# /etc/nginx/sites-available/example.com
server_name    example.com ;

以上示例指示nginx处理请求example.com。这是最基本的配置。

server_name    example.com  www.example.com ;

第二个例子指示服务器来处理两个请求example.com和www.example.com。

# /etc/nginx/sites-available/example.com
server_name    * .example.com ; 
server_name    .example.com ;

这两个例子是等效的。*.example.com与.example.com这两个指示服务器来处理的所有子域的请求example.com，其中包括www.example.com，foo.example.com等等。

# /etc/nginx/sites-available/example
server_name   example.*;

第四个例子指示服务器来处理所有域名请求开头example.，其中包括example.com，example.org，example.net，example.foo.com，等。

# /etc/nginx/sites-available/multi-list
server_name   example.com linode.com icann.org;

第五个示例指示服务器处理三个不同域名的请求。请注意，域名的任何组合都可以列在单个server_name指令中。

# /etc/nginx/sites-available/local
server_name    localhost  linode  galloway ;

nginx允许您为无效域名的虚拟主机指定名称。nginx使用HTTP头中的名称来回答请求; nginx无论域名是否有效。在这种情况下，可以在/ etc / hosts文件中指定主机名。

如果您的nginx服务器部署在LAN上，或者您已经知道将要求服务器的所有客户端，那么使用非域名主机名可能会很有用。这包括预配置/etc/hostsnginx正在侦听的IP地址的条目的前端代理服务器。

/etc/nginx/sites-available/catchall
server_name   "";

最后，如果设置server_name为空引号集（“”），nginx将处理所有没有主机名或具有未指定主机名的请求，例如IP地址本身的请求。

注:

个别名称与空格分开。如果需要，您可以使用正则表达式。

访问日志

access_log该指令可以在特定虚拟域中的http块中nginx.conf或块中设置server。它设置nginx访问日志的位置。通过将访问日志定义到每个server块中的不同路径，您可以将每个虚拟域的特定输出排序到其自己的文件中。块中access_log定义的指令http可用于记录对单个文件的所有访问，也可以用于访问未定义自己的日志文件的虚拟主机的全部访问。

您可以使用相对于当前目录的路径：

# /etc/nginx/nginx.conf
access_log logs/example.access.log;

或者，您可以使用完整路径：

# /etc/nginx/sites-available/example.com
access_log  /srv/www/example.com/logs/access.log ;

您也可以禁用访问日志，尽管不建议这样做：

# /etc/nginx/nginx.conf
access_log off;

Location（文件和文件夹配置）

server设置块的最后一个组件是location指令。我们将介绍的所发生的具体内部在下一节的位置块; 现在我们将专注于基本的路径设置。

该location设置允许您配置nginx如何响应服务器中的资源请求。就像server_name指令告诉nginx如何处理域的请求，例如http://example.com，该location指令涵盖了特定文件和文件夹的请求，例如http://example.com/blog/。

注：

您可以有多个位置指令。

以下是几个例子：

# /etc/nginx/sites-available/example.com
location / { }
location /images/ { }
location /blog/ { }
location /planet/ { }
location /planet/blog/ { }

前五个例子是文字字符串匹配，它匹配主机段之后的HTTP请求的任何部分。因此，例如，如果有用户请求

Request: http://example.com/

Return: 假设有一个server_name条目example.com，该location /指令将确定此请求会发生什么。

nginx始终使用最具体的匹配来满足请求。所以，例如：

Request: http://example.com/planet/blog/_或_http://example.com/planet/blog/about/

Return: 这是通过location /planet/blog/设置实现的，因为它更具体，即使location /planet/也符合此请求。

# /etc/nginx/sites-available/example.com
location ~ IndexPage\.php$ { }
location ~ ^/BlogPlanet(/|/index\.php)$ { }

当一个location指令后面跟着一个波浪号（〜）时，nginx执行正则表达式匹配。这些匹配总是区分大小写。所以，IndexPage.php将匹配上面的第一个例子，但indexpage.php不会。在第二个例子中，正则表达式^/BlogPlanet(/|index.php)$匹配的请求/BlogPlanet/和/BlogPlanet/index.php，但不是 /BlogPlanet，/blogplanet/或/blogplanet/index.php。nginx使用Perl兼容的正则表达式（PCRE）。

# /etc/nginx/sites-available/example.com
location ~* \.(pl|cgi|perl|prl)$ { }
location ~* \.(md|mdwn|txt|mkdn)$ { }

如果您希望匹配不区分大小写，请使用带有星号（〜 *）的波形符号。上面的例子指定了nginx应该如何处理以特定文件扩展名结尾的请求。在第一示例中，结束在任何文件中：.pl，.PL，.cgi，.CGI，.perl，.Perl，.prl，和.PrL（等等）将匹配的请求。

# /etc/nginx/sites-available/example.com
location ^~ /images/IndexPage/ { }
location ^~ /blog/BlogPlanet/ { }

在你的指令中添加一个插入符号和波浪号（^〜）location告诉nginx，如果它匹配一个特定的字符串，停止搜索更多的具体匹配，并使用这里的指令。除此之外，这些指令的工作方式与第一组中的文字字符串匹配一样。因此，即使稍后有更具体的匹配，如果请求与这些指令中的一个匹配，则将使用此处的设置。有关location指令处理的顺序和优先级的更多信息，请参见下文。

# /etc/nginx/sites-available/example.com
location =/ { }

最后，如果在设置中添加一个等号（=）location，这将强制与所请求的路径完全匹配，然后停止搜索更具体的匹配。例如，最终的例子将只匹配http://example.com/，而不是http://example.com/index.html。使用完全匹配可以稍微加快请求时间，如果您有一些特别受欢迎的请求，这将非常有用。

指令按以下顺序处理：

  1. 首先处理精确的字符串匹配。如果发现匹配，nginx将停止搜索并满足该请求。
  2. 接下来处理剩余的文字字符串指令。如果nginx遇到使用^〜参数的匹配项，那么它会在此处停止并满足请求。否则，nginx继续处理位置指令。
  3. 具有正则表达式（〜和〜 *）的所有位置指令都被处理。如果正则表达式与请求匹配，nginx将停止搜索并满足请求。
  4. 如果没有正则表达式匹配，则使用最具体的文字字符串匹配。 确保域下的每个文件和文件夹至少匹配一个location指令。

注：

虽然nginx的配置解析器在技术上能够读取嵌套的位置块，但这不是推荐也不支持。

位置根和索引

该location设置是另一个具有自己的参数块的变量。

一旦nginx确定哪个location指令与给定的请求最匹配，则对该请求的响应由相关location指令块的内容确定。以下是一个例子：

# /etc/nginx/sites-available/example.com
location / {
    root html;
    index index.html index.htm;
}

在此示例中，文档根位于html/目录中。给定nginx的默认安装前缀，此位置的完整路径为/etc/nginx/html/。

request: http://example.com/blog/includes/style.css return: nginx将尝试提供位于的文件/etc/nginx/html/blog/includes/style.css

注:

root如果需要，可以使用绝对路径作为指令。

index该变量告诉nginx要指定哪个文件。例如：

request： http://example.com

return： nginx将尝试提供位于的文件/etc/nginx/html/index.html。

如果为index指令指定了多个文件，nginx将按顺序处理列表，并使用存在的第一个文件来完成请求。如果index.html相关目录中不存在，index.htm则将被使用。如果不存在，将发送404消息。

这是一个更复杂的例子，它展示了一组针对服务器响应域location的nginx和Perl-FastCGI指南的指令example.com：

# /etc/nginx/sites-available/example.com location directive
location / {
    root   /srv/www/example.com/public_html;
    index  index.html index.htm;
}

location ~ \.pl$ {
    gzip off;
    include /etc/nginx/fastcgi_params;
    fastcgi_pass unix:/var/run/fcgiwrap.socket;
    fastcgi_index index.pl;
    fastcgi_param SCRIPT_FILENAME /srv/www/www.example.com/public_html$fastcgi_script_name;
}

在这个例子中，在.pl扩展中结束的资源的所有请求都由第二个位置块来处理，第二个位置块指定了fastcgi这些请求的处理程序。否则，nginx使用第一个位置指令。资源位于文件系统上/srv/www/example.com/public_html/。如果请求没有指定文件名，nginx的将寻找并提供index.html或index.htm文件。如果没有index找到文件，服务器将返回404错误。

我们分析一些请求中会发生什么：

request： http://example.com/

return： /srv/www/example.com/public_html/index.html如果存在。如果该文件不存在，它将提供服务/srv/www/example.com/public_html/index.htm。如果不存在，nginx返回404错误。

request： http://example.com/blog/

return： /srv/www/example.com/public_html/blog/index.html如果存在。如果该文件不存在，它将提供服务/srv/www/example.com/public_html/blog/index.htm。如果不存在，nginx返回404错误。

request： http://example.com/tasks.pl

return： nginx将使用FastCGI处理程序来执行位于的文件/srv/www/example.com/public_html/tasks.pl并返回结果。

request： http://example.com/username/roster.pl

return： nginx将使用FastCGI处理程序来执行位于的文件/srv/www/example.com/public_html/username/roster.pl并返回结果。

最佳做法

前面几节的例子和解释可以帮助您学习如何配置您的nginx服务器的优雅和自信。在本节中，我们将介绍一些保持您的nginx配置的最佳实践：

  • 在可能的情况下，将配置放在单独的文件中，而不是全部在主配置文件中。
  • 为每个域单独配置文件。例如，如本指南所示，可能会调用example.com的nginx配置文件/etc/nignx/sites-available/example.com。它将包含该域的服务器块。该域名在server_name变量中指定。
  • 使用include主nginx.conf配置中的语句来包含每个服务器配置文件。这些包括语句在http { }主配置文件的块中：
# /etc/nginx/nginx.conf
http {
      # [...]

      include /srv/www/example.com/nginx.conf;

      # [...]
}
  • 以一致的模式命名文件。保持文件格式正确，格式清晰，将大大降低维护nginx服务器的负担。
https://www.linode.com/docs/web-servers/nginx/how-to-configure-nginx