Nginx 虚拟主机配置教程:一台服务器部署多个网站的完整步骤与常见问题

适用场景与准备工作

一台云服务器只跑一个网站,端口、目录、配置全绑死在一处,成本高也不便于管理。更常见的做法是利用 Nginx 的虚拟主机(Virtual Host)功能,在一台服务器上同时托管多个网站:每个网站有独立的域名、独立的站点目录和独立的配置文件,互不影响。无论是企业官网加博客、多个客户站点共用一台机器,还是测试环境与生产环境分离,都属于典型适用场景。

需要提醒的是,如果服务器在国内,每个绑定在该服务器上的域名都需要各自完成工信部备案,未备案域名即使配置正确也可能被接入商拦截,这一点在规划阶段就要确认。动手之前还需要准备三样东西:一台已安装 Nginx 的 Linux 服务器(本文以 CentOS 与 Ubuntu 通用命令为例,宝塔面板用户的配置目录略有不同,文中会单独说明)、至少一个已完成解析的域名,以及管理员权限。由于要修改 Nginx 配置并重载服务,建议先备份原有配置文件,确认服务器上运行的其他业务不受影响后再操作。

操作第一步:规划站点目录并创建测试页面

清晰的目录规划是后续排错的关键。建议按站点分目录存放,例如 /www/wwwroot/site-a.com 与 /www/wwwroot/site-b.com,每个目录下放置该站点自己的文件。若上级目录 /www/wwwroot 不存在,先执行一次 mkdir /www/wwwroot 创建,再分别为两个站点建目录:

mkdir /www/wwwroot/site-a.com
mkdir /www/wwwroot/site-b.com

目录属主建议与 Nginx 运行用户保持一致(CentOS 一般为 nginx,Ubuntu 为 www-data),否则可能出现 403 权限错误。接着在每个站点目录下放一个简单的测试页面,用于确认新配置指向正确:

echo "site-a" > /www/wwwroot/site-a.com/index.html
echo "site-b" > /www/wwwroot/site-b.com/index.html

宝塔面板用户可以直接在「网站」菜单添加站点,面板会自动完成目录创建、配置生成与权限设置,本文的命令同样适用于理解其底层逻辑。

操作第二步:编写虚拟主机配置文件

Nginx 的虚拟主机通过 server 块实现,一个 server 块就是一个站点。推荐为每个站点单独建一个配置文件,放在 /etc/nginx/conf.d/ 目录(源码编译安装的 Nginx 通常在 /usr/local/nginx/conf/vhost/,宝塔面板在 /www/server/panel/vhost/nginx/),文件名以 .conf 结尾即可被主配置 include 加载。以下是一个最小可用配置:

server {
    listen 80;
    server_name site-a.com www.site-a.com;
    root /www/wwwroot/site-a.com;
    index index.html index.htm;

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

其中 server_name 决定这个站点响应哪些域名的请求,root 决定请求去哪里找文件,try_files 则指定优先匹配实际文件、其次匹配目录、都没有时返回 404。第二个站点复制一份配置,修改 server_name 与 root 即可。注意每个 server 块的 server_name 必须不同,两个配置文件不能绑定同一域名,否则 Nginx 只会命中先加载的那一个。

操作第三步:检查语法并重载 Nginx

配置文件写好后,先不要急着重载,务必用 nginx -t 做语法检查。这一步能在影响线上业务之前发现括号不闭合、分号缺失等问题:

nginx -t

返回 syntax is ok 与 test is successful 后再执行重载。reload 是平滑重载,不会中断已有连接,比重启服务安全:

systemctl reload nginx

如果 nginx -t 报错,错误信息会明确指出哪个文件、哪一行有问题,修正后重新检查即可。若重载后新配置未生效,先确认改的是 Nginx 实际加载的目录,而不是另一个安装位置遗留的配置。

操作第四步:域名解析与访问验证

解析层面,只需把各域名的 A 记录指向服务器公网 IP,等待解析生效后即可访问。在服务器本地可以先用 curl 指定 Host 头验证配置是否命中正确的站点目录,不必等解析:

curl -I -H "Host: site-a.com" http://127.0.0.1

再验证第二个站点:

curl -I -H "Host: site-b.com" http://127.0.0.1

两条命令应分别返回 200 且对应各自站点的测试页内容。解析生效后,再通过浏览器实际访问两个域名,确认互不串站。如果域名解析已生效、本地 curl 也正常,但外网依然打不开,重点检查云服务器安全组与系统防火墙是否放行了 80 端口,这是多站点部署后被高频忽略的一环。如果网站后续要启用 HTTPS,为每个域名单独申请证书并配置对应的 443 监听 server 块即可,注意证书域名需与该站点的 server_name 匹配。

Nginx 多站点虚拟主机配置:服务器机房与网站基础设施
多站点部署前建议确认服务器网络与目录规划

常见问题与总结

1. 两个域名打开都是同一个网站?这是因为请求命中了默认站点:Nginx 对未匹配到 server_name 的请求,会交给第一个加载的 server 块(或标记了 default_server 的块)处理。检查两个配置文件的 server_name 是否写全、写错,确认没有把两个域名写进同一个 server_name 行。

2. 新站点访问返回 404?依次检查三项:root 路径是否与真实目录一致、目录下是否存在 index 指定的文件(多数是 index.html 或 index.php)、try_files 写法是否正确。路径中有一个字母写错就会导致 404,建议直接复制配置里的路径到命令行用 ls 验证。

3. 修改配置后网站全部无法访问?说明新配置存在语法错误导致 Nginx 重载失败。养成修改前备份的习惯(cp xxx.conf xxx.conf.bak),出错时立即还原备份并重载,先恢复业务再排查问题,切忌在未备份的情况下直接覆盖线上配置。

4. 宝塔面板添加的站点和手动配置冲突怎么办?宝塔用户的站点配置由面板统一管理,建议全程在面板「网站」菜单操作,避免手动写入面板的 vhost 目录;确实需要手动改的,先在面板内备份该站点配置,改完用面板的重载功能生效,防止下次面板操作时覆盖手工修改。

总结:Nginx 虚拟主机的核心是「一个 server 块一个站点」,按独立目录、独立配置、独立域名三个原则规划,每一步先用 nginx -t 验证再重载,多站点部署就可以做到清晰可控、互不影响。

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容