615 lines
15 KiB
Markdown
615 lines
15 KiB
Markdown
# YAMA 代理商运营手册
|
||
|
||
> 下级授权管理与 FRP 代理配置
|
||
|
||
---
|
||
|
||
## 目标读者
|
||
|
||
- 有下级客户需要管理的代理商
|
||
- 需要为下级生成授权
|
||
- 需要提供 FRP 代理服务
|
||
|
||
> 基础功能请参阅[日常使用手册](UserManual.md)
|
||
|
||
---
|
||
|
||
## 第一部分：代理商角色
|
||
|
||
### 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 指导下级获取序列号
|
||
|
||
指导下级完成以下步骤：
|
||
1. 下载并运行 YAMA.exe（首次运行会提示未授权，属正常现象）
|
||
2. 点击菜单 **其他** → **申请授权**
|
||
3. 首次会显示使用条款，确认本软件仅限合法正当使用
|
||
4. 点击"确认"后显示序列号并复制
|
||
|
||
> **提示**：导入授权后，该菜单会变为 **其他** → **序列号**
|
||
|
||
**序列号格式：** `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 分配方式
|
||
|
||
**自动分配（推荐）：**
|
||
1. 勾选"FRP 代理"选项
|
||
2. 系统自动从可用端口池分配
|
||
3. 无需手动指定端口号
|
||
|
||
**手动指定：**
|
||
1. 勾选"FRP 代理"选项
|
||
2. 取消"自动分配"
|
||
3. 输入指定端口号
|
||
|
||
**注意**：手动指定需确保端口在您配置的范围内且未被占用。
|
||
|
||
#### 9.3 记录分配信息
|
||
|
||
建议维护一份分配记录表：
|
||
|
||
| 下级 | 序列号 | 端口 | 并发数 | 有效期 | 备注 |
|
||
|------|-------|------|--------|--------|------|
|
||
| 张三 | b40f-... | 20001 | 100 | 2026-12-31 | 华东区 |
|
||
| 李四 | a12c-... | 20002 | 50 | 2026-06-30 | 试用 |
|
||
|
||
### 10. 生成授权
|
||
|
||
1. 确认所有信息无误
|
||
2. 点击"生成"按钮
|
||
3. 授权信息保存到本地数据库
|
||
|
||
### 11. 发送给下级
|
||
|
||
有两种方式将授权发送给下级：
|
||
|
||
#### 方式 A：在线发送（推荐）
|
||
|
||
如果下级使用您通过 **工具** → **主控生成** 分发的程序：
|
||
|
||
1. 下级程序已硬编码您的地址，启动后会自动连接到您
|
||
2. 您在主机列表中可以看到已连接但未授权的下级
|
||
3. 右键点击该主机 → **发送授权**
|
||
4. 选择已生成的授权记录
|
||
5. 通知下级重启程序
|
||
|
||
**下级重启流程（如授权包含 FRP）：**
|
||
- 第一次重启：验证授权，提示"授权成功"，同时收到 FRP 配置
|
||
- 第二次重启：应用 FRP 配置，开始使用 FRP 代理
|
||
|
||
**优点：** 无需传输文件，操作简便，适合大量下级管理
|
||
|
||
#### 方式 B：离线发送（lic 文件）
|
||
|
||
如果下级无法先连接到您（如网络原因）：
|
||
|
||
1. 在授权生成界面点击"导出"按钮
|
||
2. 生成 `*.lic` 文件（建议命名：`客户名_日期.lic`）
|
||
3. 通过微信/QQ/邮件发送给下级
|
||
4. 附带导入说明：
|
||
|
||
```
|
||
请按以下步骤导入授权：
|
||
1. 运行 YAMA.exe
|
||
2. 点击菜单"工具" → "导入口令..."
|
||
3. 选择 *.lic 文件
|
||
4. 重启程序使授权生效
|
||
|
||
如有问题请联系我。
|
||
```
|
||
|
||
---
|
||
|
||
## 第四部分：FRP 代理服务
|
||
|
||
> 为没有公网服务器的下级提供代理服务
|
||
|
||
### 12. FRP 工作原理
|
||
|
||
当下级没有公网服务器时，可以通过您的 FRP 服务实现连接：
|
||
|
||
```
|
||
下级的受管端
|
||
│
|
||
│ 连接
|
||
↓
|
||
您的 FRP 服务器（公网）
|
||
│
|
||
│ 转发
|
||
↓
|
||
下级的 YAMA 程序
|
||
```
|
||
|
||
**数据流向：**
|
||
1. 受管端连接您的服务器的指定端口（如 20001）
|
||
2. FRP 服务将流量转发给下级的 YAMA
|
||
3. 下级 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 服务器：
|
||
1. 取消勾选"FRPS 运行在本机"
|
||
2. 填写 FRPS 服务器地址
|
||
3. 填写 FRPS 端口
|
||
4. 填写认证 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 防火墙
|
||
|
||
1. 打开"Windows Defender 防火墙"
|
||
2. 点击"高级设置"
|
||
3. 选择"入站规则" → "新建规则"
|
||
4. 选择"端口" → "TCP"
|
||
5. 输入端口：`7000, 20000-29999`
|
||
6. 选择"允许连接"
|
||
7. 完成
|
||
|
||
#### 14.2 云服务器安全组
|
||
|
||
以阿里云/腾讯云为例：
|
||
|
||
1. 登录云控制台
|
||
2. 找到安全组配置
|
||
3. 添加入站规则：
|
||
- 协议：TCP
|
||
- 端口：7000
|
||
- 端口：20000-29999
|
||
4. 保存配置
|
||
|
||
### 15. 验证 FRP 服务
|
||
|
||
#### 15.1 检查运行状态
|
||
|
||
如果选择"本地运行 FRPS"：
|
||
- 状态栏应显示 FRP 服务状态
|
||
- 可查看日志文件 `Bin/frps.log`
|
||
|
||
#### 15.2 测试下级连接
|
||
|
||
1. 为测试下级生成授权（包含 FRP）
|
||
2. 下级导入授权
|
||
3. 确认下级状态栏显示 FRP 连接成功
|
||
4. 下级生成受管程序并测试
|
||
|
||
---
|
||
|
||
## 第五部分：授权管理
|
||
|
||
### 16. 查看已发放授权
|
||
|
||
点击菜单 **工具** → **授权管理**
|
||
|
||
授权列表显示以下信息：
|
||
|
||
| 列名 | 说明 |
|
||
|------|------|
|
||
| 序列号 | 下级设备序列号 |
|
||
| 备注 | 自定义说明 |
|
||
| 有效期 | 起始日期 - 结束日期 |
|
||
| 并发数 | 分配的并发上限 |
|
||
| FRP 端口 | 分配的 FRP 端口（如有） |
|
||
| 状态 | 有效/过期/禁用 |
|
||
|
||
**筛选功能：**
|
||
- 按状态筛选：有效/过期/全部
|
||
- 按关键词搜索：序列号、备注
|
||
|
||
### 17. 授权续期
|
||
|
||
当下级授权即将过期时：
|
||
|
||
1. 在授权列表中找到目标授权
|
||
2. 双击或点击"编辑"
|
||
3. 修改结束日期
|
||
4. 保存更改
|
||
|
||
**下级更新授权：**
|
||
- 下级重启程序即可自动获取新的有效期（通过网络验证）
|
||
- 通常**无需重新发送 lic 文件**
|
||
|
||
> **注意**：只有当下级的序列号（SN）发生变化时，才需要重新生成并发送授权文件。
|
||
|
||
### 18. 授权撤销
|
||
|
||
#### 18.1 何时需要撤销
|
||
|
||
- 下级未按时付费
|
||
- 下级违反使用协议
|
||
- 下级主动要求取消
|
||
|
||
#### 18.2 撤销方式
|
||
|
||
**方式一：禁用授权**
|
||
1. 在授权列表选中目标
|
||
2. 点击"禁用"
|
||
3. 下级下次验证时授权失效
|
||
|
||
**方式二：删除授权**
|
||
1. 在授权列表选中目标
|
||
2. 点击"删除"
|
||
3. 授权记录从数据库移除
|
||
|
||
#### 18.3 撤销后的影响
|
||
|
||
- 下级程序在下次联网验证时失效
|
||
- 已连接的受管端保持连接直到断开
|
||
- 下级无法生成新的受管程序
|
||
|
||
### 19. 端口回收
|
||
|
||
当下级不再使用 FRP 时：
|
||
|
||
1. 记录下级占用的端口号
|
||
2. 撤销或删除该下级授权
|
||
3. 端口自动回到可用池
|
||
4. 可分配给新下级使用
|
||
|
||
---
|
||
|
||
## 第六部分：日常运维
|
||
|
||
### 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 数据库 |
|
||
|
||
**备份频率：** 每周或每次重要操作后
|
||
|
||
**注册表导出方法：**
|
||
1. 运行 `regedit`
|
||
2. 导航到 `HKEY_CURRENT_USER\Software\YAMA`
|
||
3. 右键 → 导出 → 保存为 .reg 文件
|
||
|
||
#### 22.2 恢复方法
|
||
|
||
1. 停止 YAMA 程序
|
||
2. 双击 .reg 文件导入注册表配置
|
||
3. 将 `licenses.db` 复制到 `%APPDATA%\YAMA\`
|
||
4. 重新启动程序
|
||
5. 验证数据恢复正确
|
||
|
||
---
|
||
|
||
## 第七部分：进阶功能
|
||
|
||
### 23. 下级成为代理商
|
||
|
||
如果您的授权支持，您的下级也可以发展自己的下级：
|
||
|
||
```
|
||
您（一级代理）
|
||
│
|
||
└── 下级 A（二级代理）
|
||
│
|
||
├── A 的下级 1
|
||
└── A 的下级 2
|
||
```
|
||
|
||
**前提条件：**
|
||
- 您的授权支持多级
|
||
- 为下级开通代理权限
|
||
|
||
### 24. 批量管理
|
||
|
||
#### 24.1 批量生成
|
||
|
||
如需为多个下级生成授权：
|
||
1. 收集所有序列号
|
||
2. 逐个生成授权
|
||
3. 批量导出文件
|
||
4. 分别发送
|
||
|
||
#### 24.2 批量续期
|
||
|
||
对于到期的授权：
|
||
1. 筛选即将过期的授权
|
||
2. 逐个编辑延长有效期
|
||
3. 通知下级重启程序以更新授权
|
||
|
||
> 续期无需重新发送 lic 文件，下级重启即可通过网络获取新的有效期。
|
||
|
||
### 25. 数据统计
|
||
|
||
建议自行记录统计以下数据：
|
||
|
||
| 统计项 | 用途 |
|
||
|--------|------|
|
||
| 下级数量 | 业务规模 |
|
||
| 端口使用率 | 资源规划 |
|
||
| 到期预警 | 续费提醒 |
|
||
| 收入记录 | 财务管理 |
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### A. 定价建议参考
|
||
|
||
定价时可考虑以下因素：
|
||
|
||
| 因素 | 说明 |
|
||
|------|------|
|
||
| 并发数档位 | 10/50/100/500/不限 |
|
||
| 有效期 | 月/季/半年/年 |
|
||
| FRP 服务 | 是否包含、带宽限制 |
|
||
| 技术支持 | 基础/高级/VIP |
|
||
|
||
### B. 常用话术模板
|
||
|
||
**获取序列号：**
|
||
```
|
||
请运行 YAMA.exe，点击菜单"其他" → "申请授权"。
|
||
首次需确认使用条款，之后即可查看序列号。
|
||
将序列号发送给我即可。
|
||
```
|
||
|
||
**发送授权文件：**
|
||
```
|
||
附件是您的授权文件，请按以下步骤导入：
|
||
1. 运行 YAMA.exe
|
||
2. 点击菜单"工具" → "导入口令..."
|
||
3. 选择附件中的 *.lic 文件
|
||
4. 关闭并重启程序
|
||
5. 检查状态栏确认授权生效
|
||
|
||
如有问题随时联系我。
|
||
```
|
||
|
||
**续期通知：**
|
||
```
|
||
您的 YAMA 授权将于 [日期] 到期。
|
||
如需续期，请在到期前联系我。
|
||
续期后重启程序即可自动更新，无需重新导入文件。
|
||
```
|
||
|
||
### C. 技术支持
|
||
|
||
如遇到本手册未涵盖的问题：
|
||
|
||
| 渠道 | 联系方式 |
|
||
|------|---------|
|
||
| QQ | 962914132 |
|
||
| Telegram | [@doge_grandfather](https://t.me/doge_grandfather) |
|
||
|
||
---
|
||
|
||
## 相关文档
|
||
|
||
- [快速部署指南](QuickStart.md) - 首次部署
|
||
- [多级网络搭建指南](NetworkSetup.md) - 网络架构详解
|
||
- [日常使用手册](UserManual.md) - 远程管理功能
|
||
- [定制化开发指南](CustomizationGuide.md) - 二次开发（技术型客户）
|