商业级 完整的 Playwright 云服务 SaaS 系统

Playwright
云服务平台

用户管理 · 点数计费 · 实例集群管理 · WebSocket 代理。基于 Fastify + gRPC + SQLite/MySQL,支持 Docker 一键部署。Apache 2.0 协议

⭐ 查看源码 📖 文档
$ docker-compose up -d
3
核心组件
N
机器集群
100%
TypeScript
CI/CD
GitHub Actions
QUALITY

工程质量

4 个 GitHub Actions workflow 全程守护

✓ Code Quality ✓ Integration Tests ✓ E2E Tests ✓ Docker Build Apache 2.0 Fastify + Zod gRPC Swagger / Scalar JWT Auth
FEATURES

商业级特性

👥

多用户系统

管理员 / 普通用户角色。JWT 认证,会话管理,密码加密(bcrypt)。

💰

点数计费

按时长扣费,支持充值、消费记录查询。可配置不同费率。

🖥

实例集群

多台实例机器组成集群,自动负载均衡。机器健康检查,故障自动剔除。

🔌

WebSocket 代理

用户通过 WebSocket 连接到分配的浏览器实例,支持 CDP 协议全功能。

📡

gRPC 通信

管理服务器与实例机器之间使用 gRPC,高性能 Protobuf 序列化。

📦

Docker 部署

docker-compose 一键启动。支持 ARM64 / AMD64 多架构镜像。

📚

Swagger 文档

自动生成 OpenAPI 文档,Scalar UI 渲染。所有接口都有完整 Zod schema。

🔐

CDP 文件上传

分布式文件上传方案,通过 CDP 协议在远程浏览器上传文件。

🧪

SDK 客户端

提供 Node.js SDK,几行代码即可创建 Playwright 会话。

ARCHITECTURE

三段式架构

┌────────────────────────────────────────────────────────────┐
│                  用户 / SDK 客户端                          │
│              (Node.js / Python / cURL)                     │
└─────────────────────────┬──────────────────────────────────┘
                          │ HTTP API + JWT
                          ▼
┌────────────────────────────────────────────────────────────┐
│              管理服务器 (Manager)                           │
│  • 用户管理 / 点数计费 / Session 分配                       │
│  • Fastify + Swagger + Zod                                 │
└─────────────────────────┬──────────────────────────────────┘
                          │ gRPC
                          ▼
┌────────────────────────────────────────────────────────────┐
│            实例机器集群 (Machines × N)                     │
│  • 每台机器运行多个 Chrome 实例                            │
│  • WebSocket 代理 → 暴露给用户                             │
│  • Docker 容器化                                           │
└────────────────────────────────────────────────────────────┘

打造你自己的 Playwright 云

商业级架构 · 完整工程化 · 可直接对外服务