workbuddy-portal

11 提交 1 分支 4 Git 标签

2 次代码提交

包含重命名

作者	SHA1	备注	提交日期
wangchuanli	3751dffef9	feat: 新增备份恢复与公网加固 - 新增备份管理页与 API：在线快照、自动周期备份、按份数清理、下载、一键恢复（恢复前自动兜底） - 新增 /profile/export，普通用户可导出本人全部数据（不含 Cookie 明文） - 修复 X-Forwarded-For 可伪造导致三道 IP 防线失效，统一走 client_ip() 取客户端地址 - 取消 admin123 硬编码默认口令，留空则生成随机初始口令并仅打印一次 - .dockerignore 排除 backups/ 并加构建期断言，防止密钥随镜像分发 - 新增会话版本号，改密/停用/删除及恢复备份后其他会话立即失效 - 新增容器资源上限、采集跨度硬顶 31 天、重操作最小间隔与并发 409 - 新增访问日志、HSTS 条件下发、口令黑名单、验证码抗模板匹配、instance.json 0600 - 版本号升至 1.4.0，同步更新 README、SECURITY、.env.example 与 compose 配置	2026-09-18 08:46:34 +08:00
wangchuanli	10db94c162	fix(docker): 数据改用 Docker 命名卷，修容器打不开数据库的问题 ## 现象容器跑着跑着页面全部 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 校验通过	2026-09-14 15:09:24 +08:00

作者

SHA1

备注

提交日期

wangchuanli

3751dffef9

feat: 新增备份恢复与公网加固

- 新增备份管理页与 API：在线快照、自动周期备份、按份数清理、下载、一键恢复（恢复前自动兜底）
- 新增 /profile/export，普通用户可导出本人全部数据（不含 Cookie 明文）
- 修复 X-Forwarded-For 可伪造导致三道 IP 防线失效，统一走 client_ip() 取客户端地址
- 取消 admin123 硬编码默认口令，留空则生成随机初始口令并仅打印一次
- .dockerignore 排除 backups/ 并加构建期断言，防止密钥随镜像分发
- 新增会话版本号，改密/停用/删除及恢复备份后其他会话立即失效
- 新增容器资源上限、采集跨度硬顶 31 天、重操作最小间隔与并发 409
- 新增访问日志、HSTS 条件下发、口令黑名单、验证码抗模板匹配、instance.json 0600
- 版本号升至 1.4.0，同步更新 README、SECURITY、.env.example 与 compose 配置

2026-09-18 08:46:34 +08:00

wangchuanli

10db94c162

fix(docker): 数据改用 Docker 命名卷，修容器打不开数据库的问题

## 现象
容器跑着跑着页面全部 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 校验通过

2026-09-14 15:09:24 +08:00