Nexus/docs/changelog/2026-06-06-1panel-install-wizard-verify-script.md

2026-06-06 — 1Panel 安装向导服务器验收脚本

摘要

新增 deploy/verify-1panel-install-wizard.sh，在 VPS 上一键检查 1panel-network、容器名 sync、安装模式与 /api/install/env-check 预填，便于完成 /app/install.html 五步向导前的排查。

动机

b25d079 已修复 nx update 同步 NEXUS_1PANEL_*_HOST，但外网 HTTPS/OpenResty 与服务器内网状态需分步验证；Agent 无法直连用户 VPS 时，需提供可复制的服务器侧验收命令。

涉及文件

• deploy/verify-1panel-install-wizard.sh — 新建
• deploy/README-1panel.md — 增加「安装向导验收」节

验证

在 1Panel 终端：

cd /opt/nexus && bash deploy/verify-1panel-install-wizard.sh

期望：[PASS] 含 b25d079、1panel-network、步骤 3 db_host=1Panel-mysql-*；失败项按脚本提示执行 nx update --no-cache。

迁移 / 重启

无 DB 迁移。仅文档与脚本，不影响运行中容器。