【Docker】通过Docker部署BookStack

悠悠 2022-10-30 12:25 534阅读 0赞

为了给公司搭建个知识库重新做了选型，看过了好几个工具包括MkDocs、MM-markdown等，最后选用开源的BookStack作为知识库，原因有三：

1.  BookStack是开源的，并且项目在GitHub中的活跃度很高；
2.  BookStack是PHP开发的，数据库使用的是MySQL5，最最最难得的是他有Docker版本。这样就不需要部署一套LAMP了，直接通过Docker+MySQL就可以运行；
3.  配置方便，提供了后台配置页面，所有的站点内细节都可以通过配置后台解决；

#### Docker部署 ####

Docker Hub地址：`https://hub.docker.com/r/linuxserver/bookstack`

镜像拉取：

docker pull linuxserver/bookstack

镜像启动：

docker run --name=bookstack \
    -e PUID=1000 \
    -e PGID=1000 \
    -e DB_HOST=172.17.0.5 \
    -e DB_USER=yzh \
    -e DB_PASS=0623 \
    -e DB_DATABASE=bookstackapp \
    -p 6875:80 \
    -v /Users/yuanzhenhui/Documents/docker_data/bookstack:/config \
    --restart unless-stopped \
    linuxserver/bookstack

数据库只能使用5.6.x版本的，不能用5.x以上的MySQL数据库（经过尝试除了5.x的版本外其他版本MySQL数据库连接不上，估计是连接驱动的问题）。  
通过`DB_HOST`、`DB_USER`、`DB_PASS`、`DB_DATABASE`就可以将数据库配置写上了。最后，启动前先将目标数据库`bookstackapp`建好就可以启动了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tpZGFfeXVhbg_size_16_color_FFFFFF_t_70]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tpZGFfeXVhbg_size_16_color_FFFFFF_t_70 1]  
成功启动后会看到`[services.d]done`的字样，第一次启动的时候会创建表并初始化用户信息。

--------------------

#### 页面访问 ####

系统启动后可以通过URL登录：`http://localhost:6875/login`

> 初始化登录使用以下用户名和密码：  
> 用户名：admin@example.com  
> 密码：password

就可以登录后台了，如果出现一直loading的情况可以刷新一下页面就可以了。

至此，登录后台之后可以配置用户数据和权限信息了。

--------------------

#### 树莓派搭建脚本 ####

由于BookStack提供了Docker镜像也就是说它可以在树莓派中进行部署，还好Docker也有提供适用于ARM核心的镜像。在下载了镜像后就可以做以下操作了。

BookStack容器创建：

sudo docker run --name=bookstack \
    -d \
    -e PUID=1000 \
    -e PGID=1000 \
    -e DB_HOST=172.17.0.2 \
    -e DB_USER=yzh \
    -e DB_PASS=0623 \
    -e DB_DATABASE=bookstackapp \
    -p 6875:80 \
    -v /mnt/depot/docker/bookstack:/config \
    --restart=always \
    linuxserver/bookstack

由于树莓派中已经不再支持高版本的MySQL数据库了（可能是因为MySQL被Oracle收购的原因，树莓派没有5.x后的MySQL库了，取而代之的是MariaDB这个同宗同源的数据库，事实证明MariaDB现在是越做越好了~我个人是这么认为的），所以这里用的是ARM版本的Docker镜像，MySQL5容器创建：

sudo docker run -p 3506:3306 \
    -e MYSQL_ROOT_PASSWORD=root \
    --name mysql5 \
    -d \
    --restart=always \
    biarms/mysql:5.5.62-linux-arm32v7-beta-travis

MySQL5配置信息获取：

sudo docker cp mysql5:/var/lib/mysql /home/pi/Documents/mysql5/data

sudo docker cp mysql5:/etc/mysql /home/pi/Documents/mysql5/config

启动MySQL5容器：

sudo docker run -p 3506:3306 \
    -v /mnt/depot/docker/mysql5/data:/var/lib/mysql \
    -v /mnt/depot/docker/mysql5/config:/etc/mysql \
    -e MYSQL_ROOT_PASSWORD=root \
    --name mysql5 \
    -d \
    --restart=always \
    biarms/mysql:5.5.62-linux-arm32v7-beta-travis

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tpZGFfeXVhbg_size_16_color_FFFFFF_t_70]: /images/20221024/a3d0acd9332848b6bac27fc050e704df.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tpZGFfeXVhbg_size_16_color_FFFFFF_t_70 1]: /images/20221024/6d607c3303c04f8681f26db15d5d88ac.png