热门搜索:
dockette/rendertron
dockette
GoogleChrome/Rendertron Docker镜像，基于Headless Chrome的动态网页渲染解决方案，用于为不执行JavaScript的爬虫提供预渲染内容，帮助PWA提升SEO表现。
3 次收藏下载次数: 0状态：社区镜像维护者：dockette仓库类型：镜像最近更新：3 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Rendertron Docker镜像文档
镜像概述
Rendertron是由Google开发的Headless Chrome渲染解决方案，旨在动态渲染和序列化网页。该Docker镜像提供即开即用的服务，帮助渐进式Web应用（PWA）向不渲染或执行JavaScript的爬虫提供正确内容，解决PWA在搜索引擎索引中的内容可见性问题。服务通过Headless Chrome渲染请求页面，自动检测PWA加载完成状态后将响应序列化返回。
核心功能与特性
- 基于Puppeteer构建：利用Google Chrome的Puppeteer库实现Headless Chrome渲染能力
- SEO优化：为不执行JavaScript的爬虫提供预渲染内容，提升网站在搜索引擎中的索引效果
- 多中间件支持：兼容Express.js、Firebase Functions、ASP.net Core等多种中间件，便于集成到现有应用
- 状态码保留：保留原始请求的HTTP状态码，支持通过meta标签自定义返回状态码
- Web组件兼容：支持Web Components，需配合Shady DOM或相关polyfill使用
- 灵活配置：可自定义渲染超时时间、视口尺寸、服务端口等参数
使用场景
- PWA应用SEO优化：解决单页应用（SPA）在不支持JS的爬虫环境下内容无法被索引的问题
- 动态内容预渲染：为动态生成内容的网站提供服务端渲染能力，确保搜索引擎抓取完整内容
- 跨设备渲染测试：通过调整视口参数（宽度、高度、移动模式）测试页面在不同设备上的渲染效果
使用方法
本地运行（非Docker方式）
通过npm全局安装并启动：
bashnpm install -g rendertron rendertron
Docker部署
官方未提供Dockerfile，建议基于Puppeteer的Docker部署指南构建镜像。基本运行示例：
bash# 假设已构建包含Rendertron和Puppeteer依赖的镜像，镜像名为rendertron docker run -d -p 3000:3000 --name rendertron-service rendertron
API使用说明
渲染页面
GET /render/<url>
参数：
mobile：可选，默认false，传递?mobile启用移动版视图
示例：
GET http://localhost:3000/render/https://example.com/?mobile
生成截图
GET /screenshot/<url> POST /screenshot/<url>
GET参数：
width：默认1000，视口宽度height：默认1000，视口高度mobile：默认false，启用移动版视图
POST请求：可在请求体中传递JSON格式的额外截图参数（参考https://github.com/GoogleChrome/puppeteer/blob/v1.6.0/docs/api.md#pagescreenshotoptions%EF%BC%89%EF%BC%8C%E4%B8%8D%E6%94%AF%E6%8C%81%60type%60%E5%92%8C%60encoding%60%E5%8F%82%E6%95%B0%E3%80%82
配置参数
通过在镜像根目录放置config.json文件进行配置，支持以下选项：
| 参数 | 默认值 | 说明 |
|---|---|---|
datastoreCache | false | 启用Google Cloud Datastore缓存（仅GCP环境） |
timeout | 10000 | 页面渲染超时时间（毫秒） |
port | 3000 | 服务监听端口，若设置process.env.PORT环境变量则优先使用 |
width | 1000 | 默认渲染视口宽度 |
height | 1000 | 默认渲染视口高度 |
注意事项
- URL编码：传递带查询参数的URL时需使用
encodeURIComponent编码，例如：https://render-tron.appspot.com/render/http://my.domain/%3Fpage%3Dhome - Web组件处理：Web Components v0需启用Shady DOM；Web Components v1需设置
wc-inject-shadydom=true查询参数 - 渲染超时：默认10秒超时，需确保页面在超时前完成渲染
- 状态码自定义：通过
<meta name="render:status_code" content="404" />可自定义返回状态码
故障排除
Headless Chrome运行异常时，参考https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 rendertron 镜像标签
docker pull docker.xuanyuan.run/dockette/rendertron:<标签>
DockerHub 原生拉取命令
docker pull dockette/rendertron:<标签>
更多 rendertron 镜像推荐
ammobindotca/rendertron
ammobindotca
这是Rendertron的ARM架构（树莓派适用）自动构建镜像，基于无头Chrome实现网页动态内容渲染与序列化，帮助PWA为爬虫提供可索引内容，提升SEO效果。
6 次收藏10万+ 次下载
6 年前更新
enarbona/rendertron
enarbona
暂无描述
1 次收藏5万+ 次下载
5 年前更新
andoniz97/rendertron
andoniz97
暂无描述
5万+ 次下载
5 年前更新
samdotli/rendertron
samdotli
暂无描述
1 次收藏1万+ 次下载
8 年前更新
scandipwa/rendertron
scandipwa
这是ScandiPWA主题开发的Docker环境，基于Magento 2.3，提供预配置服务、内置Rendertron支持，适用于Linux系统下的主题开发场景。
1万+ 次下载
5 年前更新
egordm/rendertron
egordm
Rendertron是一个基于无头Chrome的渲染解决方案，旨在动态渲染和序列化网页，帮助渐进式Web应用(PWA)为不执行JavaScript的爬虫提供正确内容，提升SEO，可作为独立HTTP服务器运行。
1万+ 次下载
4 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"