【BookStack】搭建 BookStack(docker)的记录

搭建 BookStack(docker)的记录

本文将详细介绍如何在本地环境中使用 Docker 搭建 BookStack,并且解决其默认版本不支持中文 PDF 导出的问题。

1. 安装 MySQL 8.0

首先,使用 Docker 拉取 MySQL 8.0 镜像并运行 MySQL 容器:

bash 复制代码
docker pull mysql:8.0
docker run --name mysql8 -v /root/docker_root/bookstack/mysql:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=rootpassword -d mysql:8.0

2. 构建自定义的 BookStack Docker 镜像

由于官方的 linuxserver/bookstack 镜像不支持导出中文 PDF,我们需要自己构建一个包含中文字体支持的镜像。以下是 Dockerfile 的内容:

Dockerfile 复制代码
# 使用包含 wkhtmltopdf 的基础镜像
FROM surnet/alpine-wkhtmltopdf:3.19.0-0.12.6-full as wkhtmltopdf
FROM linuxserver/bookstack

# 将 wkhtmltopdf 相关文件复制到目标镜像中
COPY --from=wkhtmltopdf /bin/wkhtmltopdf /usr/bin/wkhtmltopdf
COPY --from=wkhtmltopdf /bin/wkhtmltoimage /usr/bin/wkhtmltoimage
COPY --from=wkhtmltopdf /bin/libwkhtmltox* /usr/bin/

# 下载并添加中文字体
ADD https://registry.freedom-yun.com/repository/public-archives/com/microsoft/fonts/chinese-fonts/10.0.0/chinese-fonts-10.0.0.tar.gz /usr/share/fonts/

# 更新 apk 源并安装必要的库,解压字体包
RUN sed -i "s/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g" /etc/apk/repositories && \
    apk add --no-cache \
    libstdc++ \
    libx11 \
    libxrender \
    libxext \
    libssl3 && \
    tar -zxvf /usr/share/fonts/chinese-fonts-10.0.0.tar.gz -C /usr/share/fonts/ && \
    rm -f /usr/share/fonts/chinese-fonts-10.0.0.tar.gz

然后,在包含上述 Dockerfile 的目录下运行以下命令构建镜像:

bash 复制代码
docker build -t bookstack-with-wkhtmltopdf .

3. 构建 docker-compose.yml

创建一个 docker-compose.yml 文件,内容如下:

yaml 复制代码
version: "3.3"
services:
  bookstack:
    image: bookstack-with-wkhtmltopdf
    container_name: bookstack
    restart: always
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=http://ip:8080
      - DB_HOST=mysql8
      - DB_USER=db_user
      - DB_PASS=dbpassword
      - DB_DATABASE=bookstack
    ports:
      - 8080:80
    volumes:
      - ./bookstack_data:/config

在包含上述 docker-compose.yml 文件的目录下运行以下命令启动容器:

bash 复制代码
docker-compose up -d

4. 配置国内环境

4.1 配置 Docker 镜像加速和 DNS

编辑 /etc/docker/daemon.json 文件,添加以下内容:

json 复制代码
{
  "registry-mirrors": ["https://hccwwfjl.mirror.aliyuncs.com"],
  "dns": ["223.5.5.5","223.6.6.6"]
}

4.2 通过代理构建镜像

如果下载 surnet/alpine-wkhtmltopdf 镜像速度较慢,可以使用代理:

bash 复制代码
docker build -t bookstack-with-wkhtmltopdf --build-arg HTTP_PROXY=http://proxy_ip:proxy_port --build-arg HTTPS_PROXY=http://proxy_ip:proxy_port .

缓存下载完 surnet/alpine-wkhtmltopdf 后,在 RUN APK ADD 阶段可能会出现超时的错误。因为有缓存了,所以进行不使用代理来构建镜像:

bash 复制代码
docker build -t bookstack-with-wkhtmltopdf .

至此,BookStack 搭建完成,可以通过浏览器访问 http://ip:8080 进行使用。

相关推荐
。puppy9 分钟前
HCIP--3实验- 链路聚合,VLAN间通讯,Super VLAN,MSTP,VRRPip配置,OSPF(静态路由,环回,缺省,空接口),NAT
运维·服务器
颇有几分姿色18 分钟前
深入理解 Linux 内存管理:free 命令详解
linux·运维·服务器
光芒再现dev35 分钟前
已解决,部署GPTSoVITS报错‘AsyncRequest‘ object has no attribute ‘_json_response_data‘
运维·python·gpt·语言模型·自然语言处理
AndyFrank1 小时前
mac crontab 不能使用问题简记
linux·运维·macos
ZHOU西口1 小时前
微服务实战系列之玩转Docker(十八)
分布式·docker·云原生·架构·数据安全·etcd·rbac
成都古河云2 小时前
智慧场馆:安全、节能与智能化管理的未来
大数据·运维·人工智能·安全·智慧城市
算法与编程之美2 小时前
文件的写入与读取
linux·运维·服务器
Amelio_Ming2 小时前
Permissions 0755 for ‘/etc/ssh/ssh_host_rsa_key‘ are too open.问题解决
linux·运维·ssh
心灵彼岸-诗和远方2 小时前
Devops业务价值流:软件研发最佳实践
运维·产品经理·devops
JuiceFS3 小时前
好未来:多云环境下基于 JuiceFS 建设低运维模型仓库
运维·云原生