digitalmotion/bookstack

BookStack Docker镜像

镜像概述和主要用途

本镜像用于部署和运行https://github.com/ssddanbrown/BookStack——一个开源文档管理系统，旨在帮助团队创建、组织和协作编辑文档。通过Docker容器化部署，简化了BookStack的安装和维护流程。

当前版本

https://github.com/DigitalMotionTech/docker-bookstack/blob/master/Dockerfile

标签说明

• 版本化标签：对应BookStack的具体版本
• latest标签：关联最新的版本化发布
• 额外标签可在https://gitlab.com/DigitalMotion/os/docker-bookstack/container_registry/***获取，映射到master等工作分支（仅标记发布版本会推送到DockerHub）

变更记录

• 21.05版本：迁移至Composer 2.x，进行大量代码和构建清理，使用Kaniko构建镜像
• 0.28.0版本：将容器HTTP端口从80改为8080，以降低权限要求
• 0.12.2版本：移除DB_PORT环境变量，可通过DB_HOST指定端口（如DB_HOST=mysql:3306）

核心功能和特性

• 支持BookStack最新稳定版本运行
• 提供灵活的环境变量配置
• 支持Docker Compose快速部署
• 支持数据持久化卷挂载
• 兼容MySQL数据库

使用场景和适用范围

• 团队知识库搭建
• 技术文档管理系统
• 项目文档协作平台
• 企业内部文档库

快速启动（Docker Compose）

通过Docker Compose可快速部署：

bash
docker-compose up

部署完成后，访问http://localhost:8080，使用默认账号登录：

• 用户名：***
• 密码：password

非Docker Compose使用方法

1. 创建共享网络

bash
docker network create bookstack_nw

2. 运行MySQL容器

bash
docker run -d --net bookstack_nw  \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=bookstack \
  -e MYSQL_USER=bookstack \
  -e MYSQL_PASSWORD=secret \
  --name="bookstack_db" \
  docker.xuanyuan.run/mysql:5.7

3. 运行BookStack容器

bash
docker run -d --net bookstack_nw \
  -e DB_HOST=bookstack_db:3306 \
  -e DB_DATABASE=bookstack \
  -e DB_USERNAME=bookstack \
  -e DB_PASSWORD=secret \
  -p 8080:8080 \
  --name="bookstack" \
  docker.xuanyuan.run/digitalmotion/bookstack:latest

卷挂载配置

为实现数据持久化，可挂载以下目录（将<HOST>替换为宿主机目录）：

bash
--mount type=bind,source=<HOST>/.env,target=/var/www/bookstack/.env \
-v <HOST>:/var/www/bookstack/public/uploads \
-v <HOST>:/var/www/bookstack/storage/uploads

注意：Windows主机需预先创建.env文件，否则会自动创建同名文件夹。

环境变量说明

问题反馈

如有任何问题，请通过https://github.com/DigitalMotionTech/docker-bookstack/issues提交。

项目灵感

本镜像基于https://github.com/solidnert/docker-bookstack分支开发。