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

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服务。
services:
bookstack:
image: lscr.io/linuxserver/bookstack:version-v25.02
container_name: bookstack
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC # 根据需求调整时区，默认为UTC+0，需要和下方mariadb的TZ保持一致
- APP_URL=http://10.168.123.227:6876
- APP_KEY=base64:FmsryFy67lD+FopSfMMtS+3SGsloxUQb+yqXGl6XdiM= # 先注释掉这一行，配置完成启动后再生成新的配置填入
- DB_HOST=mariadb
- DB_PORT=3306
- DB_DATABASE=bookstack # 替换为你所需的名字，需要调整的话要和下方mariadb的MYSQL_DATABASE保持一致
- DB_USERNAME=bookstack # 替换为你所需的名字，但需要和下方mariadb的MYSQL_USER保持一致
- DB_PASSWORD=bookstack8432 # 替换为你所需的密码，但需要和下方mariadb的MYSQL_PASSWORD保持一致
volumes:
- ./bookstack_app_data:/config
ports:
- 6876:80
restart: unless-stopped

mariadb:
image: lscr.io/linuxserver/mariadb:11.4.4
container_name: mariadb
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC # 根据需求调整时区，默认为UTC+0，需要和上方bookstack的TZ保持一致
- MYSQL_ROOT_PASSWORD=mysupersecretrootpassword # 替换你自己的密码
- MYSQL_DATABASE=bookstack # 和上方bookstack的DB_DATABASE保持一致
- MYSQL_USER=bookstack # 和上方bookstack的DB_USERNAME保持一致
- MYSQL_PASSWORD=bookstack8432 # 和上方bookstack的DB_PASSWORD保持一致
volumes:
- ./bookstack_db_data:/config

restart: unless-stopped

（3）保存退出后，运行容器。
sudo docker-compose up -d

（4）运行完成后，在浏览器输入 http://本地IP:6876 （本例http://10.168.123.227:6876） ，即可web访问个人知识库BookStack。
Bookstack教程中提供初始管理员账号密码
账号：admin@admin.com
密码：password

4.配置花生壳映射

4.1 下载

在安装个人知识库BookStack或可访问个人知识库BookStack的内网终端设备上，下载贝锐花生壳客户端【点击下载花生壳客户端】

4.2 安装

根据不同位数的系统输入下面的命令进行安装，安装完成会自动生成SN码与登录密码。
sudo dpkg -i phddns_5.3.0_amd64.deb

4.3 登录

（1）浏览器访问【花生壳管理平台】 http://b.oray.com/ ，输入花生壳Linux 5.X.X在安装时，产生的SN码与默认登录密码admin登录。

（2）首次登录，需先进行设备激活。贝锐花生壳提供扫码激活和贝锐账号激活两种方式。

4.4 添加映射

（1）激活成功后，点击【内网穿透】->【添加映射】，填写新增映射信息。

（2）新增映射后，可访问外网地址访问个人知识库BookStack。

5.外网访问个人知识库BookStack

浏览器输入花生壳外网地址，即可实现外网访问个人知识库BookStack。