nginx虚拟主机配置文件的详细步骤是怎样的？

在Nginx服务器管理中,虚拟主机（或称为“Server Blocks”）是核心功能之一，它允许在一台单一的物理服务器上托管多个独立的网站，每个网站都可以拥有独立的域名、内容根目录和配置规则，彼此之间互不干扰，实现这一功能的关键在于正确地编写和管理Nginx的虚拟主机配置文件，本文将深入探讨Nginx虚拟主机配置文件的构成、关键指令以及最佳实践，帮助您构建稳定、高效的Web服务环境。

配置文件的组织结构

为了保持配置的清晰与可维护性,现代Nginx安装（尤其是在Debian或Ubuntu等系统上）通常采用一种模块化的管理方式，即使用sites-available和sites-enabled两个目录。

• sites-available目录：此目录用于存放所有可用的虚拟主机配置文件，每个文件对应一个网站的定义，文件在这里只是“存在”，但并不会被Nginx实际加载。
• sites-enabled目录：此目录存放真正“启用”的虚拟主机配置，我们不会直接在这里创建文件，而是通过创建符号链接（symbolic link）将sites-available中的某个配置文件链接到sites-enabled目录。

这种方式的优势在于,您可以方便地启用或禁用一个网站，而无需删除或修改配置文件本身，只需添加或删除一个符号链接，然后重新加载Nginx服务即可，Nginx的主配置文件nginx.conf中，通常会有一条include /etc/nginx/sites-enabled/*;指令，来加载此目录下所有已启用的配置。

虚拟主机配置文件核心构成

一个典型的虚拟主机配置文件主要包含在一个server { ... }块中，下面我们来详细解析这个块内的关键指令。

listen 指令

listen指令定义了Nginx监听的IP地址和端口，这是虚拟主机对外提供服务的入口。

• listen 80;：监听所有IPv4地址的80端口（HTTP默认端口）。
• listen 443 ssl;：监听所有IPv4地址的443端口（HTTPS默认端口），并启用SSL。
• listen [::]:80;：监听所有IPv6地址的80端口。
• listen 80 default_server;：将此虚拟主机设置为默认服务器，当 incoming request 的Host头部信息与任何其他server_name都不匹配时，Nginx将使用此server块处理请求。

server_name 指令

server_name指令用于指定此虚拟主机响应的域名，这是基于域名的虚拟主机的核心。

• server_name example.com;：只响应example.com的请求。
• server_name example.com www.example.com;：可以指定多个域名，用空格隔开。
• server_name *.example.com;：使用通配符，可以匹配所有example.com的子域名，如blog.example.com、shop.example.com。
• server_name _;：一个特殊的写法，通常用于捕获所有未被其他server_name匹配的请求，常与default_server配合使用。

root 和 index 指令

• root指令设置了网站的根目录，即存放网站文件（HTML, CSS, JavaScript, 图片等）的本地文件系统路径。root /var/www/example.com/html;。
• index指令定义了当请求的是一个目录时，Nginx默认查找的文件列表。index index.html index.htm index.php;，Nginx会按顺序查找这些文件，找到第一个存在的就返回给客户端。

location 块

location块是Nginx配置中最强大、最灵活的部分，它允许您根据请求的URI（Uniform Resource Identifier）来匹配不同的模式，并为这些模式应用特定的配置。

• location / { ... }：匹配所有请求，这是最基本的location，通常用于定义根目录的访问规则。
• location /images/ { ... }：匹配以/images/开头的所有URI。
• location ~ .php$ { ... }：使用正则表达式（表示区分大小写的正则匹配），匹配所有以.php结尾的请求，这里通常会配置PHP-FPM等后端服务来处理动态脚本。

完整配置示例

以下是一个为域名mywebsite.com配置HTTP服务的完整示例文件，假设它存放在/etc/nginx/sites-available/mywebsite.com。

# 定义一个HTTP服务器块
server {
    # 监听80端口
    listen 80;
    # 设置服务器域名
    server_name mywebsite.com www.mywebsite.com;
    # 设置网站根目录
    root /var/www/mywebsite.com/html;
    # 设置默认索引文件
    index index.html index.htm;
    # 定义访问日志和错误日志的路径
    access_log /var/log/nginx/mywebsite.com.access.log;
    error_log /var/log/nginx/mywebsite.com.error.log;
    # 主location块，处理所有请求
    location / {
        # 尝试查找URI对应的文件，如果找不到则尝试查找目录，最后返回404
        try_files $uri $uri/ =404;
    }
    # 针对静态资源的特定处理（可选）
    location ~* .(css|js|jpg|jpeg|png|gif|ico|svg)$ {
        expires 1y; # 设置浏览器缓存一年
        add_header Cache-Control "public, immutable";
    }
}

要启用此网站,管理员需执行以下命令：
sudo ln -s /etc/nginx/sites-available/mywebsite.com /etc/nginx/sites-enabled/
测试配置语法并重新加载Nginx：
sudo nginx -t
sudo systemctl reload nginx

为了快速回顾,下表小编总结了虚拟主机配置中的核心指令：

相关问答FAQs

问题1：为什么我配置了新的虚拟主机，访问时却总是显示Nginx的默认欢迎页面？
解答： 这个问题通常由两个常见原因导致，第一，server_name指令配置错误，请确认您在浏览器中访问的域名与配置文件中server_name后列出的域名完全一致，第二，Nginx服务没有被重新加载，在创建或修改配置文件后，必须执行sudo nginx -t测试配置无误，然后执行sudo systemctl reload nginx（或sudo service nginx reload）来让新的配置生效，如果server_name确实不匹配任何已配置的站点，请求可能会被default_server捕获，从而显示默认页面。

问题2：如何在一个Nginx配置文件中同时为网站配置HTTP和HTTPS访问？
解答： 最佳实践是为同一个域名的HTTP和HTTPS创建两个独立的server块，您会配置一个监听80端口的server块，其主要作用是将所有HTTP请求永久重定向（301）到对应的HTTPS地址，以确保连接的安全性，然后再配置另一个监听443端口的server块，在其中加入SSL证书相关指令（如ssl_certificate和ssl_certificate_key）以及网站的具体内容配置，这种结构清晰明了，有助于实现全站HTTPS。