YAMA 快速部署指南

April 7, 2026 · View on GitHub

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
    ├── 导入授权（工具 → 导入口令）
    ├── 重启程序
    └── 验证授权状态

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

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

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

下一步

需求推荐文档
搭建多级网络（管理下级）多级网络搭建指南
了解所有远程功能日常使用手册
为下级分配授权代理商运营手册
定制化开发定制化开发指南

常见问题速查

授权相关

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

连接相关

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

远程桌面相关

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

技术支持

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

渠道联系方式
QQ962914132
Telegram@doge_grandfather

相关文档