Nexus/docs/changelog/2026-06-06-docker-install-wizard-in-image.md

2026-06-06 — 生产镜像内置 install.html + 升级校验

摘要

修复 Docker 生产镜像缺少安装向导静态页导致 /app/install.html 404；构建时校验文件存在；升级脚本自动检测并可用 sync-install-wizard-to-container.sh 兜底。

动机

Vite 构建产物仅含 SPA index.html，install.html 需单独 COPY；此前依赖手工 docker cp，容器重建后丢失。

涉及文件

• Dockerfile.prod — COPY install.html + vendor，RUN test -f 构建门控
• deploy/sync-install-wizard-to-container.sh（新建）
• deploy/nexus-1panel.sh — verify_install_wizard
• deploy/README-1panel.md · docker/README.md
• deploy/install-nexus-fresh.sh — chmod 同步脚本

迁移 / 重启

已部署服务器需：

cd /opt/nexus && git pull
bash deploy/nexus-1panel.sh upgrade

验证

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8600/app/install.html  # 200
docker exec nexus-prod-nexus-1 test -f /app/web/app/install.html