Skip to content

concepts

Jump to bottom
Wiki Maintainer edited this page Aug 5, 2026 · 1 revision

核心概念

环境 (Environment)

资源的逻辑分组。按部署网络或用途划分，每个环境拥有独立的 Agent 和资源集合。

典型分组示例

环境 连接方式 说明
阿里云 直连 公网可直接访问
家里服务 Agent 代理 内网服务器
家庭 NAS Agent 代理 内网存储设备

环境组成

  • 名称（必填）+ 描述（选填）
  • 连接方式：Agent 代理或直连
  • 注册令牌：用于 Agent 注册
  • Agent 实例（可选）：一个环境最多一个 Agent
  • 资源列表：多个可连接资源

Agent

部署在目标网络中的轻量级反向代理进程。

工作原理

  • 从内网主动出站连接 Hub
  • 建立 WebSocket 加密隧道
  • 内网服务器无需开放入站端口

Agent 状态

状态 图标 说明
在线 🟢 正常连接
离线 ⚫ 未连接

Agent 元信息

  • 版本号
  • Agent ID
  • 连接 IP
  • 运行时间
  • 延迟
  • 传输量
  • 代理资源数

Agent 设备信息

  • 操作系统
  • 架构
  • 主机名
  • 系统版本

设备信息影响：

  • 终端提示
  • 平台差异提醒
  • 二进制下载推荐
  • 资源扫描

资源 (Resource)

可连接的远程实体，属于一个环境，通过指定协议连接。

支持的协议

协议 图标 用途 色值
SSH $ 远程终端 #3FB950 绿色
SFTP 📁 文件传输 #8B5CF6 紫色
MySQL dB 数据库查询 #58A6FF 蓝色
PostgreSQL pg 数据库查询 #8B5CF6 紫色
Redis R 缓存管理 #F85149 红色
SQLite S 本地数据库 #D29922 橙色
S3 / MinIO ☁ 对象存储 #E8912D 主色

资源配置

资源配置包含连接所需的所有参数：

{
  "host": "192.0.2.1",
  "port": 22,
  "username": "pi",
  "auth": {
    "type": "password",
    "passwordEncrypted": "..."
  },
  "terminal": {
    "encoding": "utf-8",
    "keepAliveSeconds": 60
  }
}

连接方式

方式 标识 说明
Agent 代理 ⬡ #E8912D 通过内网 Agent 隧道访问
直连 ◉ #58A6FF 控制台直接连接目标

选择建议

  • 直连：公网服务器、云服务（AWS/Azure/阿里云）
  • Agent 代理：内网服务器、NAS、无公网 IP 设备

数据安全

凭据加密流程

REX_SECRET_KEY
  ↓
派生加密密钥
  ↓
AES-256-GCM 加密敏感字段
  ↓
数据库只保存密文、nonce、算法标识

敏感字段

  • SSH 密码
  • SSH 私钥密码
  • MySQL 密码
  • PostgreSQL 密码
  • Redis 密码
  • S3 secret key

Clone this wiki locally