successage/bookstack

BookStack 中文PDF导出镜像

镜像概述

本镜像基于 https://hub.docker.com/r/linuxserver/bookstack 修改，针对中文PDF导出功能进行优化。原版BookStack默认使用Dompdf导出PDF时存在中文乱码问题，本镜像通过集成 wkhtmltopdf 及中文字体，并配置相应环境变量，实现中文文档的正常导出。

核心功能与特性

• 中文PDF导出支持：替换默认Dompdf为wkhtmltopdf，解决中文乱码问题
• 预安装中文字体：容器内已包含必要中文字体，无需额外配置
• 完整保留原版功能：基于官方BookStack镜像构建，保留所有核心功能
• 简单配置：通过环境变量即可指定wkhtmltopdf路径，无需复杂设置

使用场景

• 企业内部知识库搭建，需要导出中文文档为PDF
• 团队协作文档管理，需生成可分享的中文PDF版本
• 个人笔记系统，需要保存中文内容为PDF格式存档

使用方法

环境要求

• Docker Engine 1.13.0+
• Docker Compose 1.10.0+

配置说明

docker-compose.yml 配置

yaml
version: "2"
services:
  bookstack:
    image: successage/bookstack
    container_name: bookstack
    environment:
      - PUID=1000                # 用户ID，用于文件权限控制
      - PGID=1000                # 组ID，用于文件权限控制
      - DB_HOST=bookstack_db     # 数据库主机名
      - DB_USER=bookstack        # 数据库用户名
      - DB_PASS=bookstack123     # 数据库密码
      - DB_DATABASE=bookstackapp # 数据库名称
      - APP_LANG=zh_CN           # 应用语言设置为中文
      - WKHTMLTOPDF=/usr/bin/wkhtmltopdf  # 指定wkhtmltopdf路径
    volumes:
      - /home/cherokee/project/docker-bookstack/config:/config  # 配置文件持久化路径
    ports:
      - 6875:80                  # 端口映射（主机端口:容器端口）
    restart: unless-stopped      # 重启策略
    depends_on:
      - bookstack_db             # 依赖数据库服务

  bookstack_db:
    image: linuxserver/mariadb   # MariaDB数据库镜像
    container_name: bookstack_db
    environment:
      - PUID=1000                # 用户ID
      - PGID=1000                # 组ID
      - MYSQL_ROOT_PASSWORD=root # 数据库root密码
      - TZ=Asia/Shanghai         # 时区设置
      - MYSQL_DATABASE=bookstackapp  # 数据库名称
      - MYSQL_USER=bookstack     # 数据库用户名
      - MYSQL_PASSWORD=bookstack123  # 数据库密码
    volumes:
      - /home/cherokee/project/docker-bookstack/config:/config  # 数据库数据持久化路径
    restart: unless-stopped      # 重启策略

启动服务

在docker-compose.yml文件所在目录执行以下命令启动服务：

bash
docker-compose up -d --build

该命令会同时启动BookStack应用和MariaDB数据库服务。

停止服务

如需停止服务，执行以下命令：

bash
docker-compose down

注意事项

• 首次启动时，数据库初始化需要一定时间，请耐心等待
• 确保宿主机挂载目录具有正确的读写权限（与PUID/PGID匹配）
• 如需修改端口映射，可调整ports配置中的主机端口部分
• 应用默认管理员账号：***，密码：password，首次登录后建议立即修改