使用 docker 部署 Bookstack 项目

type

status

date

slug

summary

Bookstack 是一个免费的开源 Wiki，旨在创建精美的文档。它具有简单但功能强大的所见即所得编辑器，提供了 Markdown 编辑器，旨在让文档成为一种乐趣，而不是一件苦差事。允许团队或个人轻松创建详细且有用的文档。

详细的部署过程可以参考发布在 youtube 上的视频版本点击查看Youtube视频详细部署过程

x86 和 arm 64

默认用户名是 admin@admin.com，密码是 password ，通过 http://ip:6875 访问容器。

1.安装 docker 环境

使用 Docker 部署 BookStack，首先需要确保已经安装了 Docker 和 Docker Compose。然后按照以下步骤操作：

curl -fsSL <https://get.docker.com> -o get-docker.sh && sudo sh get-docker.sh

2.配置项目路径和 docker-compose.yml 文件

创建一个目录，用于存储 BookStack 的 Docker 配置文件和数据（这里以 /var/docker/bookstack为路径存放该项目）：

mkdir -p /var/docker/bookstack && cd /var/docker/bookstack

创建一个 docker-compose.yml 文件，并添加以下内容：

nano docker-compose.yml

点击键盘 ctrl + x，之后点击 y，回车。

这个 docker-compose.yml 文件定义了两个服务：BookStack 和数据库（使用 MariaDB）。BookStack 服务使用 linuxserver/bookstack 镜像，数据库服务使用 linuxserver/mariadb 镜像。

这里，/var/docker/bookstack 是你的目标目录，bookstack\_app\_data 和 bookstack\_db\_data 是你要挂载的子目录。

在 /var/docker/bookstack 目录下创建名为 bookstack\_app\_data 和 bookstack\_db\_data 的文件夹，用于存储 BookStack 的配置文件和数据库文件。

运行 Docker Compose 启动 BookStack 服务：

docker compose up -d

这会拉取所需的镜像并创建 BookStack 和数据库的容器实例。一旦容器启动，你可以通过浏览器访问 http://localhost:6875 来访问 BookStack。

注意：如果 docker-compose.yml 填写有误或者想要修改 docker-compose.yml 文件，重新部署项目，可以执行 docker compose down 将项目下线，然后重新运行 docker compose up -d 部署项目。

第一次访问时，将会提示你进行初始化设置，包括数据库连接等。

完成初始化设置后，你就可以开始使用 BookStack 创建和管理文档了。

记得保护好数据库密码等敏感信息，并且根据实际需要修改配置中的端口号等参数。