📚 BookStack：一款功能强大的免费知识库管理平台

在这个信息爆炸的时代，你是否经常感到无所适从？团队文档杂乱无章，个人笔记四处散落，重要信息总是找不到...如果这些问题困扰着你，那么 BookStack 可能就是你一直在寻找的解决方案。

🌟 BookStack：不只是另一个文档系统

BookStack 是一个开源的知识管理平台，它将文档组织得像一本书一样直观。想象一下，如果维基百科和你最爱的笔记 App 有个孩子，那大概就是 BookStack 了。

基于 PHP 和 Laravel 构建，BookStack 不仅功能强大，还特别注重用户体验。无论你是技术大牛还是普通用户，都能轻松驾驭。

💡 为什么选择 BookStack？

结构清晰：采用"书籍 > 章节 > 页面"的层级结构，让内容组织一目了然。
编辑灵活：支持所见即所得和 Markdown 编辑器，满足不同偏好。
权限管理：细粒度的权限控制，完美适配团队协作需求。
搜索强大：全文搜索功能，让你瞬间找到需要的信息。
多语言支持：包括中文在内的多种语言界面，无障碍使用。
导出方便：可以导出html、markdown、txt和pdf格式。
开源免费：企业级功能，零成本使用。

🛠 用 Docker 搭建 BookStack

BookStack 的部署非常简单，特别是使用 Docker 的话。下面我们详细解释如何通过 Docker 部署 BookStack，并对每个参数进行说明。

方法一：Docker 命令行部署

docker run -d \
  --name=bookstack \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e APP_URL=http://your-domain.com \
  -e APP_KEY=base64:C4MCxJYaoUMj6Rpn2cMmHyycBlU0hizsoDEbOO7w2LQ=
  -e DB_HOST=bookstack_db \
  -e DB_USER=bookstack \
  -e DB_PASS=your_password \
  -e DB_DATABASE=bookstack \
  -p 6875:80 \
  -v /path/to/data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/bookstack:latest

参数解释：

--name=bookstack：为容器指定一个名称，方便管理。
-e PUID=1000 和 -e PGID=1000：设置用户和组 ID，确保容器内外的权限一致。
-e APP_URL=http://your-domain.com：设置 BookStack 的访问 URL，请替换为你的实际域名。
-e APP_KEY=base64:C4MCxJYaoUMj6Rpn2cMmHyycBlU0hizsoDEbOO7w2LQ=：设置 BookStack 会话加密密钥，使用ocker run -it --rm --entrypoint /bin/bash linuxserver/bookstack:latest appkey可以生成一个。
TZ=Asia/Shanghai:指定时区，中国的就用这个即可。
-e DB_HOST=bookstack_db：数据库主机名，如果使用外部数据库，请相应修改。
-e DB_USERNAME=bookstack：数据库用户名。
-e DB_PASSWORD=your_password：数据库密码，请使用强密码替换。
-e DB_DATABASE=bookstack：数据库名称。
-p 6875:80：端口映射，将容器的 80 端口映射到主机的 6875 端口。
-v /path/to/data:/config：数据卷挂载，确保数据持久化，请替换为你的实际路径。
--restart unless-stopped：容器自动重启策略。

方法二：Docker Compose 部署

创建一个 docker-compose.yml 文件，内容如下：

version: "2"
services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    container_name: bookstack
    environment:
      - PUID=501
      - PGID=20
      - TZ=Asia/Shanghai 
      - APP_URL=http://localhost:6875
      - APP_KEY=base64:C4MCxJYaoUMj6Rpn2cMmHyycBlU0hizsoDEbOO7w2LQ=
      - DB_HOST=172.17.0.1
      - DB_PORT=3306
      - DB_USERNAME=root
      - DB_PASSWORD=123456
      - DB_DATABASE=bookstack
    volumes:
      - /path/to/data:/config
    ports:
      - 6875:80
    restart: unless-stopped
    depends_on:
      - bookstack_db
  bookstack_db:
    image: lscr.io/linuxserver/mariadb:latest
    container_name: bookstack_db
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=your_root_password
      - TZ=Europe/London
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=your_password
    volumes:
      - /path/to/database:/config
    restart: unless-stopped

这个 docker-compose.yml 文件定义了两个服务：bookstack 和 bookstack_db。参数含义与单独运行 Docker 命令时相同，但这里我们同时部署了一个 MariaDB 数据库容器。

运行以下命令启动服务：