HTML转多格式渲染Docker镜像（原repo名：html2pdf）

概述

本Docker镜像基于Puppeteer（无头Chrome/Chromium）构建，专注于将HTML内容高效渲染为PDF、PNG等多种格式文件。原代码仓库名称为html2pdf，提供了浏览器级别的HTML解析与渲染能力，确保输出文件与网页显示效果一致。

核心功能与特性

Puppeteer引擎：集成无头Chrome/Chromium，完整支持现代HTML/CSS/JS特性，渲染效果精准
多格式输出：支持PDF（可配置页面大小、边距、方向）、PNG（支持指定分辨率）等主流格式
轻量容器设计：优化镜像体积，减少运行时资源占用，适合批量处理场景
灵活配置：支持自定义渲染参数（如超时时间、加载策略、截图区域等）

使用场景

动态报告生成：将HTML格式的业务报告、数据分析结果转换为PDF存档
票据导出：电商平台、财务系统中将HTML发票、订单详情导出为PDF
网页快照：定期对网站页面进行PNG截图，用于监控或存档
自动化工作流：集成到CI/CD管道，实现HTML模板到多格式文件的自动转换

使用方法与配置说明

基础使用示例（Docker Run）

bash
# 将本地HTML文件渲染为PDF
docker run --rm \
  -v $(pwd)/input:/app/input \
  -v $(pwd)/output:/app/output \
  html2pdf-image \
  --input /app/input/source.html \
  --output /app/output/result.pdf \
  --format pdf \
  --page-size A4 \
  --margin 10mm,10mm,10mm,10mm

关键配置参数

参数名	说明	默认值
`--input`	输入HTML文件路径（容器内路径，需通过`-v`挂载本地文件）	无（必填）
`--output`	输出文件路径（容器内路径，需通过`-v`挂载本地目录）	无（必填）
`--format`	输出格式，可选值：`pdf`、`png`	`pdf`
`--page-size`	PDF页面尺寸，支持`A4`、`Letter`、`Legal`等标准尺寸或自定义尺寸（如`800x600`）	`A4`
`--margin`	PDF边距，格式为`上,右,下,左`（单位：px/mm/cm），如`20px,15px,20px,15px`	`0mm,0mm,0mm,0mm`

容器运行注意事项

资源配置：渲染复杂HTML时建议分配至少512MB内存，避免因资源不足导致渲染失败
沙箱模式：部分环境需添加--cap-add=SYS_ADMIN或传递--no-sandbox参数至Puppeteer（通过镜像环境变量PUPPETEER_EXTRA_ARGS配置）
外部资源加载：若HTML包含外部CSS/JS/图片，需确保容器网络通畅或提前将资源挂载至容器内

环境变量说明

变量名	作用	示例值
`PUPPETEER_EXTRA_ARGS`	传递给Puppeteer的额外启动参数（解决容器内运行限制）	`--no-sandbox --disable-gpu`
`RENDER_TIMEOUT`	HTML加载与渲染超时时间（单位：毫秒）	`30000`（30秒）
`DEFAULT_FORMAT`	设置默认输出格式，无需每次指定`--format`参数	`pdf`