relay-core — zsh 
$ relay-core --version
relay-core 0.14.0

$ relay-core ca generate
CA certificate generated at ~/.relay-core/ca_cert.pem

$ relay-core start
RelayCore daemon started
  Proxy   127.0.0.1:8080
  Control http://127.0.0.1:8082/
  MCP     http://127.0.0.1:18083/mcp
  CA      cert=~/.relay-core/ca_cert.pem key=~/.relay-core/ca_key.pem
▋

基于 Rust 的流量拦截引擎

吞吐量为 mitmproxy 的约 40 倍。支持 HTTP/HTTPS/WebSocket 的 MITM 代理，可编程控制流量拦截。

开始使用 GitHub 仓库
// 功能特性

RelayCore 功能

完整 MITM 支持

动态 TLS 证书生成，自动 CA 安装。

WebSocket 拦截

双向 WebSocket 通信的消息级检查、修改和重放。

规则引擎

基于匹配条件对请求头、请求体、响应状态进行拦截、重定向或 mock。

脚本扩展

内置 Deno 运行时，支持动态修改请求和响应。

拦截断点

暂停实时流量，检查、修改，然后继续或丢弃。

Prometheus 指标

内置 Prometheus 文本格式和 JSON 指标端点。

面向 AI Agent 的 MCP

MCP 服务端把 flow、规则与指标暴露为工具与可订阅资源，agent 既能读实时流量，也能操作它。

gRPC 与 h2c

双向支持明文 HTTP/2（含 CONNECT 隧道内），并解析 gRPC 消息分帧、记录 trailers。

// STRUCTURE

架构

ADAPTER LAYER public crates PUBLIC relay-core-http REST + SSE PUBLIC relay-core-probe MCP · AI PUBLIC relay-core-tauri RelayCraft PUBLIC relay-core-cli CLI · TUI · embedded HTTP INTERNAL relay-core-api Flow · Rule · Policy · Event PUBLIC relay-core-runtime CoreState lifecycle · rule store · event bus · proxy spawn ENGINE internal crates INTERNAL relay-core-lib MITM · HTTP/HTTPS · WebSocket · TLS · rule execution interceptor chain: Script → Rule → Metrics → adapter INTERNAL relay-core-storage SQLite optional persist · flows · audit INTERNAL relay-core-script Deno/V8 (optional) feature "script"
PUBLIC relay-core-runtime 状态编排、生命周期、规则
PUBLIC relay-core-http REST + SSE 适配器
PUBLIC relay-core-probe AI 代理 MCP 适配器
PUBLIC relay-core-cli CLI · TUI · 内嵌 HTTP API
INTERNAL relay-core-api Flow / Rule 共享契约
INTERNAL relay-core-lib MITM · 代理 · 规则执行
INTERNAL relay-core-script Deno/V8 脚本（可选）
INTERNAL relay-core-storage SQLite 持久化（可选）
// METRICS

性能

~39K
req/s
吞吐量 (S1)
~139
ms
冷启动
~59
MB
空闲 RSS
~3.4
ms
P99 延迟增加
指标 RelayCore mitmproxy
语言 Rust Python
吞吐量 ~39K req/s ~2.5K req/s
P99 延迟 ~3.4 ms ~150 ms
冷启动 ~139 ms ~1.5 s
脚本运行时 Deno / TypeScript Python 插件
部署形态 单一静态二进制 Python + 依赖树
规则配置 JSON / YAML 规则，无需重启 插件脚本 + 重启

测试环境：M4 Max / macOS 27 / 64 GB，1 KB 载荷。与 mitmproxy 的吞吐对比取自 compare_mitmproxy.sh （100 并发）：relay-core 38,884 req/s、P99 3.42 ms，mitmproxy 2,517 req/s、150.44 ms， 吞吐比 15.45×。冷启动与空闲 RSS 取自 v0.14.0 release baseline（139.2 ms / 58.8 MB）。 完整方法与原始数据见 benchmarks/。

// REST API

HTTP API

GET http://127.0.0.1:8082/api/v1/flows?limit=10
Response 200 OK
{
  "flows": [
    {
      "id": "fld_01HX5K9P3Q8Y2Z7",
      "method": "GET",
      "path": "/users",
      "status": 200,
      "duration_ms": 42
    }
  ],
  "pagination": {
    "total": 12847,
    "returned": 10,
    "offset": 0
  }
}
GET
/api/v1/flows
搜索和分页流量
GET
/api/v1/flows/:id
获取流量详情
GET
/api/v1/rules
列出所有规则
PUT
/api/v1/rules
更新或创建规则
DELETE
/api/v1/rules/:id
删除规则
POST
/api/v1/intercepts
创建拦截规则
GET
/api/v1/events
SSE 实时更新流
GET
/api/v1/metrics/prometheus
Prometheus 格式指标
// COMMAND LINE

CLI 参考

$ relay-core run --listen 127.0.0.1:8080
RelayCore proxy started
  Proxy   127.0.0.1:8080
  Control http://127.0.0.1:8082/
  TUI     run with --ui for interactive mode
  CA      cert=~/.relay-core/ca_cert.pem key=~/.relay-core/ca_key.pem
$ relay-core ca generate
CA certificate generated at ~/.relay-core/ca_cert.pem
$ relay-core rules list
No rules loaded.
$ relay-core metrics
Metric                    | Value
--------------------------|-----------
Flows Total               | 128
Flows In Memory           | 100
Intercepts Pending        | 0
Rule Exec Errors          | 0
relay-core run 启动代理服务器
relay-core run --ui 启动 TUI 界面
relay-core ca generate CA 证书管理
relay-core rules list 规则管理
relay-core run --api-port 8082 启用 REST API
relay-core run --upstream http://corp-proxy:8080 串接上级代理（见 代理模式）
relay-core analyze --file flows.jsonl 离线分析流量 dump
relay-core flows --host example.com 搜索流量（需 --api-port）
// 安装

开始使用

Cargo

cargo install relay-core-cli

npm

npm install -g @relay-core/cli

从源码编译

git clone https://github.com/relaycraft/relay-core && cd relay-core && cargo build --release

下一步