mecodia/weasyprint-server Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

docker-weasyprint

镜像概述和主要用途

docker-weasyprint 是一个基于 Alpine Linux 的轻量级 Docker 镜像，用于提供 WeasyPrint 作为 Web 服务。该镜像体积小巧（135MB+），通过 aquavitae 提供的 WSGI 服务器将 WeasyPrint 功能封装为 Web 服务，支持将 HTML 内容转换为 PDF 文件。

核心功能和特性

• 轻量级设计：基于 Alpine Linux，镜像体积仅 135MB+，资源占用低
• Web 服务化：通过 WSGI 服务器提供 HTTP 接口，支持 HTML 到 PDF 的转换
• 健康检查：提供健康检查接口，便于监控服务状态
• 版本查询：支持查询当前 WeasyPrint 版本（当前为 0.39）
• 字体自定义：可通过添加本地字体文件扩展字体支持

使用场景和适用范围

适用于需要通过 HTTP 接口将 HTML 内容动态转换为 PDF 的场景，如：

• 网页报表生成
• 动态文档转换
• 自动化 PDF 生成服务

使用方法和配置说明

Docker Compose 配置示例

yaml
services:
    weasyprint:
        build: .
        ports:
          - '5001:5001'

基本使用方法

1. 部署服务后，通过 POST 请求将 HTML 内容发送至 localhost:5001/pdf 接口
2. 服务将返回渲染后的 PDF 文件

健康检查与版本查询

• 健康检查：发送 GET 请求至 localhost:5001/health，响应为 ok 表示服务正常
• 版本查询：发送 GET 请求至 localhost:5001/version，将返回当前 WeasyPrint 版本（当前为 0.39）

字体配置

若需扩展 WeasyPrint 的字体支持，可按以下步骤操作：

1. 将字体文件复制到项目根目录下的 ./fonts 文件夹
2. 重新构建镜像，字体将自动被 WeasyPrint 识别和使用