davidhoeck/prerender

Prerender镜像说明

镜像概述

Prerender是一个Node.js服务器，通过Headless Chrome渲染网页内容，支持输出HTML、截图（JPEG/PNG）、PDF和HAR文件。它可帮助JavaScript驱动的网站解决SEO问题，让搜索引擎能抓取到完整渲染后的页面，也可用于网页爬取场景获取目标页面的结构化内容。

核心功能

• 渲染网页为静态HTML，移除脚本标签避免客户端二次渲染
• 生成网页截图（支持视口或全页）、PDF文件和HAR网络请求记录
• 支持自定义用户代理、屏幕尺寸、重定向处理等参数
• 提供插件系统（如基础认证、域名黑白名单、缓存等）扩展功能

使用场景

1. SEO优化：为React、Vue等单页应用提供预渲染HTML，让搜索引擎抓取到完整内容
2. 网页爬取：批量获取目标网页的渲染后内容、截图或PDF，用于数据分析或存档
3. 测试验证：验证网页在不同屏幕尺寸下的渲染效果，或捕获网络请求详情

配置说明

环境变量

• PAGE_DONE_CHECK_INTERVAL：页面加载状态检查间隔（默认500ms）
• PAGE_LOAD_TIMEOUT：页面加载超时时间（默认20000ms）
• WAIT_AFTER_LAST_REQUEST：最后一次请求完成后的等待时间（默认500ms）
• FOLLOW_REDIRECTS：是否跟随重定向（默认false）
• BASIC_AUTH_USERNAME/BASIC_AUTH_PASSWORD：基础认证凭据（启用basicAuth插件时需设置）
• ALLOWED_DOMAINS：允许渲染的域名列表（逗号分隔，启用whitelist插件时需设置）
• BLACKLISTED_DOMAINS：禁止渲染的域名列表（逗号分隔，启用blacklist插件时需设置）

常用插件

• basicAuth：启用基础认证，限制服务访问
• removeScriptTags：移除渲染后的HTML中的脚本标签
• httpHeaders：根据页面meta标签设置响应状态码和头部
• whitelist/blacklist：限制可渲染的域名范围

Docker部署示例

快速启动

bash
docker run -d -p 3000:3000 --name prerender davidhoeck/prerender

测试渲染

bash
curl http://localhost:3000/render?url=https://www.example.com

带基础认证的启动

bash
docker run -d -p 3000:3000 \
  -e BASIC_AUTH_USERNAME=admin \
  -e BASIC_AUTH_PASSWORD=secret \
  --name prerender davidhoeck/prerender

带域名白名单的启动

bash
docker run -d -p 3000:3000 \
  -e ALLOWED_DOMAINS=[***] \
  --name prerender davidhoeck/prerender