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 下载 Linux ARM64

macOS arm64

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

下载 Apple Silicon Server 下载 Intel Server
Go Agent (受控端)

2026-11-04 更新 · 三个平台使用同一套 Go 代码。安装脚本同时下载 relayexec、relaycp、relaysync。

Linux Go Agent

Go

Go 原生受控端,无需 Python。支持 x86_64 / ARM64,可由当前用户的 systemd 服务运行。

下载 x86_64 下载 ARM64 安装脚本

macOS Go Agent

Go

与 Linux、Windows 共用 Go 实现。支持 Apple Silicon / Intel,可由当前用户的 LaunchAgent 运行。

下载 Apple Silicon 下载 Intel 安装脚本

Windows Go Agent

Go

原生 ConPTY 终端,支持 Windows 10 1809 及以上。无需 WSL 或 Python,以当前用户身份运行。

下载 x64 下载 ARM64 安装脚本

下载 SHA-256 校验清单 · 首次安装默认连接中国大陆测试服务器(101.201.236.233);已有配置、配对码和权限设置会保留。

Client (控制端)

macOS(Apple M 系列)

推荐

macOS 客户端 1.0.2,支持 Apple M 系列芯片,要求 macOS 26.2 或以上。当前包未公证,首次运行可能需前往系统设置 → 隐私与安全性允许打开。

下载 M 系列版(macOS 26.2+)

HarmonyOS

HarmonyOS 客户端 1.1,同一安装包适配手机和 2in1,支持原生 QUIC、终端快捷键与连接延迟显示。

下载 HarmonyOS 1.1(.hap) 发布归档(.app)

Web 终端

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

打开 Web 终端

Android

开放下载

Android 客户端 1.0.1,支持 Android 7.0 及以上。

下载 .apk

iOS

暂未开放

iPhone / iPad 客户端,暂未开放公开下载。

敬请期待

Windows

1.0.2

Windows x64 客户端 1.0.2,自带 .NET 运行时。支持目录浏览、环境变量、永久信任确认及默认目录占用筛选。

下载 Windows 1.0.2
Go CLI 客户端(控制端)

2026-11-04 更新 · 终端客户端与 relayexec、relaycp、relaysync 同包提供,支持持久会话和双向工具调用。

Linux Go CLI

解压后按包内 README 安装,使用目标 Agent 的配对码连接。

下载 x64下载 ARM64

macOS Go CLI

解压后按包内 README 安装,使用目标 Agent 的配对码连接。

下载 Apple Silicon下载 Intel

Windows Go CLI

解压后按包内 README 安装,使用目标 Agent 的配对码连接。

下载 x64下载 ARM64

使用说明

三步即可开始:部署 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. Linux / macOS 安装

curl -fsSL --noproxy '*' https://www.made2020.cn/rt6k/install.sh \
  -o install-relayterm.sh
sh install-relayterm.sh --owner YOUR_ACCOUNT

使用普通用户运行。安装后会显示配对码和 machine_id,并注册为当前用户的后台服务。

2. Windows 安装

$web = New-Object System.Net.WebClient
$web.Proxy = $null
$web.DownloadFile('https://www.made2020.cn/rt6k/i.ps1', "$PWD\install-relayterm.ps1")
powershell -NoProfile -ExecutionPolicy Bypass `
  -File .\install-relayterm.ps1 -Owner YOUR_ACCOUNT

Windows 安装器使用当前用户目录,不需要管理员权限。把 YOUR_ACCOUNT 换成 RelayServer 用户系统中的账号。

3. 连接与机器名称

  • 首次安装默认连接中国大陆测试服务器(101.201.236.233);客户端服务器列表可选择中国大陆、东京或东京备用。
  • Agent 连接后显示 6 位配对码和 machine_id。客户端添加受控端时输入配对码。
  • --owner 控制账号列表中的可见性;--name 设置客户端显示的机器名称。
  • 配置会保存配对信息;重新安装保留已有配置和权限设置。

4. AI 执行与文件同步

AI 远程执行接口和同步删除默认关闭,需要时显式开启:Linux / macOS 安装器使用 --allow-exec、--allow-delete;Windows 使用 -AllowExec、-AllowDelete。终端会话和文件传输按现有 Agent 配置工作。

5. 状态与版本

# Linux / macOS
~/.local/bin/relayterm-agent --version
sh install-relayterm.sh --status

# Windows
powershell -NoProfile -ExecutionPolicy Bypass `
  -File .\install-relayterm.ps1 -Status

下载文件可使用 SHA-256 清单核对。Windows 客户端首次启动账号密码为空,只记住上次成功登录的凭据。