實戰(使用docker)
設定volume
docker volume create bookstack_config
通常能不用Dockerfile就不用,我習慣直接下指令
docker run -d --name=bookstack -e PUID=1000 -e PGID=1000 -e TZ=Asia/Taipei \
-v /usr/share/fonts:/usr/share/fonts -e APP_URL=https://<網址需要https> \
-e DB_HOST=<mariadb 資料庫ip> -e DB_PORT=3306 -e DB_USER=<帳號> -e DB_PASS=<密碼> -e DB_DATABASE=bookstackapp \
-e QUEUE_CONNECTION= `#optional` -p 6875:80 -v bookstack_config:/config --restart unless-stopped lscr.io/linuxserver/bookstack:v23.10.4-ls119
上面指令需要注意:
1. APP_URL 必須為https請準備好反向代理程式,當然也可以是ip,ip就不需要https
2. DB_HOST、DB_PORT、DB_USER、DB_PASS 以及 DB_DATABASE 都是mariadb database連線資訊
3. 6875:80 將本體主機的6875拿來對應到容器的80
4. /usr/share/fonts使用本體的字型,這樣就不浪費空間了
請注意該自行需另外存放中文檔案(若想要匯出pdf不會有亂馬1/2的話)
https://fonts.google.com/noto/specimen/Noto+Sans+SC
https://fonts.google.com/noto/specimen/Noto+Sans+TC
5. 容器Image lscr.io/linuxserver/bookstack:v23.10.4-ls119
最新版 https://github.com/BookStackApp/BookStack
安裝完畢,請自行測試,預設帳號 admin@admin.com 密碼 password
登入後請直接修改email(即為登入帳號)與密碼
接下來要修改讓匯出pdf不會有亂碼
### 進入容器
docker exec -it bookstack bash
### 刪除預設的qt5
apk del qt5-qtbase
### 修改repositories 將 3.18改成3.14
vi /etc/apk/repositories
# 套用
apk update
apk upgrade
apk add wkhtmltopdf
### 測試-無法產生test.pdf 則代表失敗
wkhtmltopdf test.html test.pdf
### 修改 .env 檔案
vi /app/www/.env
###
WKHTMLTOPDF=/usr/bin/wkhtmltopdf
ALLOW_UNTRUSTED_SERVER_FETCHING=true
###
離開並且重啟容器就能正常匯出中文PDF