kilhog/bookstack

BookStack Docker镜像

镜像概述和主要用途

BookStack是一个开源的文档/wiki平台，旨在提供简单直观的界面用于创建、组织和分享文档内容。本Docker镜像封装了BookStack应用，简化了部署流程，适用于团队协作、知识库建设、项目文档管理等场景，帮助用户快速搭建功能完善的文档系统。

核心功能和特性

• 直观编辑体验：提供富文本编辑界面，支持格式化文本、图片插入等功能
• 灵活组织结构：采用书籍、章节、页面的层级结构管理文档内容
• 用户权限控制：支持多用户协作，可设置不同角色的访问权限
• 内容搜索：内置搜索功能，便于快速查找所需文档
• 轻量部署：通过Docker容器化部署，简化环境配置和版本管理

使用场景和适用范围

• 团队内部知识库建设与共享
• 项目文档的编写、管理和协作
• 技术文档、产品手册的在线发布
• 个人或小型组织的维基系统搭建
• 企业内部培训材料管理

详细使用方法和配置说明

前提条件

• 已安装Docker引擎
• 确保主机端口（如8080）未被占用

部署步骤

1. 部署MySQL数据库容器

BookStack依赖MySQL数据库，需先运行MySQL容器：

bash
# 拉取MySQL镜像
docker pull mysql

# 运行MySQL容器
docker run -d --name bookstack-mysql -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=bookstack \
  -e MYSQL_USER=bookstack \
  -e MYSQL_PASSWORD=secret \
  mysql

环境变量说明：

• MYSQL_ROOT_PASSWORD：MySQL根用户密码（自定义安全密码）
• MYSQL_DATABASE：为BookStack创建的数据库名称（必须为bookstack）
• MYSQL_USER：BookStack使用的数据库用户
• MYSQL_PASSWORD：BookStack数据库用户的密码

2. 部署BookStack容器

拉取并运行BookStack容器，与MySQL容器建立链接：

bash
# 拉取BookStack镜像
docker pull kilhog/bookstack

# 运行BookStack容器
docker run --name my-bookstack -d \
  --link bookstack-mysql:mysql \
  -p 8080:80 \
  kilhog/bookstack

参数说明：

• --link bookstack-mysql:mysql：将BookStack容器与MySQL容器链接，容器内通过mysql主机名访问数据库
• -p 8080:80：将容器的80端口映射到主机的8080端口（可根据需要修改主机端口）

访问应用

部署完成后，通过以下地址访问BookStack：
http://<Docker主机IP地址>:8080

初始登录信息：
默认用户名：admin@example.com，默认密码：password
（首次登录后建议立即修改默认密码以保障安全）