wangchuanli
10db94c162
## 现象
容器跑着跑着页面全部 500，应用日志：
sqlite3.OperationalError: unable to open database file
(db.py:33, conn.execute("PRAGMA journal_mode=WAL"))
## 根因（已最小复现）
数据原本用绑定挂载（./data:/app/data）。Windows + Docker Desktop 的绑定挂载走 9p
（mount 里是 type 9p, aname=drvfs;path=C:\）。9p 本身支持 WAL（新建库能开 WAL），
但**宿主的 Windows 进程打开过这个 WAL 库之后**，容器侧缓存的 -shm 映射就失效，
下一次连接无法重建共享内存文件 → 打不开数据库，且**不会自愈**。
复现：
docker compose -f docker-compose.yml -f docker-compose.hostdir.yml up -d
docker compose exec portal python -c "..." # OK, 1665 条
python manage.py stats # 宿主侧纯读一次
docker compose exec portal python -c "..." # ERR unable to open database file
# 只有 docker compose restart portal 才恢复
## 处理
- docker-compose.yml 改用命名卷 wb_data / wb_logs（容器独占 /app/data）
- 新增 docker-compose.hostdir.yml 叠加层：需要宿主目录时用
docker compose -f docker-compose.yml -f docker-compose.hostdir.yml up -d
（注明**只建议 Linux**；Linux 的 bind mount 与容器同一文件系统，无此问题）
- 数据迁移：docker run --rm -v workbuddy-portal_wb_data:/to -v "$PWD/data":/from:ro \
alpine:3.20 sh -c 'cp -a /from/. /to/'
- 文档同步：DEPLOYMENT 2.4/5.4/第六节全部改为命名卷 + 备份恢复用 docker run；
新增第九节「Windows 绑定挂载的坑」（含复现步骤）；FAQ、USER-GUIDE、README、CHANGELOG 同步
## 验证
- 宿主跑 manage.py stats 与 smoke.py 之后，容器侧仍能正常读写（此前会立刻失效）
- 容器实例 check_live 56/56；离线 smoke 99/99；hostdir 叠加层 config 校验通过
37 行
1.6 KiB
Bash
37 行
1.6 KiB
Bash
# =============================================================================
|
|
# docker-compose 环境变量样例：复制成 .env 后按需修改（.env 已被 .gitignore 排除）
|
|
# cp .env.example .env
|
|
# =============================================================================
|
|
|
|
# ---------- 监听 ----------
|
|
# 宿主机绑定地址：0.0.0.0 = 局域网可访问；127.0.0.1 = 只允许本机
|
|
WB_BIND=0.0.0.0
|
|
WB_PORT=8848
|
|
TZ=Asia/Shanghai
|
|
|
|
# ---------- 首个管理员（只在数据库为空时生效）----------
|
|
# 强烈建议：首次启动前就设好，避免用默认的 admin/admin123 暴露在局域网上
|
|
WB_ADMIN_USER=admin
|
|
WB_ADMIN_PASSWORD=
|
|
|
|
# ---------- 调度 ----------
|
|
# 一个容器一份调度。只有跑多副本时才把除第一份之外的都设成 1。
|
|
WB_DISABLE_SCHEDULER=0
|
|
|
|
# ---------- 可选：启动时自动导入 ----------
|
|
# 1 = 尝试从挂载进来的编辑器 settings.json 读取 codebuddyUsage.* 写入数据库
|
|
WB_IMPORT_CREDS=0
|
|
# 指向容器内路径；配合 docker-compose.yml 里注释掉的挂载项使用
|
|
WB_IMPORT_XLSX=
|
|
|
|
# ---------- 镜像名（推送 Gitea 注册表时用）----------
|
|
# WB_IMAGE=git.iwali.top/wangchuanli/workbuddy-portal:latest
|
|
# WB_IMAGE=git.iwali.top/wangchuanli/workbuddy-portal:1.1.0
|
|
|
|
# ---------- 仅叠加 docker-compose.hostdir.yml 时有效 ----------
|
|
# 把数据/日志放到宿主机目录而不是命名卷。**只建议 Linux 宿主机使用**：
|
|
# Windows + Docker Desktop 的 9p 挂载下，宿主进程访问过 WAL 库之后，
|
|
# 容器侧会打不开数据库且不自愈（详见 docs/DEPLOYMENT.md）。
|
|
# WB_HOST_DATA_DIR=./data
|
|
# WB_HOST_LOG_DIR=./logs
|