bedrockio/export-html Docker Image Overview

bedrockio/export-html

bedrockio

使用Google Chrome将HTML导出为PDF/PNG的Docker容器

下载次数: 0状态：社区镜像维护者：bedrockio仓库类型：镜像最近更新：1 年前

轩辕镜像，不浪费每一次拉取。点击查看

中文简介版本下载

轩辕镜像，不浪费每一次拉取。点击查看

export-html Docker镜像文档

镜像概述

export-html是一个基于Google Chrome的Docker容器，提供HTTP API服务，用于将HTML内容或URL转换为PDF或PNG格式文件。该镜像利用Chrome的渲染引擎实现高质量的HTML转码，适用于自动化文档生成、网页截图等场景。

核心功能与特性

多格式支持：支持将HTML内容或URL转换为PDF和PNG两种格式
灵活配置：可自定义页面大小、边距、缩放比例等输出参数
HTTP API：通过简单的HTTP接口实现转换功能，易于集成
渲染准确：基于Google Chrome引擎，确保HTML/CSS渲染效果与浏览器一致
轻量部署：容器化设计，支持快速部署和扩展

使用场景

自动化报表生成：将动态HTML报表转换为PDF文档
网页截图服务：将指定URL转换为PNG图片
文档导出功能：将富文本HTML内容转为标准化PDF
批量处理任务：通过API批量转换HTML资源为图片或文档

使用方法

快速启动

通过以下命令启动容器：

bash
docker run -d -p 3000:3000 --name export-html bedrockio/export-html

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  export-html:
    image: bedrockio/export-html
    ports:
      - "3000:3000"
    environment:
      - PORT=3000  # API服务端口，默认3000
      - CHROME_FLAGS=--no-sandbox --disable-gpu  # Chrome启动参数
    restart: always

启动服务：

bash
docker-compose up -d

API使用说明

转换接口

端点：POST /convert
Content-Type：application/json
请求参数：
- input (必填)：HTML内容字符串或URL
- format (可选)：输出格式，pdf或png，默认pdf
- options (可选)：转换配置选项

请求示例

HTML内容转PDF：

bash
curl -X POST http://localhost:3000/convert \
  -H "Content-Type: application/json" \
  -d '{
    "input": "<!DOCTYPE html><html><body><h1>测试文档</h1><p>这是一个HTML转PDF示例</p></body></html>",
    "format": "pdf",
    "options": {
      "pageSize": "A4",
      "margin": {
        "top": "2cm",
        "right": "2cm",
        "bottom": "2cm",
        "left": "2cm"
      },
      "scale": 1.0
    }
  }' --output result.pdf

URL转PNG：

bash
curl -X POST http://localhost:3000/convert \
  -H "Content-Type: application/json" \
  -d '{
    "input": "[***]",
    "format": "png",
    "options": {
      "width": 1280,
      "height": 720,
      "fullPage": false
    }
  }' --output screenshot.png

配置选项说明

options参数支持以下配置：

参数	类型	说明
pageSize	string	PDF页面大小，如"A4"、"Letter"、"Legal"等
margin	object	页边距设置，包含top/right/bottom/left属性，单位支持"cm"、"mm"、"in"
scale	number	缩放比例，默认1.0
width	number	PNG宽度（像素）
height	number	PNG高度（像素）
fullPage	boolean	是否截取整页（仅PNG），默认false
landscape	boolean	是否横向排版（仅PDF），默认false