hfreire/browser-as-a-service

浏览器即服务：将JavaScript网页渲染为HTML

![Build Status]([] ![Coverage Status]([]

基于 https://github.com/hfreire/serverful 框架，通过REST API暴露 https://github.com/segmentio/nightmare 无头浏览器，实现浏览器即服务。

镜像概述

该镜像将浏览器作为服务托管，提供REST API接口，用于将JavaScript驱动的网页渲染为静态HTML内容。支持Docker容器化部署，无需手动管理依赖，同时可在AWS上通过Antifragile Infrastructure实现监控和弹性扩展。

核心功能

• 容器化部署：通过Docker容器运行，简化依赖管理，快速启动服务；
• AWS扩展支持：结合Antifragile Infrastructure，实现AWS环境下的监控和容量扩展；
• REST API接口：提供标准化API端点，支持网页渲染请求，Swagger文档可查看详细接口定义；
• 可配置性：通过环境变量调整服务端口、API密钥、超时时间等参数。

使用场景

• 服务端渲染（SSR）：为单页应用（SPA）提供SEO友好的静态HTML输出；
• 网页内容抓取：批量获取JavaScript渲染后的网页内容；
• 自动化测试：辅助前端页面的自动化测试，获取渲染后的页面状态。

配置说明

环境变量

Docker部署示例

启动容器

后台运行容器并暴露端口9453：

bash
docker run -d -p "9453:3000" hfreire/browser-as-a-service

调用API渲染网页

使用curl请求渲染Google首页：

bash
curl -X GET --header 'x-api-key: my-api-key' 'http://localhost:9453/open?url=https%3A%2F%2Fwww.google.com'

查看API文档

Swagger文档地址：http://localhost:9453/docs

构建与部署

构建镜像

1. 克隆代码仓库：

bash
git clone https://github.com/hfreire/browser-as-a-service.git

2. 进入目录：

bash
cd browser-as-a-service

3. 执行构建脚本：

bash
npm run build

AWS部署

需提前安装terraform并配置Antifragile Infrastructure：

1. 克隆代码仓库（同上）；
2. 进入目录（同上）；
3. 执行部署脚本：

bash
npm run deploy

部署环境变量说明：

贡献与许可

贡献方式

可通过代码贡献（新功能、bug修复、文档完善）或***。***款项将用于支持UNHCR相关项目。

许可协议

详见 https://github.com/hfreire/browser-as-a-service/blob/master/LICENSE.md%E3%80%82