digitalmotion/bookstack

BookStack Docker镜像

镜像概述和主要用途

本镜像用于部署和运行https://github.com/ssddanbrown/BookStack%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AA%E5%BC%80%E6%BA%90%E6%96%87%E6%A1%A3%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%B8%AE%E5%8A%A9%E5%9B%A2%E9%98%9F%E5%88%9B%E5%BB%BA%E3%80%81%E7%BB%84%E7%BB%87%E5%92%8C%E5%8D%8F%E4%BD%9C%E7%BC%96%E8%BE%91%E6%96%87%E6%A1%A3%E3%80%82%E9%80%9A%E8%BF%87Docker%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%EF%BC%8C%E7%AE%80%E5%8C%96%E4%BA%86BookStack%E7%9A%84%E5%AE%89%E8%A3%85%E5%92%8C%E7%BB%B4%E6%8A%A4%E6%B5%81%E7%A8%8B%E3%80%82

当前版本

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

标签说明

• 版本化标签：对应BookStack的具体版本
• latest标签：关联最新的版本化发布
• 额外标签可在GitLab 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" \
  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" \
  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%E6%8F%90%E4%BA%A4%E3%80%82

项目灵感

本镜像基于https://github.com/solidnert/docker-bookstack%E5%88%86%E6%94%AF%E5%BC%80%E5%8F%91%E3%80%82