feierbuni/bookstack

BookStack Docker镜像文档

镜像概述和主要用途

BookStack是一款基于MinDoc和Beego开发的在线文档管理系统，功能类似Gitbook和看云，旨在提供便捷的文档管理与协作平台。该Docker镜像便于快速部署BookStack，适用于团队或个人构建知识库、文档库等场景。项目地址：https://github.com/TruthHun/BookStack%E3%80%82

核心功能和特性

• 在线文档管理：支持文档的创建、编辑、组织和版本控制
• 类似Gitbook和看云的用户体验，界面友好
• 基于Beego框架开发，性能稳定
• 支持数据持久化，依赖MySQL数据库存储数据

使用场景和适用范围

• 团队知识库建设
• 技术文档管理
• 产品手册编写与维护
• 个人或组织的文档协作平台

详细使用方法和配置说明

前提条件

• 已安装Docker环境
• 具备MySQL数据库环境（可通过Docker容器部署）

步骤1：部署MySQL容器

使用官方MySQL镜像部署数据库，需配置root密码、数据库名及用户信息：

bash
docker run -itd --name mysql \
  --restart always \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=bookstack \  # root用户密码
  -e MYSQL_DATABASE=bookstack \      # 数据库名
  -e MYSQL_USER=bookstack \          # 数据库用户
  -e MYSQL_PASSWORD=bookstack \      # 数据库用户密码
  -v /data/mysql:/var/lib/mysql \    # 数据持久化目录
  mysql --default-authentication-plugin=mysql_native_password

步骤2：准备BookStack配置文件

从GitHub Release下载BookStack源码（https://github.com/TruthHun/BookStack%EF%BC%89%EF%BC%8C%E5%A4%8D%E5%88%B6%60conf%60%E7%9B%AE%E5%BD%95%E8%87%B3%E5%AE%BF%E4%B8%BB%E6%9C%BA%E7%9A%84%60/data/bookstack/conf%60%EF%BC%8C%E5%B9%B6%E6%A0%B9%E6%8D%AE%E5%AE%9E%E9%99%85%E7%8E%AF%E5%A2%83%E4%BF%AE%E6%94%B9%E9%85%8D%E7%BD%AE%EF%BC%88%E5%A6%82%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5%E4%BF%A1%E6%81%AF%EF%BC%89%E3%80%82

步骤3：启动BookStack容器

BookStack启动时需连接MySQL数据库，通过挂载配置目录实现配置持久化：

bash
docker run -itd --name bookstack \
  --restart always \
  -p 8181:8181 \                     # 端口映射（容器内默认8181）
  -v /data/bookstack/conf:/opt/bookstack/conf \  # 配置文件夹
  toplinker/bookstack

默认管理员账号

• 用户名：admin
• 密码：admin888

访问地址：http://<服务器IP>:8181

常见问题解决

中文乱码问题

官方MySQL镜像默认字符集非UTF-8，可能导致中文显示为“？”。解决方案：

• 手动配置MySQL字符集为UTF-8
• 使用UTF-8支持的MySQL镜像，如：https://hub.docker.com/r/dnhsoft/mysql-utf8

时区问题

• latest标签镜像默认时区为UTC
• Tags2.8及以上版本已默认设置时区为Asia/Shanghai

推荐挂载目录

为确保数据持久化和自定义配置，建议挂载以下目录：

• /data/BookStack/conf:/opt/bookstack/conf：配置文件夹
• /data/BookStack/views:/opt/bookstack/views：模板文件夹
• /data/BookStack/uploads:/opt/bookstack/uploads：上传附件文件夹（图片、文件等）
• /data/BookStack/version_control:/opt/bookstack/version_control：历史版本文件夹

注：目前构建的镜像未安装puppeteer，如需相关功能需自行处理。