跳到主要内容

部署

本文指导您使用 Docker 部署 bkhtmltopdf 企业版（EE）。企业版支持无头模式，适合生产环境。

购买成功后，您将收到一封激活邮件，包含 Docker 镜像文件（.tar 格式）和激活码（LICENSE）。

注意

bkhtmltopdf 企业版仅支持 Docker 部署，兼容 Docker CE 和 Docker EE（版本 20.10+）。

前提条件​

安装 Docker​

具体安装教程请参考官网文档: https://docs.docker.com/engine/install/

验证安装：

docker --version

输出应类似：Docker version 27.0.3, build 7d4bcd8。

提示

确保 Docker 服务已启动，并有足够磁盘空间（至少 10GB 用于镜像和数据）。

部署步骤​

加载镜像​

下载邮件中的 .tar 文件后，使用以下命令加载到 Docker：

docker load < bkhtmltopdf-ee-x.y.z.tar

替换 bkhtmltopdf-ee-x.y.z.tar 为实际文件名（如 bkhtmltopdf-ee-1.0.0.tar）。

验证加载​

docker images | grep bkhtmltopdf

应显示镜像 bkhtmltopdf-ee:x.y.z。

启动容器​

使用激活码启动容器。推荐配置：

  • --shm-size=256mb：分配共享内存，提高 Chromium 渲染性能。
  • -e BKHTMLTOPDF_LICENSE="YOUR_LICENSE"：替换为邮件中的激活码。
  • -p 8080:8080：映射端口到主机 8080。
  • --restart always：自动重启。
docker run --shm-size=256mb --name bkhtmltopdf-ee \
  -e BKHTMLTOPDF_LICENSE="YOUR_LICENSE" \
  -itd --restart always -p 8080:8080 bkhtmltopdf-ee:x.y.z
  • 替换 YOUR_LICENSE 为实际激活码。
  • 替换 x.y.z 为版本号（如 1.0.0）。

查看日志：

docker logs bkhtmltopdf-ee

启动成功日志类似：

Tomcat started on port 8080 (http) with context path '/'
Started Application in 1.792 seconds

验证部署​

BKHTMLTOPDF EE