宝塔面板v8.0起支持nginx多版本切换，应优先通过软件商店操作；手动编译需严格使用官方nginx5.sh脚本，确保参数、路径、模块及后续配置同步，否则易致服务异常。
直接用宝塔软件商店升级就行，别手动编译
宝塔面板从 v8.0 开始就内置了 Nginx 多版本切换能力，软件商店 → 已安装 → Nginx → 设置 → 版本安装切换 里点几下就能换。你看到的“手动编译勾选最新分支”这种说法，其实是把开发场景当生产用了——新版分支（比如 main 或 stable-1.27）没经过宝塔测试，编译参数、模块依赖、路径硬编码都可能不匹配，装完大概率 nginx -t 报错或面板无法接管服务。
真要编译，必须用宝塔官方 nginx5.sh 脚本
宝塔提供过公开的编译脚本 nginx5.sh，它会自动处理用户组、模块开关、路径适配和 systemd 单元注册，比自己写 ./configure 安全得多。自己手敲命令容易漏掉关键项：
-
--user=www --group=www必须和宝塔默认一致，否则站点日志写入失败 -
--prefix=/www/server/nginx不能改，否则面板找不到二进制和配置目录 -
--with-http_v2_module和--with-http_v3_module要按需启用，但nginx5.sh install 1.26已预设好常用组合 - 编译后不会自动重载配置，得手动执行
bt reload nginx，否则还是跑旧版
升级前先确认当前编译参数是否支持目标功能
比如你想开 HTTP/3，光换到 1.26 不够，得验证 QUIC 模块真被编译进去了：
- 运行
nginx -V 2>&1 | grep with-http_v3-module，有输出才说明模块可用 - 如果没输出，
nginx5.sh install 1.26重装一次，别自己加--with-http_v3_module—— 宝塔脚本内部已处理 boringssl 依赖和 configure 顺序 - 注意：1.25+ 的 QUIC 是实验性功能，生产环境建议先在测试站验证
curl -I --http3 https://yoursite.com
编译升级后最常被忽略的三件事
很多人以为 make install 完就结束了，结果访问报 502 或面板显示“Nginx 未运行”：
- 防火墙没开 UDP 443 —— HTTP/3 必须走 UDP，只放行 TCP 443 没用
-
/www/server/nginx/conf/nginx.conf里的pid路径没同步更新，导致bt restart nginx找不到进程 ID 文件 - 站点配置里漏了
ssl_early_data on;，QUIC 连接会被直接拒绝，浏览器看不到 HTTP/3 标识
