15 KiB
YAMA 代理商运营手册
下级授权管理与 FRP 代理配置
目标读者
- 有下级客户需要管理的代理商
- 需要为下级生成授权
- 需要提供 FRP 代理服务
基础功能请参阅日常使用手册
第一部分:代理商角色
1. 您的角色定位
作为代理商,您在授权链中扮演中间角色:
您的上级(为您提供授权)
│
↓
您(代理商)
│
↓
您的下级(您为他们提供授权和服务)
您的职责:
- 管理您的下级客户
- 为下级生成和分发授权
- 可选:为下级提供 FRP 代理服务
- 提供技术支持和售后服务
2. 权限范围
您为下级授权时,受以下限制:
| 限制项 | 规则 |
|---|---|
| 有效期 | 不超过您自己的有效期 |
| 并发数限制 | 不超过上级为您设置的并发数限制 |
| 功能权限 | 不超过您被授予的权限 |
示例:
- 您的有效期到 2026-12-31
- 您可以为下级设置最长到 2026-12-31 的有效期
- 上级为您设置的并发数限制是 500
- 您为下级设置的并发数限制不能超过 500
3. 收益模式参考
常见的代理商收益模式:
| 模式 | 说明 |
|---|---|
| 按授权收费 | 每个授权收取一次性费用 |
| 按并发数收费 | 根据分配的并发数定价 |
| 按服务期限收费 | 月付/季付/年付不同价格 |
| FRP 增值服务 | 为无服务器的下级提供 FRP 代理 |
| 技术支持服务 | 提供部署、运维支持 |
第二部分:下级管理流程
4. 发展下级的标准流程
步骤 1:下级联系您,表达需求
↓
步骤 2:下级下载并运行 YAMA.exe
↓
步骤 3:下级发送序列号给您
↓
步骤 4:您评估需求,生成授权
↓
步骤 5:您将 *.lic 文件发送给下级
↓
步骤 6:下级导入授权,开始使用
5. 获取下级序列号
5.1 指导下级获取序列号
指导下级完成以下步骤:
- 下载并运行 YAMA.exe(首次运行会提示未授权,属正常现象)
- 点击菜单 其他 → 申请授权
- 首次会显示使用条款,确认本软件仅限合法正当使用
- 点击"确认"后显示序列号并复制
提示:导入授权后,该菜单会变为 其他 → 序列号
序列号格式: XXXX-XXXX-XXXX-XXXX(16 位十六进制,分 4 组)
5.2 序列号传递建议
| 方式 | 建议 |
|---|---|
| 微信/QQ | 直接复制文本发送 |
| 邮件 | 主题注明"YAMA序列号" |
| 截图 | 确保序列号完整清晰 |
重要:序列号是生成授权的必要信息,请下级准确提供。
6. 评估下级需求
在生成授权前,了解下级的需求:
| 问题 | 影响 |
|---|---|
| 预计受管端数量 | 决定分配的并发数 |
| 计划使用期限 | 决定授权有效期 |
| 有无公网服务器 | 决定是否需要分配 FRP |
第三部分:生成授权
7. 打开授权生成界面
点击菜单 工具 → 口令生成
8. 填写授权信息
8.1 基本信息
| 字段 | 说明 | 示例 |
|---|---|---|
| 序列号 | 下级提供的设备序列号 | b40f-638f-ebc8-6d54 |
| 备注 | 便于识别的说明 | "张三-华东区代理" |
备注建议格式: 客户名-地区/用途
8.2 有效期设置
| 字段 | 说明 |
|---|---|
| 起始日期 | 授权生效日期(可以是今天或将来某天) |
| 结束日期 | 授权过期日期(不超过您的有效期) |
常见期限类型:
| 类型 | 期限 | 适用场景 |
|---|---|---|
| 试用期 | 7-15 天 | 新客户体验 |
| 月付 | 1 个月 | 短期需求 |
| 季付 | 3 个月 | 一般客户 |
| 半年付 | 6 个月 | 稳定客户 |
| 年付 | 12 个月 | 长期合作 |
8.3 并发数设置
设置下级可同时管理的受管端数量上限。
规划建议:
- 小型客户:10-50
- 中型客户:50-200
- 大型客户:200+
- 预留 10-20% 余量应对增长
9. 分配 FRP 端口
9.1 何时需要分配 FRP
在以下情况为下级分配 FRP:
- 下级没有公网服务器
- 下级希望简化网络配置
- 下级网络环境复杂
9.2 分配方式
自动分配(推荐):
- 勾选"FRP 代理"选项
- 系统自动从可用端口池分配
- 无需手动指定端口号
手动指定:
- 勾选"FRP 代理"选项
- 取消"自动分配"
- 输入指定端口号
注意:手动指定需确保端口在您配置的范围内且未被占用。
9.3 记录分配信息
建议维护一份分配记录表:
| 下级 | 序列号 | 端口 | 并发数 | 有效期 | 备注 |
|---|---|---|---|---|---|
| 张三 | b40f-... | 20001 | 100 | 2026-12-31 | 华东区 |
| 李四 | a12c-... | 20002 | 50 | 2026-06-30 | 试用 |
10. 生成授权
- 确认所有信息无误
- 点击"生成"按钮
- 授权信息保存到本地数据库
11. 发送给下级
有两种方式将授权发送给下级:
方式 A:在线发送(推荐)
如果下级使用您通过 工具 → 主控生成 分发的程序:
- 下级程序已硬编码您的地址,启动后会自动连接到您
- 您在主机列表中可以看到已连接但未授权的下级
- 右键点击该主机 → 发送授权
- 选择已生成的授权记录
- 通知下级重启程序
下级重启流程(如授权包含 FRP):
- 第一次重启:验证授权,提示"授权成功",同时收到 FRP 配置
- 第二次重启:应用 FRP 配置,开始使用 FRP 代理
优点: 无需传输文件,操作简便,适合大量下级管理
方式 B:离线发送(lic 文件)
如果下级无法先连接到您(如网络原因):
- 在授权生成界面点击"导出"按钮
- 生成
*.lic文件(建议命名:客户名_日期.lic) - 通过微信/QQ/邮件发送给下级
- 附带导入说明:
请按以下步骤导入授权:
1. 运行 YAMA.exe
2. 点击菜单"工具" → "导入口令..."
3. 选择 *.lic 文件
4. 重启程序使授权生效
如有问题请联系我。
第四部分:FRP 代理服务
为没有公网服务器的下级提供代理服务
12. FRP 工作原理
当下级没有公网服务器时,可以通过您的 FRP 服务实现连接:
下级的受管端
│
│ 连接
↓
您的 FRP 服务器(公网)
│
│ 转发
↓
下级的 YAMA 程序
数据流向:
- 受管端连接您的服务器的指定端口(如 20001)
- FRP 服务将流量转发给下级的 YAMA
- 下级 YAMA 通过 FRP 客户端接收数据
13. 配置 FRP 服务
13.1 系统要求
| 要求 | 说明 |
|---|---|
| 操作系统 | Windows 10 / Server 2016 或更高版本 |
| 架构 | 必须是 64 位系统 |
| 网络 | 服务器具有公网 IP |
注意:32 位系统或 Windows 7/Server 2012 等旧系统不支持 FRP 功能。
13.2 打开配置界面
点击菜单 扩展 → 下级FRP代理设置
13.3 启用服务
勾选 "启用为下级提供 FRP 代理"
13.4 选择 FRPS 模式
方式 A:本地运行 FRPS(推荐)
勾选"FRPS 运行在本机"
| 优点 | 说明 |
|---|---|
| 简单 | 程序自动管理 FRPS |
| 集成 | 无需额外部署 |
| 便捷 | 配置自动生效 |
方式 B:使用外部 FRPS
如果您已有独立的 FRPS 服务器:
- 取消勾选"FRPS 运行在本机"
- 填写 FRPS 服务器地址
- 填写 FRPS 端口
- 填写认证 Token(需与 FRPS 配置一致)
13.5 设置端口和密钥
| 设置项 | 说明 | 建议值 |
|---|---|---|
| FRPS 端口 | FRPS 服务监听端口 | 7000 |
| 认证 Token | 安全密钥 | 使用复杂随机字符串 |
Token 建议: 使用 16 位以上包含字母数字的随机字符串。
13.6 设置分配范围
| 设置项 | 说明 | 建议值 |
|---|---|---|
| 起始端口 | 分配给下级的最小端口 | 20000 |
| 结束端口 | 分配给下级的最大端口 | 29999 |
容量计算: 端口范围 20000-29999 可容纳 10000 个下级。
14. 开放防火墙
FRP 服务需要开放以下端口:
| 端口 | 用途 |
|---|---|
| 7000(FRPS 端口) | FRP 服务监听 |
| 20000-29999(分配范围) | 下级映射端口 |
14.1 Windows 防火墙
- 打开"Windows Defender 防火墙"
- 点击"高级设置"
- 选择"入站规则" → "新建规则"
- 选择"端口" → "TCP"
- 输入端口:
7000, 20000-29999 - 选择"允许连接"
- 完成
14.2 云服务器安全组
以阿里云/腾讯云为例:
- 登录云控制台
- 找到安全组配置
- 添加入站规则:
- 协议:TCP
- 端口:7000
- 端口:20000-29999
- 保存配置
15. 验证 FRP 服务
15.1 检查运行状态
如果选择"本地运行 FRPS":
- 状态栏应显示 FRP 服务状态
- 可查看日志文件
Bin/frps.log
15.2 测试下级连接
- 为测试下级生成授权(包含 FRP)
- 下级导入授权
- 确认下级状态栏显示 FRP 连接成功
- 下级生成受管程序并测试
第五部分:授权管理
16. 查看已发放授权
点击菜单 工具 → 授权管理
授权列表显示以下信息:
| 列名 | 说明 |
|---|---|
| 序列号 | 下级设备序列号 |
| 备注 | 自定义说明 |
| 有效期 | 起始日期 - 结束日期 |
| 并发数 | 分配的并发上限 |
| FRP 端口 | 分配的 FRP 端口(如有) |
| 状态 | 有效/过期/禁用 |
筛选功能:
- 按状态筛选:有效/过期/全部
- 按关键词搜索:序列号、备注
17. 授权续期
当下级授权即将过期时:
- 在授权列表中找到目标授权
- 双击或点击"编辑"
- 修改结束日期
- 保存更改
下级更新授权:
- 下级重启程序即可自动获取新的有效期(通过网络验证)
- 通常无需重新发送 lic 文件
注意:只有当下级的序列号(SN)发生变化时,才需要重新生成并发送授权文件。
18. 授权撤销
18.1 何时需要撤销
- 下级未按时付费
- 下级违反使用协议
- 下级主动要求取消
18.2 撤销方式
方式一:禁用授权
- 在授权列表选中目标
- 点击"禁用"
- 下级下次验证时授权失效
方式二:删除授权
- 在授权列表选中目标
- 点击"删除"
- 授权记录从数据库移除
18.3 撤销后的影响
- 下级程序在下次联网验证时失效
- 已连接的受管端保持连接直到断开
- 下级无法生成新的受管程序
19. 端口回收
当下级不再使用 FRP 时:
- 记录下级占用的端口号
- 撤销或删除该下级授权
- 端口自动回到可用池
- 可分配给新下级使用
第六部分:日常运维
20. 监控下级状态
20.1 定期检查
建议定期检查:
- 下级授权到期情况
- FRP 端口使用率
- 异常连接情况
20.2 日志查看
FRP 相关日志位置:
Bin/frps.log- FRPS 服务日志- 包含下级连接/断开记录
21. 常见问题处理
| 下级反馈 | 可能原因 | 处理方法 |
|---|---|---|
| 无法导入授权 | 序列号不匹配 | 确认序列号,重新生成 |
| 授权显示无效 | 有效期问题 | 检查日期设置 |
| FRP 连接失败 | 防火墙/网络 | 检查端口开放 |
| 授权已过期 | 到期未续费 | 续期后下级重启程序即可 |
| 并发数超限 | 超过分配限制 | 升级授权或释放连接 |
| 受管端连不上 | 地址端口错误 | 检查下级设置 |
22. 备份与恢复
22.1 定期备份
建议备份以下数据:
| 数据 | 位置 | 说明 |
|---|---|---|
| 配置信息 | 注册表 HKCU\Software\YAMA |
可导出为 .reg 文件 |
| 授权数据库 | %APPDATA%\YAMA\licenses.db |
SQLite 数据库 |
备份频率: 每周或每次重要操作后
注册表导出方法:
- 运行
regedit - 导航到
HKEY_CURRENT_USER\Software\YAMA - 右键 → 导出 → 保存为 .reg 文件
22.2 恢复方法
- 停止 YAMA 程序
- 双击 .reg 文件导入注册表配置
- 将
licenses.db复制到%APPDATA%\YAMA\ - 重新启动程序
- 验证数据恢复正确
第七部分:进阶功能
23. 下级成为代理商
如果您的授权支持,您的下级也可以发展自己的下级:
您(一级代理)
│
└── 下级 A(二级代理)
│
├── A 的下级 1
└── A 的下级 2
前提条件:
- 您的授权支持多级
- 为下级开通代理权限
24. 批量管理
24.1 批量生成
如需为多个下级生成授权:
- 收集所有序列号
- 逐个生成授权
- 批量导出文件
- 分别发送
24.2 批量续期
对于到期的授权:
- 筛选即将过期的授权
- 逐个编辑延长有效期
- 通知下级重启程序以更新授权
续期无需重新发送 lic 文件,下级重启即可通过网络获取新的有效期。
25. 数据统计
建议自行记录统计以下数据:
| 统计项 | 用途 |
|---|---|
| 下级数量 | 业务规模 |
| 端口使用率 | 资源规划 |
| 到期预警 | 续费提醒 |
| 收入记录 | 财务管理 |
附录
A. 定价建议参考
定价时可考虑以下因素:
| 因素 | 说明 |
|---|---|
| 并发数档位 | 10/50/100/500/不限 |
| 有效期 | 月/季/半年/年 |
| FRP 服务 | 是否包含、带宽限制 |
| 技术支持 | 基础/高级/VIP |
B. 常用话术模板
获取序列号:
请运行 YAMA.exe,点击菜单"其他" → "申请授权"。
首次需确认使用条款,之后即可查看序列号。
将序列号发送给我即可。
发送授权文件:
附件是您的授权文件,请按以下步骤导入:
1. 运行 YAMA.exe
2. 点击菜单"工具" → "导入口令..."
3. 选择附件中的 *.lic 文件
4. 关闭并重启程序
5. 检查状态栏确认授权生效
如有问题随时联系我。
续期通知:
您的 YAMA 授权将于 [日期] 到期。
如需续期,请在到期前联系我。
续期后重启程序即可自动更新,无需重新导入文件。
C. 技术支持
如遇到本手册未涵盖的问题:
| 渠道 | 联系方式 |
|---|---|
| 962914132 | |
| Telegram | @doge_grandfather |