postor/ssr-proxy-puppeteer

ssr-proxy-puppeteer镜像说明

镜像概述

本镜像基于Puppeteer实现服务端渲染（SSR）代理功能，旨在解决传统单页应用（SPA）因客户端渲染导致的SEO不友好问题，帮助SPA页面被搜索引擎更好地抓取和索引。支持多种主流前端框架，配置灵活，部署便捷。

核心功能

1. SSR代理服务：将SPA页面预渲染为静态HTML内容，返回给搜索引擎爬虫；
2. 多框架支持：适配Vue、Angular、React等常见前端框架；
3. 缓存策略：支持内存、Redis、Memcached等多种缓存存储方式，可配置缓存有效期；
4. 自定义处理：允许根据请求情况修改响应body内容（如重写URL）；
5. 灵活配置：可自定义服务端口、超时时间、Puppeteer启动参数等。

使用场景

1. 传统SPA应用需要提升SEO排名；
2. 动态内容较多的网站需要预渲染以优化搜索引擎抓取；
3. 快速部署轻量级SSR解决方案，无需改造现有前端代码。

配置说明

简单配置示例

javascript
{
  "ssr": {
    "origin": "http://你的SPA源地址"
  }
}

复杂配置示例

javascript
module.exports = {
  ssr: {
    origin: "http://localhost:8080", // 源SPA服务地址
    port: 3002, // 代理服务端口
    timeout: 10000, // Puppeteer渲染超时时间（毫秒）
    ttl: 86400, // 缓存有效期（秒）
    // 判断是否需要修改响应body的函数
    bodyNeedModify: function (origin, req, res, proxyRes) {
      // 返回布尔值
    },
    // 修改响应body的函数
    bodyModifier: function (body, origin, req, res, proxyRes) {
      // 返回修改后的字符串
    }
  },
  cache: {
    store: "cache-manager-redis", // 缓存存储类型（支持Redis、Memcached、内存）
    db: 2 // Redis数据库编号
  },
  puppeteer: {} // Puppeteer启动选项（参考官方文档）
}

默认配置可参考：https://github.com/postor/ssr-proxy-puppeteer/blob/master/src/default-config.js

Docker部署示例

拉取镜像

bash
docker pull postor/ssr-proxy-puppeteer

运行容器

bash
docker run -p 3003:3000 -it --rm postor/ssr-proxy-puppeteer ssr-proxy-puppeteer --origin=http://你的SPA源地址:端口

（注：将你的SPA源地址:端口替换为实际的SPA服务地址）