beslaven/html-to-img

beslaven/html-to-img 镜像文档

镜像概述

beslaven/html-to-img是一个轻量级服务镜像，核心功能是将HTML内容或网页URL转换为图片格式（如PNG、JPG等）。通过暴露HTTP接口提供转换服务，支持容器化部署，适用于需要动态生成图片的应用场景。

核心功能与特性

• HTML转图片：支持将HTML字符串或网页URL转换为图片
• 多端口服务：默认暴露80和5000端口（分别映射到主机8081和8082端口）
• 容器化部署：支持Docker容器化运行，易于集成到现有系统
• 轻量级设计：镜像体积优化，部署资源占用低

使用场景

• 动态生成网页截图
• 批量将HTML报告转换为图片格式
• 服务端生成带样式的图片（如动态图表、自定义卡片等）
• 集成到CI/CD流程中，自动生成网页预览图

使用方法

构建镜像

通过Dockerfile构建本地镜像：

bash
docker build -t beslaven/html-to-img .

运行容器

使用以下命令启动服务容器：

bash
docker run -d -p 8081:80 -p 8082:5000 --name html-to-img beslaven/html-to-img

• -d：后台运行容器
• -p 8081:80：将容器80端口映射到主机8081端口
• -p 8082:5000：将容器5000端口映射到主机8082端口
• --name html-to-img：指定容器名称为html-to-img

服务访问

容器启动后，可通过以下地址访问服务：

• 8081端口：可能为Web管理界面或基础转换接口
• 8082端口：可能为API服务接口（具体接口文档需参考镜像内部实现）

配置说明

端口映射

默认配置下，容器暴露两个端口：

• 80端口：建议映射到主机8081端口，用于基础服务
• 5000端口：建议映射到主机8082端口，用于API服务

可根据实际需求调整主机端口映射，例如：

bash
docker run -d -p 9000:80 -p 9001:5000 --name html-to-img beslaven/html-to-img

持久化存储（可选）

如需持久化存储转换后的图片，可挂载本地目录到容器内指定路径（具体路径需参考镜像内部实现）：

bash
docker run -d -p 8081:80 -p 8082:5000 -v /本地路径:/容器内路径 --name html-to-img beslaven/html-to-img

注意事项

• 确保主机端口（如8081、8082）未被其他服务占用
• 对于复杂HTML或大型网页转换，可能需要调整容器资源限制（如--memory、--cpus参数）
• 具体API使用方法和支持的图片格式需参考镜像内部文档或接口说明