云渲染服务（Peer Stream）技术文档 - Draft

输入“/”快速插入内容

云渲染服务（Peer Stream）技术文档 - Draft

用户2045

6月18日修改

日期：2026-05-16​
项目：Peer Stream Go 版（UE5 Pixel Streaming 信令服务）​

一、概述

1.1 项目简介

Peer Stream 是为 Unreal Engine 5（UE5）Pixel Streaming 场景打造的信令服务（Signal Server），负责：​

•
协调浏览器（peer-stream）与 UE 实例之间的 WebRTC 媒体流信令​

•
跨机器调度与启动 UE 实例（通过 exec-ue 客户端）​

•
提供运维管理 API、监控、健康检查等生产级能力​

Go 重写版与原 Node.js 版 signal.js 行为完全兼容，可作为生产环境替代方案。​

1.2 核心组件

组件

路径

职责

替代

signal

cmd/signal

信令服务主程序

node signal.js

exec-ue

cmd/exec-ue

远程 UE 启动客户端

node exec-ue.js

signal logic

internal/signal

配置、WebSocket 枢纽、UE 池

—

peer-stream.js / signal.html

项目根

浏览器端代码（未改动）

—

1.3 关键特性

•
✅ Go 重写，行为兼容 Node.js 版​

•
✅ 跨机器启动 UE 实例（exec-ue 客户端）​

•
✅ 全局负载均衡（one2one / 共享模式）​

•
✅ UE 实例预加载、自动释放、健康检查​

•
✅ 21 个 REST API 端点​

•
✅ 6 张 SQLite 数据库表​

•
✅ HTTPS / WSS 支持​

•
✅ JWT 鉴权、IP 白名单、API 限流​

•
✅ WebSocket 实时状态推送​

二、核心功能

2.1 负载均衡与连接管理

功能

说明

one2one 模式

一个玩家对应一个 UE 实例，配置 one2one: true 启用

共享模式

默认模式，多个玩家共享一个 UE 实例

预加载 UE

preload 配置预启动 UE 实例数（one2one 模式有效）

自动释放

preloadReleaseTime 配置预加载 UE 自动释放时间（秒，0=不释放）

冷却时间

exeUeCoolTime 配置同一 UE 配置再次启动的冷却时间

鼠标释放

mouseReleaseTime 配置鼠标不操作自动释放资源时间

URL 前缀匹配

urlPrefix 配置 URL 前缀，strictUrlPrefix 开启严格匹配

自动匹配

找不到 urlPrefix 时自动匹配第一个 UE 实例

2.2 进程管理

•
查看进程列表（信令服务、UE 引擎、peer-stream 三种类型）​

•
杀掉指定端口的进程​

•
支持 Windows 和 Linux​

•
修复了"启动路径不存在导致 execue 崩溃"、"中文路径无法读取静态文件"、"nginx 反向代理时 kill 客户端失败"等历史 bug​

2.3 健康检查与自动重启

•
定期检查 UE 连接状态（可配置间隔）​

•
失败计数 + 自动重启（ueMaxFailures 阈值）​

云渲染服务（Peer Stream）技术文档 - Draft​

云渲染服务（Peer Stream）技术文档 - Draft