31.10.2024

Linux

管理

如何在 Ubuntu 上的 Nginx 中配置虚拟主机

在单个服务器上配置Nginx虚拟主机是托管多个网站的最强大技术之一，每个网站都有自己的域名、根目录和独立配置。Nginx通过server blocks处理这一问题——灵活、轻量级的配置单元，定义Web服务器如何响应每个域的请求。

无论您是在管理个人作品集、运行客户网站，还是扩展多租户应用程序，本指南都提供了在Ubuntu上设置Nginx虚拟主机的完整、生产就绪的演练。我们将涵盖目录结构、server block配置、启用站点、SSL/HTTPS设置和故障排除——从零开始到完全功能的多站点Nginx服务器所需的一切。

> 寻找可靠的Ubuntu服务器来跟随本指南？ AlexHost的VPS托管计划为您提供完整的root访问权限、SSD存储和即时部署——完美适合此用例。

前置条件

在开始之前，请确保满足以下条件：

在您的服务器上安装Nginx

如果尚未安装Nginx，请在Ubuntu服务器上运行以下命令：

sudo apt update
sudo apt install nginx

验证安装并检查服务是否正在运行：

sudo systemctl status nginx

您应该在输出中看到active (running)。如果没有，请手动启动它：

sudo systemctl start nginx
sudo systemctl enable nginx

指向您的服务器的域名

每个虚拟主机都需要一个解析到您服务器公网IP地址的域名。您需要在DNS设置中创建指向服务器IP的A记录。

> 需要域名？ 通过AlexHost域名注册注册您的域名，并直接从您的控制面板管理DNS记录。

对于本地测试目的，您可以通过编辑/etc/hosts文件来绕过DNS（在第7步中介绍）。

所需权限

您需要在Ubuntu服务器上拥有sudo权限来创建目录、编辑配置文件和管理Nginx服务。

第1步：为每个网站设置目录

您服务器上托管的每个网站都应该有自己的隔离目录来存储Web文件。这种分离可以保持您的项目井井有条，并防止配置冲突。

在本指南中，我们将配置两个示例域：example1.com和example2.com。在整个过程中将这些替换为您的实际域名。

创建Web根目录

sudo mkdir -p /var/www/example1.com/html
sudo mkdir -p /var/www/example2.com/html

-p标志根据需要创建所有中间目录。

分配正确的所有权

将这些目录的所有权授予www-data，即Nginx运行的系统用户：

sudo chown -R www-data:www-data /var/www/example1.com/html
sudo chown -R www-data:www-data /var/www/example2.com/html

这确保Nginx具有必要的读权限来从这些目录提供文件。

设置目录权限

sudo chmod -R 755 /var/www

755权限意味着所有者具有完整的读/写/执行访问权限，而组和其他用户具有读和执行访问权限——适合公开提供的Web内容。

第2步：创建示例HTML内容

为了验证每个虚拟主机是否正常工作，为每个站点创建一个简单的index.html文件。

对于example1.com

echo "<h1>Welcome to Example1.com!</h1>" | sudo tee /var/www/example1.com/html/index.html

对于example2.com

echo "<h1>Welcome to Example2.com!</h1>" | sudo tee /var/www/example2.com/html/index.html

这些占位符页面将确认Nginx正在将请求路由到每个域的正确文档根目录。

第3步：创建虚拟主机配置文件

Nginx将站点配置文件存储在/etc/nginx/sites-available/中。每个文件定义一个server block——Nginx等效的Apache虚拟主机。启用的站点随后被符号链接到/etc/nginx/sites-enabled/。

example1.com的配置

创建一个新配置文件：

sudo nano /etc/nginx/sites-available/example1.com

添加以下server block：

server {
    listen 80;
    listen [::]:80;

    server_name example1.com www.example1.com;

    root /var/www/example1.com/html;
    index index.html index.htm;

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

    location / {
        try_files $uri $uri/ =404;
    }
}

保存并关闭文件（Ctrl+X，然后Y，然后Enter）。

example2.com的配置

创建第二个配置文件：

sudo nano /etc/nginx/sites-available/example2.com

添加以下server block：

server {
    listen 80;
    listen [::]:80;

    server_name example2.com www.example2.com;

    root /var/www/example2.com/html;
    index index.html index.htm;

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

    location / {
        try_files $uri $uri/ =404;
    }
}

关键指令说明

指令	用途
`listen 80`	监听端口80上的传入HTTP连接
`listen [::]:80`	在端口80上启用IPv6支持
`server_name`	定义此块处理的域名
`root`	设置文档根目录——网站文件的存储位置
`index`	指定请求目录时要提供的默认文件
`try_files`	尝试提供请求的文件；如果未找到则返回404
`access_log` / `error_log`	每个站点的单独日志文件，便于调试

第4步：启用虚拟主机

Nginx通过从sites-available创建符号链接到sites-enabled来激活站点。这种设计允许您准备配置而无需立即激活它们。

sudo ln -s /etc/nginx/sites-available/example1.com /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/example2.com /etc/nginx/sites-enabled/

删除默认站点（可选但推荐）

如果您想防止Nginx的默认占位符页面干扰，请禁用它：

sudo rm /etc/nginx/sites-enabled/default

您可以稍后通过重新创建符号链接来重新启用它。

第5步：测试Nginx配置

在重启Nginx之前，始终验证您的配置文件是否存在语法错误。配置错误的文件可能会导致服务器上的所有站点瘫痪。

sudo nginx -t

成功的测试返回：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

如果您看到错误，Nginx将指示问题发生的文件和行号。在继续之前，查看相关配置文件并更正任何拼写错误或缺失的分号。

第6步：重启Nginx以应用更改

配置测试通过后，重新加载或重启Nginx以应用您的更改：

sudo systemctl restart nginx

或者，使用reload进行优雅重启，不会中断活动连接：

sudo systemctl reload nginx

第7步：访问您的网站

如果DNS已配置

如果您的域名已通过DNS A记录指向您的服务器IP地址，只需打开浏览器并导航到：

http://example1.com
http://example2.com

您应该看到在第2步中创建的相应”欢迎”消息。

用于本地测试（无DNS）

如果您在本地测试或DNS尚未传播，您可以通过编辑本地计算机的/etc/hosts文件（在Linux/macOS上）或C:WindowsSystem32driversetchosts（在Windows上）来模拟域名解析。

使用提升的权限打开文件：

sudo nano /etc/hosts

添加以下行，将YOUR_SERVER_IP替换为您的实际服务器IP：

YOUR_SERVER_IP example1.com www.example1.com
YOUR_SERVER_IP example2.com www.example2.com

保存文件并在浏览器中测试。一旦您的真实DNS记录生效，请记得删除这些条目。

第8步：使用Let’s Encrypt启用HTTPS（推荐）

在生产环境中，通过纯HTTP运行网站已不再可接受。HTTPS加密您的服务器和访问者之间的流量，改进SEO排名，并且是现代浏览器功能所必需的。Let’s Encrypt提供免费的、自动可续期的SSL/TLS证书。

> 更喜欢高级SSL解决方案？ AlexHost提供受信任的SSL证书，适合需要扩展验证或通配符覆盖的企业。

安装Certbot

sudo apt install certbot python3-certbot-nginx

获取并安装SSL证书

为每个域运行Certbot。--nginx插件会自动修改您的Nginx配置以启用HTTPS：

sudo certbot --nginx -d example1.com -d www.example1.com

sudo certbot --nginx -d example2.com -d www.example2.com

按照交互式提示进行操作。Certbot将：

通过HTTP质询验证域名所有权
从Let’s Encrypt获取签名证书
自动更新您的Nginx server block以监听端口443
配置HTTP到HTTPS重定向

验证自动续期

Let’s Encrypt证书每90天过期一次。Certbot安装一个systemd计时器来自动处理续期。使用以下命令测试它：

sudo certbot renew --dry-run

如果干运行完成没有错误，您的证书将自动续期，无需任何手动干预。

您更新的Server Block将看起来像什么

Certbot运行后，您的配置将自动更新为类似以下内容：

server {
    listen 443 ssl;
    server_name example1.com www.example1.com;

    root /var/www/example1.com/html;
    index index.html;

    ssl_certificate /etc/letsencrypt/live/example1.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example1.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    location / {
        try_files $uri $uri/ =404;
    }
}

server {
    listen 80;
    server_name example1.com www.example1.com;
    return 301 https://$host$request_uri;
}

故障排除常见问题

即使进行了仔细的配置，问题仍可能出现。以下是最常见的问题及其解决方法：

502 Bad Gateway

这通常意味着Nginx无法与后端服务通信（例如PHP-FPM或Node.js应用）。验证上游服务正在运行，并且您的配置中的socket/端口是正确的。

403 Forbidden

通常是权限问题。检查www-data是否拥有Web根目录，以及文件权限是否设置正确：

sudo chown -R www-data:www-data /var/www/example1.com
sudo chmod -R 755 /var/www/example1.com

404 Not Found

验证您的server block中的root指令指向正确的目录，以及index.html是否存在于该路径。

加载了错误的站点

如果访问example1.com加载了example2.com的内容，请检查：

每个server_name指令是否唯一且正确
sites-enabled中的符号链接是否有效：ls -la /etc/nginx/sites-enabled/
默认站点是否被禁用（如果有冲突）

配置更改后Nginx无法启动

在重启之前始终运行sudo nginx -t。仔细查看错误输出——它将指向导致问题的确切文件和行。

检查日志

在第3步中配置的每个站点日志是您最好的调试资源：

sudo tail -f /var/log/nginx/example1.com.error.log
sudo tail -f /var/log/nginx/example1.com.access.log

高级考虑事项

托管PHP应用程序

如果您的站点运行PHP（例如WordPress、Laravel），您需要安装PHP-FPM并向您的server block添加fastcgi_pass指令：

location ~ .php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

使用控制面板

通过命令行手动管理Nginx虚拟主机很强大，但在规模上很耗时。如果您更喜欢图形界面，请考虑AlexHost的带cPanel的VPS或探索完整的VPS控制面板范围，以找到适合您工作流的合适选择。

全场主机优惠15%