julezhou/playwright Docker Image Overview

julezhou/playwright

julezhou

基于Ubuntu 22.04构建的HTML渲染服务镜像，集成Node.js 18和Playwright，提供HTML转PDF/PNG的API接口，支持浏览器池管理，优化国内源配置，适用于文档生成、页面快照等场景。

下载次数: 0状态：社区镜像维护者：julezhou仓库类型：镜像最近更新：2 个月前

轩辕镜像，加速的不只是镜像。点击查看

中文简介版本下载

轩辕镜像，加速的不只是镜像。点击查看

HTML渲染服务镜像

镜像概述

本镜像基于Ubuntu 22.04构建，集成Node.js 18环境和Playwright工具，提供高效的HTML转PDF/PNG格式的API服务。通过浏览器池管理实现并发处理，优化国内软件源配置以提升依赖安装速度，适用于需要将HTML内容渲染为图片或文档的业务场景。

核心功能与特性

格式转换：支持HTML转PDF和PNG两种格式
浏览器池管理：通过配置参数控制浏览器实例数和上下文并发数
国内源优化：使用阿里云Ubuntu源和npmmirror镜像，加速依赖安装
轻量依赖：最小化安装必要系统库，减少镜像体积
健康检查：提供/health接口监控服务状态

使用场景

动态报告生成（如财务报表、数据分析报告）
网页快照服务（如电商商品页面截图）
文档导出功能（如在线编辑器内容导出为PDF）
自动化测试中的页面渲染验证

环境配置

环境变量

变量名	默认值	说明
BROWSER_WORKERS	2	启动的Chromium浏览器实例数量
MAX_CONTEXTS	4	每个浏览器实例可创建的最大上下文数

使用方法

构建镜像

准备以下文件：
- Dockerfile（见构建文件说明）
- package.json（见构建文件说明）
- server.js（见构建文件说明）

执行构建命令：

bash
docker build -t render-service:latest .

运行容器

基础运行

bash
docker run -d -p 3000:3000 --name render-service render-service:latest

自定义配置

bash
docker run -d -p 3000:3000 \
  -e BROWSER_WORKERS=4 \
  -e MAX_CONTEXTS=8 \
  --name render-service \
  render-service:latest

API接口说明

转PDF

请求方式：POST
地址：/render/pdf
参数：请求体为HTML源码（text/plain格式）
响应：application/pdf格式文件，文件名为result.pdf

请求示例：

bash
curl -X POST http://localhost:3000/render/pdf \
  -H "Content-Type: text/plain" \
  -d "<html><body><h1>测试PDF</h1><p>这是一个PDF渲染测试</p></body></html>" \
  -o result.pdf

转PNG

请求方式：POST
地址：/render/png
参数：请求体为HTML源码（text/plain格式）
响应：image/png格式文件

请求示例：

bash
curl -X POST http://localhost:3000/render/png \
  -H "Content-Type: text/plain" \
  -d "<html><body><h1>测试PNG</h1><p>这是一个PNG渲染测试</p></body></html>" \
  -o result.png

健康检查

请求方式：GET
地址：/health
响应：服务状态JSON，包含浏览器数量和最大上下文数

响应示例：

json
{
  "status": "UP",
  "browsers": 2,
  "maxContextsPerBrowser": 4
}

构建文件说明

Dockerfile

dockerfile
FROM ubuntu:22.04
LABEL authors="Jule"

# 配置阿里云源
RUN sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list && \
    sed -i 's/security.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list && \
    apt-get clean && apt-get update -y

# 安装基础依赖
RUN apt-get install -y --no-install-recommends \
    curl \
    ca-certificates \
    gnupg \
    unzip \
    wget \
    fontconfig \
    fonts-noto-cjk \
    fonts-liberation \
    libnss3 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxfixes3 \
    libxrandr2 \
    libgbm1 \
    libasound2 \
    libpangocairo-1.0-0 \
    libpango-1.0-0 \
    libgtk-3-0 \
    libxshmfence1 && \
    rm -rf /var/lib/apt/lists/*

# 安装Node.js 18并配置npm源
RUN curl -fsSL [***] | bash - && \
    apt-get update -y && apt-get install -y nodejs && \
    rm -rf /var/lib/apt/lists/* && \
    npm config set registry [***]

# 设置工作目录并拷贝业务文件
WORKDIR /app
COPY package.json ./
COPY server.js ./

# 安装依赖和Playwright Chromium
RUN if [ -f package.json ]; then npm install; fi && \
    npx playwright install chromium --with-deps

# 业务环境变量
ENV BROWSER_WORKERS=2
ENV MAX_CONTEXTS=4

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["node", "server.js"]

package.json

json
{
  "name": "render-service",
  "private": true,
  "type": "module",
  "dependencies": {
    "express": "^4.19.2",
    "playwright": "1.43.0"
  }
}