17 lines
1.7 KiB
Markdown
17 lines
1.7 KiB
Markdown
# deploy 目录（与 api 相同：仅替换构建产物；`web` 容器除 `web/public` 外不挂源码目录）
|
||
|
||
- **deploy/web/dist**：前台构建产物，由 `pull-and-restart.sh` 生成；替换此目录内容即可更新前台。
|
||
- **deploy/admin/dist**：后台构建产物，同上。后台 Vite 通过 `@yh-web` 引用 `../web/src`（如积木 `BlockRenderer`），用 Docker 单目录挂载 `admin` 时会构建失败，须挂载**项目根**再在 `admin` 下执行 `npm run build`（见 `pull-and-restart.sh`）。
|
||
- **deploy/api/server**：API 二进制，同上；替换后重启 api 容器生效。
|
||
- **deploy/web/default.conf**、**deploy/admin/default.conf**：Nginx 配置，已纳入版本库。
|
||
|
||
日常更新：在服务器执行 `./pull-and-restart.sh` 会拉代码、重新构建到上述目录并重启容器。若只改静态资源，也可在服务器上手动构建后只重启对应容器。
|
||
|
||
## 后台白屏 / 控制台 “MIME type text/html” 针对 `index-*.js`
|
||
|
||
表示浏览器拿到的不是 JS，而是 HTML（常见：`/assets/*.js` 被 SPA 回退成 `index.html`，或 404 返回了 HTML 错误页）。
|
||
|
||
1. **确认 Nginx 配置已更新**：`deploy/admin/default.conf` 须含 `location ^~ /assets/` 且 `try_files $uri =404`（与仓库内 `admin/nginx.conf` 一致），挂载后重启 `admin` 容器。
|
||
2. **确认 dist 完整**：`deploy/admin/dist/assets/` 下须有与 `index.html` 中 `<script type="module">` 引用**同名**的哈希文件；发版后应**整目录**替换 `dist`（勿只拷 `index.html`）。
|
||
3. **本地重建**：在项目根按 `pull-and-restart.sh` 方式在 `admin/` 执行 `npm run build`，`vite.config` 中 `base` 须为 `'/admin/'`。
|