Linux下Nginx通过分离server块或include不同配置文件实现测试与生产环境的server_name隔离,需同步处理DNS、SSL证书、root路径权限,并用nginx -t验证后reload生效。

Linux 下 Nginx 为测试环境和生产环境配置不同的 server_name,核心在于**分离配置、隔离作用域、避免冲突**。不是靠一个配置文件硬编码两个环境,而是通过结构化管理实现环境区分。
按环境拆分 server 块(推荐)
在同一份主配置(如 /etc/nginx/nginx.conf)中,用独立的 server 块分别定义测试与生产域名,Nginx 会根据请求 Host 头自动路由:
- 测试环境块监听测试域名(如
test.example.com或dev.example.com),根目录指向测试代码路径(如/var/www/test) - 生产环境块监听正式域名(如
www.example.com、example.com),根目录指向生产路径(如/var/www/prod) - 两者可共用同一端口(如
listen 80或listen 443 ssl),只要server_name不重叠,Nginx 就能精准匹配
用 include 按环境加载配置文件
更清晰的做法是把不同环境的配置放在独立文件中,再用 include 引入:
- 创建
/etc/nginx/conf.d/test.conf,只写测试环境的server块(含server_name test.example.com) - 创建
/etc/nginx/conf.d/prod.conf,只写生产环境的server块(含server_name example.com www.example.com) - 确保主配置里有
include /etc/nginx/conf.d/*.conf;,Nginx 启动时自动合并 - 上线生产时,可临时移除或重命名
test.conf,无需改动主配置
结合变量或条件判断(谨慎使用)
不建议在 server_name 中直接写变量(如 $env),因为该指令不支持运行时变量解析。但可通过以下方式间接控制:
- 用环境变量生成配置:部署时用脚本(如 Bash/Ansible)替换模板中的占位符,生成对应环境的
.conf文件 - 利用
map指令做请求分流:例如根据 Host 或请求头映射到不同后端,适合灰度发布场景,但不替代server_name的基础路由功能 - 注意:Nginx 配置加载是静态的,reload 时才生效,不能像应用层那样动态读取系统环境变量来切换
server_name
配套要点不能漏
光配对 server_name 不够,还需同步处理:
- DNS 解析:测试域名需在本地 hosts 或内网 DNS 解析到服务器 IP,生产域名走公网 DNS
-
SSL 证书:测试环境可用自签名证书或泛域名证书的子域名;生产环境必须用受信 CA 签发的有效证书,且
ssl_certificate路径要对应 -
root 和权限:两个
server块的root目录应严格隔离,防止路径穿越或误读代码 -
验证配置:每次修改后执行
nginx -t,确认语法正确再nginx -s reload


















