bedrockio/export-html

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 docker.xuanyuan.run/bedrockio/export-html

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  export-html:
    image: docker.xuanyuan.run/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": "https://example.com",
    "format": "png",
    "options": {
      "width": 1280,
      "height": 720,
      "fullPage": false
    }
  }' --output screenshot.png

配置选项说明

options参数支持以下配置：

环境变量配置