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:
@@ -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,不再报错。
|
||||
更新到最新版即可。
|
||||
|
||||
@@ -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}
|
||||
|
||||
Reference in New Issue
Block a user