Docker 数据持久化说明

约 5 分钟 读完

Docker 数据持久化说明

101 浏览 1 评论 约 5 分钟 读完

发布于

# Docker

Docker 部署时 默认只挂载一个目录,不是分别映射「数据库文件夹」和「附件文件夹」两个卷。

挂载对应关系

宿主机容器内任意目录或 named volume(如 jiang13-data)/data

示例:

plaintext
docker run -d --name jiang13 \
  -p 3000:3000 \
  -v /你的路径/jiang13-data:/data \
  --restart unless-stopped \
  hangzhang714128/jiang13-forum:latest

或在 docker-compose.yml 中:

yaml
volumes:
  - jiang13-data:/data
  # 或绑定宿主机目录:
  # - ./data:/data

/data 目录结构

数据库与附件都在同一个 /data 挂载内:

plaintext
/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 卷。

后续计划(可选增强,非必须)

按优先级,仅在有明确需求时做:

  1. 文档与面板提示(优先)

       - README / 1Panel 说明中固定话术:「只需挂载 /data;数据库= jiang13.db,附件= uploads/」。

       - 本页保持为权威说明,避免用户误以为漏了一个卷。

  2. 进阶:同一 DataDir 下拆挂子路径(文档级,无需改代码)

       若必须把库与附件分到不同宿主机磁盘,可在仍使用容器 /data 的前提下分别绑定,例如:

    yaml
    volumes:
      # 推荐:父目录一次挂载
  • /ssd/jiang13:/data

或仅把附件分到大容量盘(需保证 /data 下其余文件仍可写)

  • /ssd/jiang13:/data
  • /hdd/jiang13-uploads:/data/uploads
plaintext
 
拆挂时仍要保证 `/data` 下 `.jwt_secret` 等文件可写;不熟悉 Docker 时请继续只用单个 `/data` 挂载。
 
1. **产品级:可配置上传根目录(中期)**
 
      \- 环境变量或 `app.ini` 支持 `upload_dir` 与 `data_dir` 分离。
 
      \- Docker 示例改为可选双卷; **默认仍单卷**,避免破坏现有部署。
 
2. **不做的事**
 
      \- 不为「看起来像 WordPress」而强制双卷。
 
      \- 不在未支持分离配置前,在 UI 里假装有两个独立数据根。

登录后查看评论

本站评论仅对登录用户开放。

去登录