328 lines
9.9 KiB
Markdown
328 lines
9.9 KiB
Markdown
# 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) - 二次开发与品牌定制
|