# YAMA 快速部署指南

> 10 分钟完成首次部署

---

## 目标读者

- 已有公网服务器的客户
- 首次使用 YAMA
- 希望快速验证功能

---

## 开始之前

### 您需要准备

| 项目 | 说明 |
|------|------|
| 公网服务器 | Windows 服务器，能从外网访问 |
| 服务器公网 IP | 受管端将连接此地址 |
| 授权文件 | `*.lic` 文件，由您的上级提供 |
| YAMA.exe | 主控程序，从上级或官方渠道获取 |

### 系统要求

| 场景 | 操作系统要求 |
|------|-------------|
| 使用 FRP 代理 | Windows 10 / Server 2016 或更高版本（64位） |
| 不使用 FRP（自有公网服务器） | Windows 7 / Server 2008 R2 或更高版本 |
| 受管端（被控电脑） | Windows 7 或更高版本 |

> **提示**：如果您的授权文件包含 FRP 配置，说明您将使用 FRP 代理，请确保使用 64 位的 Windows 10 或更高版本。

---

## 第一步：部署主控端（3 分钟）

### 1.1 上传程序

将 `YAMA.exe` 上传到您的服务器，建议放置到独立目录：

```
C:\YAMA\
└── YAMA.exe
```

程序运行后会自动创建以下数据：
- **配置信息** - 存储在注册表 `HKCU\Software\YAMA`
- **数据文件** - 存储在 `%APPDATA%\YAMA\` 目录（如 `licenses.db` 授权数据库）
- **语言文件** - 程序同目录下的 `lang\` 文件夹（可选）

### 1.2 首次运行

双击运行 `YAMA.exe`，首次运行时程序会提示**未授权**状态，部分功能不可用。

> 如果您使用的是上级分发的程序，程序会自动连接到上级，您可以直接等待上级在线发送授权，跳过以下序列号获取步骤。

**获取序列号（离线授权方式）：**
1. 点击菜单 **其他** → **申请授权**
2. 首次会显示使用条款，确认本软件仅限合法正当使用
3. 点击"确认"后显示序列号（格式：`XXXX-XXXX-XXXX-XXXX`）
4. 复制序列号发送给上级以获取授权

> **提示**：导入授权后，该菜单会变为 **其他** → **序列号**

### 1.3 获取授权

根据您上级的分发方式，有两种获取授权的方式：

**方式 A：在线接收（如使用上级分发的程序）**
1. 运行上级分发给您的程序，自动连接到上级
2. 等待上级通过在线方式发送授权
3. 收到授权后重启程序，提示"授权成功"
4. 如授权包含 FRP 配置，需再次重启以应用 FRP

**方式 B：离线导入（如收到 lic 文件）**
1. 点击菜单栏 **工具** → **导入口令...**
2. 选择您的 `*.lic` 授权文件
3. 看到"导入成功"提示后，**关闭并重新启动程序**
4. 如授权包含 FRP 配置，需再次重启以应用 FRP

### 1.4 验证授权状态

重启后，检查窗口底部的状态栏：

| 状态栏位置 | 显示内容 |
|-----------|---------|
| 左侧 | 当前分组主机数 / 总主机数 |
| 中间 | FRP 连接地址（如授权包含 FRP 配置） |
| 右侧 | 运行信息和授权信息（有效期、并发数） |

如果状态栏右侧显示授权有效期信息，说明授权已生效。

---

## 第二步：配置网络（2 分钟）

### 2.1 检查地址设置

1. 点击菜单栏 **菜单** → **设置**
2. 查看"公网地址"栏位

**地址设置说明：**

| 情况 | 地址显示 | 说明 |
|------|---------|------|
| 使用 FRP 代理 | FRP 服务器地址（自动填入） | 受管端将连接 FRP 服务器 |
| 自有公网服务器 | 您服务器的公网 IP | 受管端直连您的服务器 |

> **提示**：如果您的授权包含 FRP 配置，地址和端口会自动从授权文件中读取，通常无需手动修改。

### 2.2 确认监听端口

默认监听端口为 `6543`。如需修改，请在设置页面更改。

### 2.3 开放防火墙

**Windows 防火墙：**

1. 打开"Windows Defender 防火墙"
2. 点击"高级设置"
3. 选择"入站规则" → "新建规则"
4. 选择"端口" → "TCP" → 输入端口号（如 `6543`）
5. 选择"允许连接" → 完成

**云服务器安全组（阿里云/腾讯云等）：**

1. 登录云控制台
2. 找到安全组设置
3. 添加入站规则：协议 TCP，端口 `6543`（或您设置的端口）

> **注意**：如果使用 FRP 代理，受管端连接的是 FRP 服务器而非您的服务器，此时您的服务器防火墙无需开放监听端口。

---

## 第三步：生成受管程序（2 分钟）

### 3.1 打开生成对话框

点击菜单栏 **工具** → **主控生成**

### 3.2 确认连接参数

生成对话框会自动填入地址和端口：

| 参数 | 来源 |
|------|------|
| IP 地址 | 自动从 FRP 配置或设置中读取 |
| 端口 | 自动从 FRP 配置或设置中读取 |

> **重要**：请确认这些参数正确。受管端将使用这些参数连接主控。

### 3.3 选择载荷类型

| 类型 | 适用场景 | 推荐度 |
|------|---------|-------|
| ghost.exe | 独立运行程序，便于测试 | **新手推荐** |
| TestRun - Windows 服务 | 开机自启，稳定运行 | **生产环境推荐** |
| TestRun - 内存DLL | 内存运行，隐蔽性更好 | 进阶 |
| ghost.exe - Windows 服务 | 开机自启，独立程序 | 备选 |

**首次使用建议选择 "ghost.exe"**，便于测试和排查问题。

**生产环境建议选择 "TestRun - Windows 服务"**，支持开机自启且运行稳定。

### 3.4 生成文件

1. 确认参数无误后，点击"确定"
2. 选择保存位置
3. 记录生成的文件路径

生成完成后，在指定位置会看到受管程序文件。

---

## 第四步：部署受管端（3 分钟）

### 4.1 传输文件

将生成的受管程序文件复制到目标电脑。传输方式可以是：
- U 盘拷贝
- 网络共享
- 远程桌面拖拽
- 其他文件传输方式

### 4.2 运行受管程序

在目标电脑上双击运行受管程序。

**运行后的预期行为：**
- TestRun / ghost.exe：拷贝自身到目标目录 → 创建开机启动项 → 自我删除原文件 → 后台运行
- 服务类型：需要管理员权限，会注册为 Windows 服务并自动启动

### 4.3 验证连接

回到主控端，查看主机列表：

- 等待几秒钟后，主机列表中出现新主机即表示部署成功

**如果受管端未上线，请检查：**

| 可能原因 | 解决方案 |
|---------|---------|
| 网络不通 | 检查目标电脑能否访问主控地址和端口 |
| 防火墙拦截 | 确认主控端口已开放 |
| IP/端口错误 | 重新生成受管程序，确认参数正确 |
| FRP 未启动 | 检查 FRP 服务状态 |
| 文件被占用 | 目标电脑已部署过旧版本，新文件无法覆盖。用任务管理器结束占用进程后重新部署（重启无效，旧版本会自动运行） |

---

## 第五步：测试远程功能

### 5.1 远程桌面

1. 在主机列表中**右键单击**在线主机，选择"远程桌面"（或点击工具栏图标）
2. 将打开远程桌面窗口
3. 测试鼠标移动和点击
4. 测试键盘输入

**画质调整**：点击窗口左上角系统菜单图标，选择"屏幕质量"调整画面质量。

### 5.2 文件管理

1. 选中在线主机，点击**工具栏**的文件管理图标
2. 双栏界面：上方本地、下方远程
3. 测试文件上传和下载

### 5.3 远程终端

1. 选中在线主机，点击**工具栏**的远程终端图标
2. 输入命令测试（如 `dir`、`ipconfig`）

---

## 部署完成

恭喜！您已成功完成 YAMA 的首次部署。

### 快速回顾

```
主控端部署
    │
    ├── 上传 YAMA.exe
    ├── 导入授权（工具 → 导入口令）
    ├── 重启程序
    └── 验证授权状态

网络配置
    │
    ├── 检查地址设置（菜单 → 设置）
    └── 开放防火墙端口

生成受管程序
    │
    ├── 打开生成（工具 → 主控生成）
    ├── 确认参数
    └── 选择类型并生成

部署受管端
    │
    ├── 传输文件到目标电脑
    ├── 运行程序
    └── 验证上线
```

### 下一步

| 需求 | 推荐文档 |
|------|---------|
| 搭建多级网络（管理下级） | [多级网络搭建指南](NetworkSetup.md) |
| 了解所有远程功能 | [日常使用手册](UserManual.md) |
| 为下级分配授权 | [代理商运营手册](AgentManual.md) |
| 定制化开发 | [定制化开发指南](CustomizationGuide.md) |

---

## 常见问题速查

### 授权相关

| 问题 | 可能原因 | 解决方案 |
|------|---------|---------|
| 导入授权后无变化 | 未重启程序 | 关闭程序后重新启动 |
| 授权文件无法导入 | 文件损坏或格式错误 | 联系上级重新获取授权文件 |
| 授权显示已过期 | 有效期已到 | 联系上级续期 |

### 连接相关

| 问题 | 可能原因 | 解决方案 |
|------|---------|---------|
| 受管端无法上线 | 防火墙阻止 | 检查并开放对应端口 |
| 受管端无法上线 | 地址或端口错误 | 重新生成受管程序，确认参数 |
| FRP 连接失败 | 网络问题 | 检查网络，确认能访问 FRP 服务器 |
| FRP 连接失败 | 授权不包含 FRP | 联系上级获取包含 FRP 的授权 |
| 连接不稳定 | 网络波动 | 检查网络质量 |

### 远程桌面相关

| 问题 | 可能原因 | 解决方案 |
|------|---------|---------|
| 画面卡顿 | 带宽不足 | 降低画质（系统菜单 → 屏幕质量） |
| 画面黑屏 | 受管端问题 | 重启受管端程序 |
| 无法控制 | 权限问题 | 确认受管端以管理员运行 |

---

## 技术支持

如遇到无法解决的问题，请通过以下渠道联系技术支持：

| 渠道 | 联系方式 |
|------|---------|
| QQ | 962914132 |
| Telegram | [@doge_grandfather](https://t.me/doge_grandfather) |

---

## 相关文档

- [多级网络搭建指南](NetworkSetup.md) - 构建总控 → 二级 → 受管端的网络
- [日常使用手册](UserManual.md) - 远程管理功能详解
- [代理商运营手册](AgentManual.md) - 下级授权管理与 FRP 代理配置
- [定制化开发指南](CustomizationGuide.md) - 二次开发与品牌定制