RelayRPC

轻量级 RPC 转发与任务调度系统。Consumer 通过 HTTP 提交任务，调度器将任务分发给通过 WebSocket 连接的 Worker 执行。

Consumer -> HTTP -> 调度器 -> WebSocket -> Worker
Consumer <- HTTP <- 调度器 <- WebSocket <- Worker

性能

真机（iOS 设备，局域网 WiFi，零延迟任务处理）实测，数据反映端到端转发 + 调度开销。成功率 100%，无数据竞争（go build -race 压测验证）。

部署	稳态吞吐	峰值吞吐	串行 P50 延迟
单设备	~130 req/s	~141 req/s	~8 ms
双设备	~243 req/s	~263 req/s	~8 ms

双设备

并发	请求数	成功率	吞吐量	P50	P90	P99
1	50	100%	78 req/s	8.6 ms	11.9 ms	104 ms
10	100	100%	222 req/s	45 ms	51 ms	58 ms
50	200	100%	224 req/s	214 ms	246 ms	249 ms
100	300	100%	263 req/s	361 ms	394 ms	401 ms
200	400	100%	246 req/s	793 ms	819 ms	880 ms
50（持续）	500	100%	243 req/s	205 ms	231 ms	241 ms

单设备

并发	请求数	成功率	吞吐量	P50	P90	P99
1	50	100%	106 req/s	8.1 ms	9.6 ms	17 ms
10	100	100%	139 req/s	71 ms	78 ms	80 ms
50	200	100%	134 req/s	371 ms	389 ms	397 ms
100	300	100%	141 req/s	676 ms	708 ms	804 ms
50（持续）	500	100%	126 req/s	370 ms	463 ms	561 ms

• 近线性扩展：双设备达到单设备的 ~1.9 倍，调度层开销可忽略，瓶颈在单设备串行执行能力。
• 轮询调度负载均匀（400 任务串行测试在两台设备上 200:200 平分）。
• 故障转移对调用方透明：Worker 执行中断开，任务自动重新调度到存活 Worker（at-least-once 交付）。
• 容量估算：目标吞吐 ÷ ~130 ≈ 所需设备数。

项目结构

scheduler/       Go 调度服务（零外部依赖，纯内存）
workers/         Worker 客户端实现
  ios/           iOS tweak（Theos，注入 SpringBoard）
  android/       （预留）
  js/            （预留）

快速开始

1. 生成 Token

cd scheduler
./scripts/gen-tokens.sh

2. 启动调度器

cd scheduler
go run ./cmd/relayrpc-server

3. 连接 Worker

iOS：安装 deb tweak，在设置中配置 token 和服务器地址。

Simulator：

go run ./cmd/relayrpc-worker-sim --token <uuid>

4. 提交任务

curl -X POST http://localhost:8080/api/v1/tasks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"payload":{"action":"hello"},"wait_timeout_ms":10000}'

返回：

{"task_id":"...","success":true,"status":"succeeded","result":{...}}

若 wait_timeout_ms 内无 Worker 完成，返回 HTTP 202：

{"task_id":"...","status":"pending","message":"task is still processing"}

鉴权

Token 是 UUID，配置在 scheduler/configs/config.yaml 中。任何有效 token 既能提交任务也能连接 WebSocket 作为 Worker，token 不区分角色。作为 Worker 连接时，token 同时用作该 Worker 的身份标识。

编译 iOS Worker

cd workers/ios/RelayRPCWorker

# Rootful（iOS 13+）
make package ROOTFUL=1

# Rootless（iOS 15+）
make package

# Roothide（iOS 15+）
make package ROOTHIDE=1

社区交流

RelayRPC 已经聚集了不少开发者和用户持续交流，目前已建立多个微信交流群。

微信交流群（6群开放中）	公众号
1群：已满 2群：已满 3群：已满 4群：已满 5群：已满 6群：开放中	移动端Android和iOS开发技术分享

6群二维码如已过期，请添加微信 witchan028 或关注公众号 移动端Android和iOS开发技术分享 获取最新入群方式。

欢迎添加微信或关注公众号，获取最新动态与入群方式。

• 微信：witchan028
• 邮箱：witchan028@126.com

许可

本项目自有代码使用 MIT License，详见 LICENSE。

使用、修改、分发或合并本项目自有源码及其重要部分时，应保留版权声明和许可证文本。NOTICE 提供项目出处和免责说明。

本项目按 “AS IS” 方式提供，不提供任何明示或暗示担保。因使用、修改、分发、部署或运行本项目导致的设备异常、数据丢失、服务中断、账号风险、系统损坏、安全问题、商业损失或其他直接/间接影响，作者不承担责任。