# 首次使用

## 1. 访问控制台

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

```text
http://localhost:8080
```

## 2. 设置密码

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

密码要求：
- 最少 8 位
- 建议包含大小写字母和数字

## 3. 创建环境

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

### 创建步骤

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

### 典型分组

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

## 4. 部署 Agent（可选）

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

### Agent 注册

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

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

### Agent Docker 部署

```bash
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. 个人设置

进入「设置」页面：
- **外观**：主题、语言
- **终端**：字体、光标、保活
- **安全**：会话超时、配置加密
- **更新**：检查更新

---

## 下一步

- [工作空间](./workspace.md) — 了解多标签分屏
- [SSH 终端](./terminal.md) — 终端高级功能
- [SQL 控制台](./sql-console.md) — 数据库管理
- [文件管理](./file-manager.md) — 文件传输