getting started

首次使用

1. 访问控制台

启动 REX Hub 后，打开浏览器访问：

http://localhost:8080

2. 设置密码

首次访问需要设置管理员密码。

密码要求：

• 最少 8 位
• 建议包含大小写字母和数字

3. 创建环境

环境是资源的逻辑分组，按部署网络或用途划分。

创建步骤

1. 进入「环境」页面
2. 点击「新建环境」
3. 填写信息：
   • 名称（必填）：如「阿里云」、「家里服务」
   • 描述（选填）：简要说明
   • 连接方式：
     • 直连：公网可直接访问
     • Agent 代理：需要部署 Agent
4. 保存

典型分组

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

4. 部署 Agent（可选）

如果需要访问内网资源，需要在目标网络部署 Agent。

Agent 注册

1. 在环境详情页查看注册令牌
2. 在目标服务器下载并启动 Agent

./rex-agent --token <registration-token> --hub-url https://your-hub.com

Agent Docker 部署

docker run -d \
  --name rex-agent \
  -e REX_HUB_URL=https://your-hub.com \
  -e REX_REGISTRATION_TOKEN=<token> \
  jeelin/rex-agent:latest

5. 添加资源

资源是可连接的远程实体，如 SSH 服务器、MySQL 数据库等。

创建步骤

1. 在环境详情页点击「新建资源」
2. 选择协议：SSH / MySQL / PostgreSQL / Redis / S3 等
3. 填写连接信息：
   • 主机地址
   • 端口
   • 用户名
   • 认证方式（密码/密钥）
4. 测试连接：验证配置是否正确
5. 保存

连接方式

• 直连：控制台直接连接目标
• Agent 代理：通过内网 Agent 隧道访问

6. 连接使用

方式一：连接树

1. 进入工作空间
2. 在左侧连接树选择资源
3. 双击打开对应控制台

方式二：Quick Connect

1. 在顶部 Quick Connect 栏
2. 选择协议
3. 输入主机、端口、用户名
4. 点击连接

方式三：资源详情页

1. 在环境详情页
2. 点击资源的「连接」按钮

7. 功能模块

SSH 终端

打开 SSH 资源后进入终端界面：

• 完整终端体验
• 支持 SFTP 文件传输
• 主题定制

SQL 控制台

打开 MySQL/PostgreSQL/SQLite 资源后：

• 导航树浏览库表
• 查询编辑器
• 结果网格
• 表设计器

Redis 控制台

打开 Redis 资源后：

• 键树浏览
• 值查看器
• CLI 命令行
• Server Status

文件管理

打开 SFTP/S3 资源后：

• 双面板文件浏览
• 传输队列
• 拖拽上传下载

8. 个人设置

进入「设置」页面：

• 外观：主题、语言
• 终端：字体、光标、保活
• 安全：会话超时、配置加密
• 更新：检查更新

---

下一步

• 工作空间 — 了解多标签分屏
• SSH 终端 — 终端高级功能
• SQL 控制台 — 数据库管理
• 文件管理 — 文件传输