luke2018/bookstack

luke2018/bookstack 镜像文档

镜像概述

luke2018/bookstack 是基于 BookStack 的 Docker 镜像。BookStack 是一款开源的文档管理与协作平台，旨在帮助团队或个人创建、组织、管理和分享知识内容。该镜像提供了便捷的部署方式，无需复杂的环境配置，通过简单的参数设置即可快速搭建功能完善的文档系统。

核心功能与特性

• 直观的文档编辑：支持富文本与 Markdown 格式编辑，满足不同用户的编辑习惯
• 文档组织体系：通过书架（Shelves）、图书（Books）、章节（Chapters）和页面（Pages）层级结构组织内容
• 权限管理：支持用户角色与权限控制，可配置不同用户对文档的访问和编辑权限
• 搜索功能：内置全文搜索，快速定位所需文档内容
• 轻量化部署：基于 Docker 容器化部署，简化环境依赖管理

使用场景与适用范围

• 团队知识库建设与管理
• 技术文档编写与维护
• 内部培训资料整理与分享
• 项目文档协作与版本控制
• 个人知识管理系统搭建

使用方法与配置说明

环境准备

使用该镜像前需确保：

1. 已安装 Docker 环境
2. 已部署 MySQL 数据库（用于存储 BookStack 数据）

核心环境变量

部署示例

Docker Run 命令

bash
sudo docker run -d \
  -e DB_HOST=$(ip -4 addr show docker0 | grep -Po 'inet \K[\d.]+'):3306 \
  -e DB_DATABASE=bookstack \
  -e DB_USERNAME=root \
  -e DB_PASSWORD=123456 \
  -p 8082:80 \
  luke2018/bookstack

命令说明：

• $(ip -4 addr show docker0 | grep -Po 'inet \K[\d.]+')：自动获取 Docker 桥接网络（docker0）的 IPv4 地址，用于连接宿主机上的 MySQL 数据库
• -p 8082:80：将容器内的 80 端口映射到宿主机的 8082 端口，通过 http://宿主机IP:8082 访问 BookStack
• -d：后台运行容器

访问系统

部署完成后，通过浏览器访问 http://宿主机IP:8082，使用默认管理员账号登录：

• 用户名：admin@admin.com
• 密码：password

首次登录后建议立即修改管理员密码，保障系统安全。

注意事项

1. 数据库需提前创建：使用前需在 MySQL 中手动创建指定的数据库（如示例中的 bookstack）
2. 数据持久化：若需持久化存储数据，建议通过 -v 参数挂载容器内的数据目录（如 /var/www/bookstack/storage 和 /var/www/bookstack/public/uploads）
3. 网络配置：若数据库不在宿主机，需将 DB_HOST 替换为实际数据库的 IP 地址和端口