一次检查里,成功和警告同时出现
上周给阿里云那台 OpenResty 做例行检查,docker exec openresty nginx -t 的输出是这样:
[warn] "listen ... http2" is deprecated, use the "http2" directive instead in ... 00.default.conf:8
[warn] conflicting server name "_" on 0.0.0.0:80, ignored
[warn] conflicting server name "127.0.0.1" on 0.0.0.0:80, ignored
[warn] conflicting server name "_" on 0.0.0.0:443, ignored
nginx: the configuration file ... syntax is ok
nginx: configuration file ... test is successful
四行 warn 之后是两行 successful。大多数人(包括过去几个月的我)扫到最后一行就收工。但 warning 和 error 的区别不是「要不要管」,而是「nginx 有没有替你丢掉一部分配置」。conflicting server name ... ignored 已经把话说得很明白:有一个 server 块被静默忽略了。
这比直接报错更难发现。站点仍然能访问,直到某天你依赖的默认行为悄悄换了一边。
先别改文件,先问它从哪来
第一个念头是把 00.default.conf 里的 listen 443 ssl http2 改成新写法。但只改这一处,另外三条 conflicting 还在。
打开 /opt/1panel/www/conf.d/00.default.conf,内容看起来很正常:map "" $empty 定义空证书、server_name _、root /usr/share/nginx/html。如果只有这一份,_ 不会和自己冲突,说明还有第二份。
nginx -T 会 dump 合并后的完整配置,每一段前面带 # configuration file /path 注释。用它把每个 server_name 归到源文件:
docker exec openresty nginx -T 2>/dev/null \
| awk '/^# configuration file/{f=$0} /^[[:space:]]*server_name/{print f" | "$0}'
结果里 _ 和 127.0.0.1 各出现两次,来自两个不同目录:
conf.d/00.default.conf | server_name _;
conf.d/default.conf | server_name 127.0.0.1;
conf/default/00.default.conf | server_name _;
conf/default/default.conf | server_name 127.0.0.1;
两套模板,都认为自己该管默认站点
nginx.conf 里挂了两个 include:
include /usr/local/openresty/nginx/conf/conf.d/*.conf;
include /usr/local/openresty/nginx/conf/default/*.conf;
对应宿主机上的两个目录:
| 容器内 | 宿主机 | 谁在写 |
|---|---|---|
conf.d |
/opt/1panel/www/conf.d |
1Panel 的站点与反代配置 |
conf/default |
/opt/1panel/apps/openresty/openresty/conf/default |
OpenResty 应用自带模板 |
conf.d 里那两份是 5 月 19 日的旧副本,conf/default 里是 8 月 26 日的新模板。这台机器上的 OpenResty 是 1.31.8.1(镜像 1panel/openresty:1.31.8.1-2-2-noble),1Panel 是 v2.5.1。升级时应用模板更新了自己目录里的默认 server,却没有清理 1Panel 站点目录里的同名片。
于是同一份职责被写了两遍。nginx 按加载顺序保留第一个,第二个连它的新写法一起 ignore。
被丢掉的那份,恰好是更正确的
对比两份内容,差别不只是 http2 的写法:
| 项 | conf.d(旧,5 月) |
conf/default(新,8 月) |
|---|---|---|
| 监听 | 80 / 443 ssl http2 | 80、443、QUIC,均为 default_server,含 IPv6 |
| HTTP/2 | listen 参数(已废弃) |
http2 on |
| 未知 SNI | 返回默认页,证书 data:$empty |
ssl_reject_handshake on |
| TLS | TLSv1.1 / 1.2 / 1.3 | 由 root_ssl.conf 统一 |
| 证书来源 | 内联空证书 | include ssl/root_ssl.conf |
旧版的 listen ... http2 从 nginx 1.25 起就不推荐;ssl_ciphers aNULL 加空证书是为了「任何 SNI 都能握手」,然后返回一个默认页。新版直接拒绝不认识的 SNI。
所以这 4 条警告造成的真实后果是:升级带来的安全改进被旧文件挡住了。语法检查通过,因为两套配置本身都合法,只是语义重叠。
修复:停用,而不是删除
改之前先备份:
B=/tmp/nginx-conf-backup-$(date +%Y%m%d-%H%M%S)
mkdir -p "$B"
cp -a /opt/1panel/www/conf.d/00.default.conf \
/opt/1panel/www/conf.d/default.conf "$B"/
然后停用旧的两份。这里没有删,而是改名让 *.conf 通配符匹配不到:
mv 00.default.conf 00.default.conf.disabled
mv default.conf default.conf.disabled
理由很朴素:默认 server 的职责没有消失,只是交还给 conf/default。改名保留回滚点,也避免 1Panel 某处仍引用这个路径时直接炸掉。
nginx -t 立刻干净:
nginx: the configuration file ... syntax is ok
nginx: configuration file ... test is successful
nginx -s reload 平滑生效,error.log 里只有 worker 正常收缩的 notice。
验证要覆盖三类路径
只测首页不够,默认 server 的问题恰好出在「非具名」路径上。三类都测:
一、具名站点。 用 --resolve 把每个域名指回 127.0.0.1,避开 DNS 和 ESA 的干扰:
# 把站点域名列表换成自己的,逐个指回源站
for d in site1 site2 site3; do
code=$(curl -sk --resolve "$d.example.com:443:127.0.0.1" \
-o /dev/null -w "%{http_code}" "https://$d.example.com/")
printf "%-28s %s\n" "$d" "$code"
done
16 个站点全部返回 200;其中一台面板站是 307,属于登录跳转,正常。
二、本机默认入口。 /nginx_status 由 conf/default/default.conf 提供,仍返回 200。
三、未知 SNI。 裸 IP 访问 443:
curl -sk -o /dev/null -w "%{http_code}\n" https://127.0.0.1/
# curl: (35) ... 000
修复改变了默认行为,这一点要说清楚
以前用 IP 访问 HTTPS 能拿到一个默认页,现在握手阶段就被拒。这是 ssl_reject_handshake on 的本意,也是这次修复的实质:不是把警告删掉,而是选择「未知 SNI 一律拒绝」。
对现有链路没有影响:ESA 回源带的是域名 SNI,16 个站点实测都正常。但如果有监控、旧客户端或内网脚本用 https://IP 加 Host 头访问,会连不上。动手前应该先确认有没有这种调用方。
稳定之后再清理
跑了一天,确认站点和面板都正常,才把临时文件删掉:/tmp 的备份目录和两份 .disabled。此时 conf.d 里只剩站点配置,默认 server 只有 conf/default 一份。
删除之后没有回滚副本,所以顺序很重要:先验证,再清理。反过来的话,出问题时只能凭记忆重写配置。
最后的结论
nginx -t 的最后一行回答的是「语法能不能读」,warning 回答的是「语义有没有重叠」。后者不会拦住发布,但会悄悄改变哪份配置生效。
这次不是谁写错了配置,而是两套模板在同一台机器上各自演进:一套被升级,一套被遗留。排查的关键不是猜,而是让 nginx 自己说出每个 server_name 来自哪个文件——nginx -T 的 # configuration file 注释就是答案。
下次再看到 conflicting server name,顺序应该是:
- 用
nginx -T把冲突项归到源文件; - 比较两份的语义差异,而不只是消除警告;
- 以可回滚的方式停用其中一份;
- 验证具名、默认、边界三类路径;
- 稳定后再清理备份。
评论交流
欢迎留下你的想法