Docker 数据持久化说明
# Docker
Docker 部署时 默认只挂载一个目录,不是分别映射「数据库文件夹」和「附件文件夹」两个卷。
挂载对应关系
宿主机容器内任意目录或 named volume(如 jiang13-data)/data
示例:
docker run -d --name jiang13 \
-p 3000:3000 \
-v /你的路径/jiang13-data:/data \
--restart unless-stopped \
hangzhang714128/jiang13-forum:latest或在 docker-compose.yml 中:
volumes:
- jiang13-data:/data
# 或绑定宿主机目录:
# - ./data:/data/data 目录结构
数据库与附件都在同一个 /data 挂载内:
/data/
├── jiang13.db # SQLite 主数据库
├── uploads/ # 附件根目录
│ ├── avatars/ # 用户头像
│ └── posts/ # 帖子图片等
├── .jwt_secret # JWT 密钥(自动生成)
├── filter_words.txt # 敏感词配置
└── jiang13.log # 运行日志(若启用)用途路径数据库/data/jiang13.db附件/data/uploads/
官方镜像不要求拆成两个 volume;挂好 /data 即可同时持久化 SQLite 与上传文件。
设计说明:为何只挂一个 /data
对本项目(单容器、SQLite、默认可本地存附件)而言, 一个数据卷是合理默认:
- 部署成本最低,不易漏挂导致「重启丢图 / 丢库」
- 备份、迁移时拷贝或快照整个
/data即可恢复站点状态 - 密钥(
.jwt_secret)、敏感词与库同目录,避免「库还在、登录全失效」这类半残状态
若你习惯「数据库文件夹 / 附件文件夹」分开填写:在本镜像中它们分别是 /data 下的文件与子目录,不是两个独立容器路径。
附件特别大、希望对象存储时:优先使用管理后台的 S3 兼容存储,而不是拆 Docker 卷。
后续计划(可选增强,非必须)
按优先级,仅在有明确需求时做:
-
文档与面板提示(优先)
- README / 1Panel 说明中固定话术:「只需挂载
/data;数据库=jiang13.db,附件=uploads/」。- 本页保持为权威说明,避免用户误以为漏了一个卷。
-
进阶:同一 DataDir 下拆挂子路径(文档级,无需改代码)
若必须把库与附件分到不同宿主机磁盘,可在仍使用容器
/data的前提下分别绑定,例如:volumes: # 推荐:父目录一次挂载
- /ssd/jiang13:/data
或仅把附件分到大容量盘(需保证 /data 下其余文件仍可写)
- /ssd/jiang13:/data
- /hdd/jiang13-uploads:/data/uploads
拆挂时仍要保证 `/data` 下 `.jwt_secret` 等文件可写;不熟悉 Docker 时请继续只用单个 `/data` 挂载。
1. **产品级:可配置上传根目录(中期)**
\- 环境变量或 `app.ini` 支持 `upload_dir` 与 `data_dir` 分离。
\- Docker 示例改为可选双卷; **默认仍单卷**,避免破坏现有部署。
2. **不做的事**
\- 不为「看起来像 WordPress」而强制双卷。
\- 不在未支持分离配置前,在 UI 里假装有两个独立数据根。登录后查看评论
去登录