使用 Docker 安装 Bookstack 的指南

Bookstack 是一个功能齐全的文档管理平台,可以帮助团队组织和管理文档。使用 Docker 安装 Bookstack 不仅简便高效,还能在不同环境中保持一致性。本文将带你一步步完成 Bookstack 的 Docker 安装过程,并提供相关代码示例。

准备工作

在开始之前,确保你的系统上已经安装了 Docker 和 Docker Compose。如果尚未安装,可以参考 [Docker 官方文档]( 和 [Docker Compose 官方文档]( 进行安装。

创建项目目录

首先,我们需要创建一个新的项目目录。你可以通过以下命令创建名为 bookstack 的目录:

mkdir bookstack
cd bookstack
  • 1.
  • 2.

创建 Docker Compose 文件

接下来,我们将在项目目录下创建一个名为 docker-compose.yml 的文件,并在其中配置 Bookstack 所需的服务。

version: '3'

services:
  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: bookstack
      MYSQL_USER: bookstackuser
      MYSQL_PASSWORD: password
    volumes:
      - db_data:/var/lib/mysql

  app:
    image: bookstack/standalone
    ports:
      - "6875:80"
    environment:
      DB_CONNECTION: mysql
      DB_HOST: db
      DB_DATABASE: bookstack
      DB_USERNAME: bookstackuser
      DB_PASSWORD: password
    volumes:
      - app_data:/var/www/html/storage
    depends_on:
      - db

volumes:
  db_data:
  app_data:
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.

在上述配置中,我们定义了两个服务:dbappdb 使用 MySQL 数据库,app 则是 Bookstack 应用。

启动服务

创建好 docker-compose.yml 文件后,我们可以通过以下命令启动 Bookstack 服务:

docker-compose up -d
  • 1.

此命令将在后台启动 MySQL 和 Bookstack 的容器。你可以通过 docker-compose ps 命令来检查运行状态。

访问 Bookstack

服务启动后,你可以在浏览器中访问 http://localhost:6875。首次访问时需要进行简单的设置,包括管理员账户的创建。

序列图

在整个安装过程中,服务之间的交互可以用序列图来表示:

DB App User DB App User 请求访问 Bookstack 查询数据库 返回数据 返回页面

这个序列图展示了用户如何与 Bookstack 应用和数据库进行交互。

总结

使用 Docker 安装 Bookstack 不仅能够简化部署过程,还能确保各个用户和开发环境之间的一致性。本文为您提供了详细的步骤和代码示例,相信经过这些步骤,您将能够轻松搭建自己的文档管理平台。

希望这篇文章对您有所帮助,欢迎您在实践中不断探索和完善 Bookstack 的使用。享受高效的文档管理体验吧!