unillett/bookstack

Bookstack Docker镜像文档

镜像概述

本Docker镜像用于部署和运行https://github.com/BookStackApp/BookStack%E5%BA%94%E7%94%A8%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BA%86%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E5%92%8C%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E7%9A%84%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E6%96%B9%E6%A1%88%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87Docker Compose快速构建和运行应用服务。

核心功能与特性

• 支持开发环境和生产环境分离配置
• 集成数据库初始化与数据导入功能
• 包含MailHog邮件测试服务
• 提供自动化构建和版本更新机制
• 支持Helm图表部署（适用于Kubernetes环境）

使用场景

• 个人或团队文档管理系统部署
• 开发环境快速搭建与测试
• 生产环境容器化部署
• 需要邮件通知功能的文档协作平台

详细使用方法

开发环境配置

前置要求

需先安装Docker环境。

配置环境文件

1. 复制环境示例文件并重命名为.env：

   bash
   cp example.env .env
   

   默认值适用于本地开发，如有需要可修改配置值。

2. 复制开发环境的docker-compose覆盖文件：

   bash
   cp docker-compose.override.yml.dev docker-compose.override.yml
   

   默认配置适用于本地开发，可根据需求调整。

配置主机文件

编辑主机文件，将bookstack.lan指向Docker主机IP。

数据库初始化（可选）

如需自动导入Bookstack数据库，可将数据库备份文件放入import文件夹，并命名为import.sql。数据库内容将在mysql-data卷首次创建时自动导入。

构建与运行

构建并启动所有容器：

bash
docker-compose up  # 如需后台运行并静默日志，添加-d参数

访问应用

• 主应用：[***]

  • 默认管理员账号：*** / password

• MailHog邮件测试：[***]

  • JSON格式邮件消息API：[***]

生产环境部署

1. 复制环境文件：

   bash
   cp example.env .env
   

   必须修改默认值，默认配置不适用于生产环境。

2. 复制生产环境的docker-compose覆盖文件：

   bash
   cp docker-compose.override.yml.prod docker-compose.override.yml
   

   默认配置适用于生产环境，如有需要可调整。

3. 构建并后台运行容器：

   bash
   docker-compose up -d
   

4. 配置反向代理，将访问域名映射到容器的8282端口。

应用更新

版本更新机制

通过修改https://github.com/unil-lettres/bookstack/blob/main/VERSION%E6%96%87%E4%BB%B6%E4%B8%AD%E7%9A%84%E6%A0%87%E7%AD%BE%E5%80%BC%E8%A7%A6%E5%8F%91https://github.com/unil-lettres/bookstack/blob/main/.github/workflows/docker.yml%EF%BC%8C%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89%E9%95%9C%E5%83%8F%E5%B9%B6%E6%8E%A8%E9%80%81%E5%88%B0https://hub.docker.com/repository/docker/unillett/bookstack/general%E3%80%82

• 当https://github.com/BookStackApp/BookStack/releases%E5%8F%91%E5%B8%83%E6%97%B6%EF%BC%8C%E6%9B%B4%E6%96%B0VERSION%E6%96%87%E4%BB%B6%E4%B8%AD%E7%9A%84%E6%A0%87%E7%AD%BE%E5%80%BC
• 推送更改后，工作流将自动构建新镜像并推送至Docker Hub

自定义镜像版本

如需触发重建或标记自定义镜像版本，可在VERSION文件的值中添加修订后缀（如-rev1）。该后缀在获取BookStack源代码时会被忽略，但可用于区分工作流中的构建和Docker镜像标签。

Docker镜像标签规则

GitHub Actions工作流根据以下事件生成Docker镜像标签：

• 推送到development分支：stage-latest、stage-<sha>-<timestamp>（不可变）
• 推送到main分支：latest
• 推送git标签：vX.Y.Z（不可变，基于VERSION文件）

定时任务生成的镜像

每周定时任务将创建：

• 更新的测试环境镜像：stage-<sha>-<timestamp>（不可变）
• 更新的生产候选镜像：vX.Y.Z-<sha>-<timestamp>（不可变，基于VERSION文件）

所有不可变标签均会提交至https://github.com/unil-lettres/k8s%E3%80%82

Helm部署

本项目的Helm图表位于https://github.com/unil-lettres/k8s%E7%9A%84%60wlett%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E3%80%82