提交

deploy/docker/README.md

@@ -144,6 +144,7 @@ zkxw-docker-deploy-<版本>/
 │   └── mysql/init/
 ├── docs/sql/zkxw.sql          # 首次部署自动建库用
 ├── 部署说明.md
+├── 部署指导手册.html          # 客户安装手册（浏览器打开，推荐交付）
 └── VERSION.txt
 ```
 
@@ -412,6 +413,10 @@ docker compose up -d
 ### 发版方打包时 pip / pnpm 很慢或超时
 
 - 已默认 **阿里云 PyPI** + **npmmirror**，并启用 BuildKit 缓存。
+- 若前端构建在 `corepack prepare pnpm@...` 报错（请求 `registry.npmjs.org` 失败），请更新到含 `COREPACK_NPM_REGISTRY` 的 Dockerfile，或手动指定：
+  ```bash
+  NPM_REGISTRY=https://registry.npmmirror.com ./scripts/package-docker-deploy.sh v1.0.0
+  ```
 - **在 Mac（M 芯片）上交叉构建 `linux/amd64` 很慢**（后端 pip 常见 15～40 分钟），日志会长时间不动，**不要误按 Ctrl+C**。
 - **推荐**：把仓库放到 **Linux x86 云主机**（与甲方同架构），在该机器执行 `./scripts/package-docker-deploy.sh`，通常 5～15 分钟完成。