[Bug] OpenResty upgrade failed due to missing WEBSITE_DIR, causing /www mount error and rollback failure

[LHY0125]

环境

• 1Panel 版本:v2.2.4(全新安装,约 2026 年 2 月)
• 系统:Ubuntu 24.04
• OpenResty 版本:1.29.2.5-0-noble → 1.31.1.1-2-2-noble

问题描述

在应用商店升级 OpenResty(1.29.2.5 → 1.31.1.1),镜像拉取成功,但启动容器失败,随后回滚也失败。完整日志:

2026/08/04 17:29:17 升级应用 [openresty] 任务开始 [START]
2026/08/04 17:29:17 备份应用 [openresty] 成功
2026/08/04 17:29:23 开始拉取镜像 [1panel/openresty:1.31.1.1-2-2-noble]
2026/08/04 17:30:01 拉取镜像 成功
2026/08/04 17:30:12 开始执行 upgrade 脚本
2026/08/04 17:30:12 执行 upgrade 脚本 成功
2026/08/04 17:30:12 启动 应用
2026/08/04 17:30:12 升级应用 [openresty] 失败: stderr: time="2026-08-04T17:30:12+08:00" level=warning msg="The \"WEBSITE_DIR\" variable is not set. Defaulting to a blank string."
time="2026-08-04T17:30:12+08:00" level=warning msg="The \"WEBSITE_DIR\" variable is not set. Defaulting to a blank string."
time="2026-08-04T17:30:12+08:00" level=warning msg="The \"WEBSITE_DIR\" variable is not set. Defaulting to a blank string."
invalid spec: :/www: empty section between colons
, err: exit status 1
2026/08/04 17:30:12 应用 openresty 回滚
2026/08/04 17:30:12 应用 openresty 回滚 失败 : stderr: time="2026-08-04T17:30:12+08:00" level=warning msg="The \"WEBSITE_DIR\" variable is not set. Defaulting to a blank string."
time="2026-08-04T17:30:12+08:00" level=warning msg="The \"WEBSITE_DIR\" variable is not set. Defaulting to a blank string."
time="2026-08-04T17:30:12+08:00" level=warning msg="The \"WEBSITE_DIR\" variable is not set. Defaulting to a blank string."
invalid spec: :/www: empty section between colons
, err: exit status 1
2026/08/04 17:30:13 应用 openresty 回滚 成功
2026/08/04 17:30:14 [TASK-END]

根因分析(供参考)

升级模板 docker-compose.yml 中使用了 ${WEBSITE_DIR} 做挂载:

volumes:
  - ${WEBSITE_DIR}:/www
  - ${WEBSITE_DIR}/conf.d:/usr/local/openresty/nginx/conf/conf.d/
  - ${WEBSITE_DIR}/stream.d:/usr/local/openresty/nginx/conf/stream.d/

但现有 openresty 应用实例的 env 中没有设置 WEBSITE_DIR,导致变量展开为空 → 挂载变成 :/www → docker 拒绝启动。

关键点:当前正常运行的旧容器是用绝对路径挂载的(/opt/1panel/www -> /www),说明旧版本/旧实例不依赖该 env;而新模板要求该 env,但实例 env 里缺失,导致升级和回滚都失败。

复现步骤

1. 应用商店 → OpenResty → 升级(1.29.2.5 → 1.31.1.1)
2. 镜像拉取成功后,启动容器报错(见上日志)
3. 升级失败后回滚,回滚同样报 :/www 错误

期望行为

• 升级时应正确使用 /opt/1panel/www 作为 WEBSITE_DIR 的值,或在升级前校验该变量
• 回滚不应失败(回滚失败会导致服务长时间不可用风险)

[LHY0125]

补充一个排查后发现的关键信息,修正上面的根因分析:

进一步检查应用实例的 env 文件(/opt/1panel/apps/openresty/openresty/.env)发现,WEBSITE_DIR 变量其实是存在的,且值正确:

WEBSITE_DIR=/opt/1panel/www

因此根因不是"变量缺失",而是 1Panel 升级流程未能正确加载/传递实例 env 中的 WEBSITE_DIR 到 docker-compose,导致 ${WEBSITE_DIR} 在升级时展开为空 → 挂载变成 :/www → 容器启动失败。

即:现有实例配置本身是完整的(旧容器也一直用 /opt/1panel/www 挂载正常运行),问题出在升级脚本对 env 的读取/传递环节。这比"变量缺失"更能帮助定位 bug。

[zhengkunwang223]

.env 文件中存在
启动就应该没问题
有环境可以看看吗？

[LHY0125]

拿到决定性证据,可以直接定位根因。

数据库 app_installs 表中,openresty 应用实例的 env 字段内容如下:

{"CONTAINER_NAME":"1Panel-openresty-rvNY","CPUS":1,"MEMORY_LIMIT":"1G","PANEL_APP_PORT_HTTP":80,"PANEL_APP_PORT_HTTPS":443}

注意:其中没有 WEBSITE_DIR。

同时发现该实例在数据库中记录的版本是 1.21.4.3-3-3-focal(虽然实际运行/界面显示的是 1.29.2.5),说明这个应用实例是较早期(旧模板时代)创建/安装的,当时 data.yml 尚未引入 WEBSITE_DIR 参数。

完整根因推断:

1. 实例的数据库 app_installs.env 记录没有 WEBSITE_DIR 字段(因为应用创建于旧模板时代)
2. 实例目录下的 .env 文件虽然有 WEBSITE_DIR=/opt/1panel/www,但升级流程读取的是数据库 env 记录,不是 .env 文件
3. 升级到 1.31.1.1 后,新模板 docker-compose.yml 引入 ${WEBSITE_DIR} 挂载,但数据库 env 里没有该变量 → 展开为空 → :/www 挂载错误

建议方向: 1Panel 升级应用时,对旧实例缺失的 env 字段(data.yml 里 required: true 的参数)做兼容处理——或从 .env 文件补齐,或用 data.yml 的 default 值兜底。否则旧版创建的实例升级到新版 openresty 都会失败。

[zhengkunwang223]

我看了一下代码 WEBSITE_DIR 的特殊处理部分被误删了
我们会在下个版本恢复

[wanghe-fit2cloud]

v2.2.5 版本已发布。