wildsurfer/prerender

wildsurfer/prerender 镜像说明

镜像概述

本镜像为prerender/prerender的Docker支持分支，是一个基于Node.js和Headless Chrome的网页渲染服务器。它能够加载任意网页，等待页面完全加载后返回渲染后的内容，支持多种输出格式，简化了网页预渲染和抓取的流程。

核心功能

• 多格式渲染：支持输出HTML、截图（JPEG/PNG）、PDF、HAR文件。
• 自动等待加载：通过监听网络空闲状态，确保页面完全加载后再返回内容。
• 并行处理：在Headless Chrome中以新标签页并行加载多个URL。
• 可配置化：支持自定义Chrome路径、请求日志、加载超时等参数。
• 插件扩展：提供基础认证、黑白名单、缓存等插件功能。

使用场景

1. SEO优化：与Prerender.io中间件配合，为搜索引擎（Google、Bing）和社交网络（、）提供预渲染的HTML内容，解决JavaScript网站的SEO问题。
2. 网页抓取：独立使用以爬取网页内容，用于数据解析或内容存档。

配置说明

支持以下关键配置参数（可通过环境变量或代码传入）：

• chromeLocation：自定义Chrome安装路径。
• logRequests：开启请求日志打印（默认false）。
• pageLoadTimeout：页面加载超时时间（默认20000ms）。
• followRedirects：是否跟随重定向（默认false，建议SEO场景保持默认）。
• 插件配置：如BASIC_AUTH_USERNAME/PASSWORD启用基础认证，ALLOWED_DOMAINS设置白名单等。

Docker部署示例

构建镜像

bash
git clone https://github.com/prerender/prerender.git
cd prerender
docker build -t wildsurfer/prerender .

运行容器

bash
docker run -d -p 3000:3000 wildsurfer/prerender

测试渲染

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

注意事项

• 本地测试时需确保Prerender服务器能访问目标本地网站。
• 使用中间件时，需设置PRERENDER_SERVICE_URL指向本地服务器（如export PRERENDER_SERVICE_URL=http://localhost:3000）。
• 相对链接可能在直接访问Prerender服务器时失效，建议通过中间件代理请求以保持链接有效性。