fix: 后端容器挂载 frontend/dist;更新文档补两个生产坑

- docker-compose.yml:backend 加挂 ./frontend/dist:/app/frontend/dist:ro,
  否则后端只提供 API 不提供前端,刷新 SPA 路由报 {"detail":"Not Found"}。
- PRODUCTION_UPDATE.md 常见问题补三条:readonly database(非 root
  appuser 写不动旧 root 建的数据卷,宿主机 chown -R 999:999)、
  前端 404(缺 dist 挂载)、组件在位 Raw IPMI data file not found
  (旧版写 /tmp,重启即丢,新版已存持久卷)。
This commit is contained in:
2026-11-16 13:09:54 +08:00
parent 6e93a86fc2
commit 9bf8b2e65f
2 changed files with 30 additions and 0 deletions
+29
View File
@@ -169,3 +169,32 @@ A:`frontend/dist/` 没重新构建。按第五节 `npm run build` 后再 `bash
**Q:登录后看不到主机或数据?**
A:检查 `REQUIRE_EXISTING_DATABASE` 和 `MIN_EXPECTED_HOSTS` 是否误设;
确认后端日志没有数据库路径错误;确认数据卷挂载的是正确的 volume。
**Q:后端反复重启,日志报 `attempt to write a readonly database`?**
A:新版后端以非 root 用户 `appuser`(UID 999)运行,而数据卷里的数据库文件
是旧版 root 用户创建的,`appuser` 写不进去。在宿主机上改属主后重启:
```bash
chown -R 999:999 /var/lib/docker/volumes/ipmi-monitor_backend-data/_data
bash start.sh
```
(卷名以 `docker volume ls | grep ipmi` 为准;UID 以 `docker run --rm ipmi-monitor-backend:latest id appuser` 为准。)
注意:在容器里 `chown` 会报 Operation not permitted,必须在宿主机上做。
**Q:登录后点不动、刷新报 `{"detail":"Not Found"}`?**
A:后端容器里没有前端文件。`docker-compose.yml` 必须把 `frontend/dist`
挂进后端容器(v1.3.0 起已包含此挂载):
```yaml
volumes:
- backend-data:/app/data
- ./frontend/dist:/app/frontend/dist:ro
```
改完 `bash start.sh` 重启即可。
**Q:组件在位监控报 `Raw IPMI data file not found`?**
A:旧版把原始 IPMI 数据写在 `/tmp`,容器重启就清空。新版已改为存在
SQLite 旁的持久卷,重启不再丢失;尚未采集时页面显示 No Data,不再报错。
更新到最新版即可。
+1
View File
@@ -36,6 +36,7 @@ services:
- "${BACKEND_PORT:-8000}:8000"
volumes:
- backend-data:/app/data
- ./frontend/dist:/app/frontend/dist:ro
environment:
- TZ=Asia/Shanghai
- ENVIRONMENT=${ENVIRONMENT:-production}