RelayTerm

安全、轻量的远程终端中继方案。通过 QUIC 协议连接 Agent 和客户端，无需公网 IP、无需 SSH 端口暴露。

QUIC 加密传输
配对码即连
多平台 Agent
多会话终端
实时资源监控
立即下载 查看文档
Agent (受控端)
──QUIC──>
Relay Server
<──QUIC──
Client (控制端)
Agent 和 Client 均主动连接 Server，通过 6 位配对码建立中继通道。双方无需直连，Server 纯转发。

下载

选择你需要的组件。Server 部署一台，Agent 装在被控机器上，Client 装在你的设备上。

Relay Server

Linux x86_64

推荐

适用于 Linux 服务器部署，单二进制文件，无依赖。

下载 Server

macOS arm64

适用于 Apple Silicon Mac 本地开发调试。

下载 Server
Agent (受控端)

Linux / macOS (Python)

跨平台

Python 3.8+ 跨平台 Agent，适用于所有 Unix 系统。依赖 aioquic。

下载 pyAgent

macOS arm64 (Native)

Swift 原生 Agent，使用 Network.framework QUIC，性能更优。

下载 macOS Agent

Windows

暂未开放

Windows 原生 Agent，计划中。当前可通过 WSL 运行 pyAgent。

敬请期待
Client (控制端)

macOS

推荐

原生 macOS 客户端，QUIC 传输，多 Tab 终端，文件浏览，环境变量管理。

下载 .dmg

HarmonyOS

鸿蒙 PC / 平板客户端，三栏布局，NDK QUIC 原生通信。

下载 .hap

Web 终端

浏览器直接使用，WebSocket 传输，无需安装。功能较客户端精简。

打开 Web 终端

Android

暂未开放

Android 客户端，开发中。

敬请期待

iOS

暂未开放

iPhone / iPad 客户端，开发计划中。

敬请期待

Windows

暂未开放

Windows 桌面客户端，开发计划中。

敬请期待

使用说明

三步即可开始：部署 Server → 启动 Agent → 客户端输入配对码连接。

Server 部署指南

1. 环境要求

  • Linux x86_64 或 macOS arm64
  • 开放端口：9090/UDP（QUIC）+ 8080/TCP（HTTP/WebSocket）
  • 可选 8443/TCP（HTTPS）

2. 部署

# 解压后进入目录
cd server/

# 启动（后台运行，自动写日志）
./start.sh

# 带公网 IP 参数（用于自签证书 SAN）
./relayterm YOUR_PUBLIC_IP

# 查看日志 / 停止
./logs.sh -f
./stop.sh

3. 端口说明

  • 9090/UDP — QUIC 主通道，Agent 和 Client 均连此端口
  • 8080/TCP — HTTP Admin API + WebSocket + 首页
  • 8443/TCP — HTTPS（自签证书，自动生成）

4. Admin API

# 登录获取 token
curl -X POST http://SERVER_IP:8080/admin/login \
  -d '{"username":"admin","password":"admin_pass"}'

# 查看在线 Agent
curl -H "Authorization: Bearer TOKEN" \
  http://SERVER_IP:8080/admin/agents

5. 默认凭据

  • 用户名：admin 密码：admin_pass
  • 首次部署后请修改
Agent 使用指南

1. Python Agent（跨平台）

# 安装依赖
pip3 install aioquic

# 启动（连接到 Server）
python3 -m agent.pyAgent SERVER_IP 9090

# 指定 owner（配对码仅对该用户可见）
python3 -m agent.pyAgent SERVER_IP 9090 --owner admin

启动后终端会显示 6 位配对码，在客户端输入即可连接。

后台运行：nohup python3 -m agent.pyAgent ... &

2. macOS Native Agent

./RelayTermAgent SERVER_IP 9090
./RelayTermAgent SERVER_IP 9090 --owner admin

3. 配对码机制

  • Agent 连接 Server 后自动获得 6 位数字配对码
  • 断线重连自动复用旧配对码（如未被占用）
  • 同一台机器重复启动 Agent 会替换旧实例

4. Owner 权限

  • 不带 --owner：配对码对所有用户隐藏，需手动输入
  • 带 --owner admin：仅 admin 可在列表直接看到配对码
  • 其他用户仍可手动输入配对码连接

5. 资源上报

  • 每 5 秒自动上报 CPU / 内存 / 系统信息
  • 客户端可通过 payload_req 拉取详细信息

6. 状态页（仅 pyAgent）

本地访问 http://127.0.0.1:8999/ 可查看当前配对码。