nubsi/bookstack

nubsi/bookstack 镜像说明

镜像概述

本镜像为开源文档管理系统BookStack的容器化部署方案，适用于快速搭建轻量级文档管理平台，注意：本镜像不建议用于生产环境。

核心功能

• 支持书籍、章节、页面三级文档组织结构
• 提供富文本编辑功能，支持内容格式化与多媒体插入
• 内置用户认证机制，默认提供管理员账号
• 支持自定义配置，可通过环境变量调整数据库连接等参数

使用场景

• 个人或团队内部知识库搭建
• 项目文档、技术手册的集中管理
• 学习笔记、教程的整理与分享

配置说明

环境变量

• DB_HOST：数据库服务地址（需与数据库容器在同一网络）
• DB_DATABASE：BookStack使用的数据库名称
• DB_USERNAME：数据库访问用户名
• DB_PASSWORD：数据库访问密码
• APP_KEY：BookStack应用密钥（需使用合法生成的密钥）

网络要求

需创建专用网络以连接BookStack容器与数据库容器。

部署示例

1. 创建专用网络

bash
docker network create bookstack_net

2. 启动数据库容器（MariaDB）

bash
docker run --name db \
    -p 3306:3306 \
    -e MARIADB_ROOT_PASSWORD=example \
    -e MARIADB_DATABASE=bookstack \
    -e MARIADB_USER=bookstack-user \
    -e MARIADB_PASSWORD=example \
    -v ./database:/var/lib/mysql:Z \
    --network bookstack_net \
    -d \
    --rm \
    docker.xuanyuan.run/mariadb:latest

3. 启动BookStack容器

bash
docker run \
    -p 80:80 \
    -e DB_HOST=db \
    -e DB_DATABASE=bookstack \
    -e DB_USERNAME=bookstack-user \
    -e DB_PASSWORD=example \
    -e APP_KEY=base64:dUvWVLuxhsvWR3p4Z3EOxrnYFPSMWfqfuHsdBpqSOCM= \
    --network bookstack_net \
    -d \
    --rm \
    docker.xuanyuan.run/nubsi/bookstack:latest

4. 生成新的APP_KEY（可选）

若需替换默认APP_KEY，可执行以下命令生成：

bash
docker run --rm --entrypoint bash docker.xuanyuan.run/nubsi/bookstack -c "php artisan key:generate --show"

访问应用

打开浏览器访问 http://localhost，使用默认账号登录：

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