一次检查里,成功和警告同时出现

上周给阿里云那台 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,顺序应该是:

  1. 用 nginx -T 把冲突项归到源文件;
  2. 比较两份的语义差异,而不只是消除警告;
  3. 以可回滚的方式停用其中一份;
  4. 验证具名、默认、边界三类路径;
  5. 稳定后再清理备份。