原文地址：https://lala.im/7080.html，請支持原作者！該處僅作轉載。
BookStack是一个简单且免费的开源Wiki平台，你可以非常轻松的使用它来构建自己的知识库，由于功能非常丰富，用它来搭建自己的个人博客也是没问题的。
本文使用Docker安装并配置Nginx反向代理。本来还是想用Traefik的，后来想了想很多人都是机器外面装一个Nginx然后还跑着其他的服务，这要一用Traefik那端口又冲突了。。
安装docker和docker-compose：
apt -y update
apt -y install curl
curl -sSL https://get.docker.com/ | sh
systemctl start docker
systemctl enable docker
curl -L https://github.com/docker/compose/releases/download/1.25.4/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose安装nginx和certbot：
apt -y install nginx python-certbot-nginx新建一个目录：
mkdir -p /opt/bookstack && cd /opt/bookstack新建一个docker-compose：
nano docker-compose.yml写入如下配置：
version: '3.5'
services:
bookstack:
image: linuxserver/bookstack
container_name: bookstack
depends_on:
- bookstack-db
environment:
- PUID=1000
- PGID=1000
- DB_HOST=bookstack-db
- DB_USER=imlala
- DB_PASS=password
- DB_DATABASE=bookstack
- APP_URL=https://wiki.imlala.best # 配置反向代理这里要指定你的域名，如果使用ssl记得加上https
ports:
- 54321:80
volumes:
- ./data:/config
restart: unless-stopped
bookstack-db:
image: mariadb
container_name: bookstack-db
environment:
- MYSQL_ROOT_PASSWORD=password
- MYSQL_DATABASE=bookstack
- MYSQL_USER=imlala
- MYSQL_PASSWORD=password
volumes:
- ./db:/var/lib/mysql
restart: unless-stopped启动：
docker-compose up -d新建一个nginx配置文件：
nano /etc/nginx/conf.d/bookstack.conf写入如下内容：
server {
listen 80;
server_name wiki.imlala.best; # 换成你的域名
client_max_body_size 0;
error_log /var/log/nginx/bookstack.error.log;
access_log /var/log/nginx/bookstack.access.log;
location / {
proxy_pass http://127.0.0.1:54321;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}签一个ssl证书：
certbot --nginx --agree-tos --no-eff-email --email [email protected]访问你的域名能看到登录界面说明一切正常：
注：默认的管理员账号：[email protected] 密码：password 首次登录进去，你应该立即修改密码。
这个容器默认的php配置不是很适合生产环境，写Wiki一般会上传很多大文件或者图片，稍微优化一下：
echo "memory_limit = -1" >> /opt/bookstack/data/php/php-local.ini
echo "post_max_size = 100M" >> /opt/bookstack/data/php/php-local.ini
echo "upload_max_filesize = 100M" >> /opt/bookstack/data/php/php-local.ini
echo "max_execution_time = 300" >> /opt/bookstack/data/php/php-local.ini修改这些php设置后需要重启容器使其生效：
docker-compose restart bookstack这里就不介绍BookStack的使用方法了，使用起来的话上手很快，BookStack的结构就和一本普通的图书一样，就好像你要出一本书的步骤是：
1.给书起一个名字
2.新建章节
3.新建页面
4.发布
就这么简单，而且BookStack还有一个书架的功能，如果你的图书很多，那么可以用书架进行分类。
额外补充一点后续维护的问题。
如果你之前没有配置反代直接用IP+PORT这种方式使用的话，现在想使用反向代理的话需要把数据库内的域名给替换过来。
比如我之前没有配置反代直接用209.151.156.157:54321访问，在里面新建了图书并且上传了附件和图片，这些附件和图片的URL不会自动更换，执行下面的命令更换成新的域名：
docker exec -it bookstack /bin/sh
cd /var/www/html/
php artisan bookstack:update-url http://209.151.156.157:54321 https://wiki.imlala.best
exit同样的如果后续你的站点需要更换域名也可以使用这个方法。
再补充一点使用过程中遇到的小问题：导出PDF中文乱码。
这个容器内已经装好了wkhtmltopdf，只是没有中文字体，装一个中文字体就可以解决问题了。注意不要exec到容器内装，切到容器内装的话容器更新或者删除了你又得重装。
具体步骤，先把旧容器删除（如果你使用本文的docker-compose配置，你的数据目录都挂载在宿主机上，这不会删除你的数据）
docker-compose down然后配置BookStack使用wkhtmltopdf：
echo "WKHTMLTOPDF=/usr/bin/wkhtmltopdf" >> /opt/bookstack/data/www/.env然后新建一个custom-cont-init.d目录（目录名字必须指定为这个）
mkdir -p /opt/bookstack/data/custom-cont-init.d接着新建一个脚本文件：
nano /opt/bookstack/data/custom-cont-init.d/install-fonts.sh在里面写入如下配置：
#!/bin/bash
apk add \
--no-cache \
--repository \
http://dl-cdn.alpinelinux.org/alpine/edge/testing \
wqy-zenhei最后再起一个新容器即可：
docker-compose up -d