BookStack 是一个强大而优雅的开源知识管理平台，它通过“书架-书籍-章节-页面”的清晰结构，帮助你轻松地构建一个系统化、易于检索的个人知识库。 如果你厌倦了散落在各处的零散文档和笔记，希望拥有一个完全受自己控制、结构井然的知识中心，BookStack 是一个非常理想的选择。

官网地址：https://www.bookstackapp.com/

1.环境准备

确保系统已扮装Docker和Docker-compose，若尚未安装，可参考以下步骤操作：

1.1 安装Docker

（1）安装docker。
sudo curl -fsSL https://github.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh| bash -s docker –mirror Aliyun

(2)启动docker。
sudo systemctl start docker

1.2 安装Docker-compose

（1）下载docker-compose文件。
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

(2)赋予docker-compose执行权限。
sudo chmod +x /usr/local/bin/docker-compose

2.拉取镜像源

使用docker拉取bookstack的最新镜像。
sudo docker pull linuxserver/bookstack

3.创建并启动容器

（1）建一个目录用于存放BookStack的数据，并且编写 docker-compose.yml 文件来配置BookStack服务。
mkdir bookstack
cd bookstack
vim docker-compose.yml

（2）在docker-compose.yml 文件中写入BookStack服务。

# 声明 Compose 版本（适配主流 Docker 版本）
version: '3.8'

# 所有服务嵌套在 services 下（必须缩进2个空格）
services:
  # bookstack 服务（缩进2个空格，与services对齐层级）
  bookstack:
    image: lscr.io/linuxserver/bookstack:version-v25.02
    container_name: bookstack
    environment:  # 环境变量（缩进4个空格）
      - PUID=1000  # 列表形式，以-开头，缩进6个空格
      - PGID=1000
      - TZ=Etc/UTC  # 时区与mariadb保持一致
      - APP_URL=http://127.0.0.1:6876  # 修改为你自己对外访问的IP地址
      # 先注释下面這一行的APP_KEY，启动后生成再填入！启动后生成再填入！启动后生成再填入！
      # - APP_KEY=base64:FmsryFy67lD+FopSfMMtS+3SGsloxUQb+yqXGl6XdiM=
      - DB_HOST=mariadb
      - DB_PORT=3306
      - DB_DATABASE=bookstack
      - DB_USERNAME=bookstack
      - DB_PASSWORD=bookstack8432
    volumes:  # 数据卷（缩进4个空格）
      - ./bookstack_app_data:/config  # 列表形式，-开头
    ports:  # 端口映射（缩进4个空格）
      - 6876:80  # 列表形式，-开头
    restart: unless-stopped
    depends_on:  # 依赖mariadb，确保先启动数据库
      - mariadb

  # mariadb 服务（缩进2个空格，与bookstack同级）
  mariadb:
    image: lscr.io/linuxserver/mariadb:11.4.4
    container_name: mariadb
    environment:  # 环境变量（缩进4个空格）
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - MYSQL_ROOT_PASSWORD=bookstack1234 #设置你的数据库密码
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=bookstack8432
    volumes:  # 数据卷（缩进4个空格）
      - ./bookstack_db_data:/config
    restart: unless-stopped

容器创建完后，必须去掉APP_KEY的注释“#”，必须去掉APP_KEY的注释“#”，必须去掉APP_KEY的注释“#”。

创建完成后用你的ip地址加端口即可访问（本例http://127.0.0.1:6876），如果要用域名，请再配置反向代理即可。

Bookstack教程中提供初始管理员账号密码
账号：admin@admin.com
密码：password