8.6 KiB
8.6 KiB
DDNS 双模式功能测试指南
🎯 测试目标
验证 DDNS 双模式架构的前端实现是否正确,包括:
- Tab 4 重命名为"增强"
- DDNS 表单支持两种模式切换
- 增强页服务卡片显示正确
- 表单验证逻辑区分模式
📋 前置准备
1. 启动服务
cd e:\Project\MeshRay
.\meshray.exe
2. 访问页面
- URL: http://localhost:9531
- 默认账号:admin / admin123
3. 打开浏览器开发者工具(F12)
- Console 标签 - 查看是否有 JavaScript 错误
- Network 标签 - 查看 API 请求
✅ 测试用例
测试 1:验证 Tab 名称修改
步骤:
- 登录系统
- 点击左侧菜单"服务管理"
- 查看顶部的 Tab 标签
预期结果:
- ✅ Tab 1: "TUN" 🔌
- ✅ Tab 2: "TURN" 🔗
- ✅ Tab 3: "DDNS" 🌐
- ✅ Tab 4: "增强" 🚀 ← 重点验证
截图位置:
[在此处粘贴 Tab 栏截图]
测试 2:验证 Tab 3 "DDNS"说明文案
步骤:
- 点击 Tab 3 "DDNS"
- 查看顶部的信息卡片
预期结果:
- ✅ 标题:DDNS 配置(基础设施)
- ✅ 描述:配置 DNS 服务商对接信息,用于组网同步、内网穿透等场景
- ✅ 列表项:
- 支持阿里云、腾讯云、Cloudflare
- 配置后可在组网创建时直接选用
- 也可在「增强」页创建完整的 DDNS 服务
实际结果:
[记录实际显示的文案]
测试 3:测试 DDNS 基础设施配置模式
步骤:
- 在 Tab 3 点击"添加 DDNS"按钮
- 查看弹出的对话框
预期结果:
- ✅ 对话框标题:"添加 DDNS"
- ✅ 表单包含"配置模式"单选框
- ✅ 默认选中"🏗️ 基础设施配置"
- ✅ 选择基础设施模式后,显示:
- DNS 服务商下拉框
- 根域名输入框
- 根据服务商显示不同的认证字段(Cloudflare API Token、阿里云 AccessKey 等)
验证表单字段:
| 字段 | 是否显示 | 备注 |
|---|---|---|
| 服务名称 | ✅ | 通用字段 |
| 服务类型 | ✅ | 固定为 DDNS |
| 配置模式 | ✅ | 单选框 |
| DNS 服务商 | ✅ | 基础设施模式特有 |
| 根域名 | ✅ | 基础设施模式特有 |
| API Token/AccessKey | ✅ | 根据服务商显示 |
| 主机记录 | ❌ | 全功能模式才有 |
| 目标 IP | ❌ | 全功能模式才有 |
截图位置:
[在此处粘贴表单截图]
测试 4:测试 DDNS 全功能服务模式
步骤:
- 在 DDNS 添加对话框中
- 切换配置模式为"🚀 全功能 DDNS 服务"
预期结果:
- ✅ 显示"选择 DDNS 配置"下拉框(从已配置的 DDNS 服务中选择)
- ✅ 显示"记录类型"下拉框(A/AAAA/TXT/CNAME)
- ✅ 选择 A/AAAA 记录时,显示:
- 主机记录输入框
- 目标 IP 输入框
- 检测端口输入框
- ✅ 选择 TXT 记录时,显示:
- TXT 记录名称输入框
- TXT 记录值输入框
- ✅ 选择 CNAME 记录时,显示:
- 目标域名输入框
- ✅ TTL 设置下拉框
验证表单字段:
| 字段 | 是否显示 | 备注 |
|---|---|---|
| 选择 DDNS 配置 | ✅ | 级联选择 |
| 记录类型 | ✅ | A/AAAA/TXT/CNAME |
| 主机记录 | ✅ | A/AAAA 模式显示 |
| 目标 IP | ✅ | A/AAAA 模式显示 |
| 检测端口 | ✅ | A/AAAA 模式显示 |
| TXT 记录名称 | ✅ | TXT 模式显示 |
| TXT 记录值 | ✅ | TXT 模式显示 |
| 目标域名 | ✅ | CNAME 模式显示 |
| TTL | ✅ | 通用 |
测试不同记录类型的切换:
- 选择 A 记录 → 验证显示主机记录、IPv4 目标 IP
- 选择 AAAA 记录 → 验证显示主机记录、IPv6 目标 IP
- 选择 TXT 记录 → 验证显示 TXT 记录名称和值
- 选择 CNAME 记录 → 验证显示目标域名
截图位置:
[在此处粘贴全功能模式表单截图]
测试 5:验证表单验证规则
测试场景 A:基础设施模式
- 切换到基础设施模式
- 不填写任何字段,点击提交
预期验证错误:
- ✅ "请输入服务名称"
- ✅ "请选择 DNS 服务商"
- ✅ "请输入域名"
测试场景 B:全功能模式 - A 记录
- 切换到全功能模式
- 选择 A 记录类型
- 不填写字段,点击提交
预期验证错误:
- ✅ "请输入服务名称"
- ✅ "请选择 DDNS 配置"
- ✅ "请选择记录类型"
- ✅ "请输入主机记录"
- ✅ "请输入目标 IP"
- ✅ "请输入检测端口"
测试场景 C:全功能模式 - TXT 记录
- 切换到全功能模式
- 选择 TXT 记录类型
- 填写 TXT 记录名称为"test_invalid!@#"
预期验证错误:
- ✅ "只能包含字母、数字、点、下划线和连字符"
记录实际测试结果:
[记录每个场景的实际验证结果]
测试 6:验证增强页服务卡片
步骤:
- 切换到 Tab 4 "增强"
- 查看页面内容
预期结果:
-
✅ 顶部信息卡片:
- 标题:"增强服务"
- 图标:🚀
- 描述:基于已配置的基础设施,创建完整的业务服务
- 列表项:DDNS 内网穿透、自定义服务
-
✅ 服务卡片网格显示:
- 卡片 1: "DDNS 内网穿透" 🌐
- 描述:基于 DDNS 配置创建 A/AAAA 记录,实现内网穿透
- 标签:内网穿透、DDNS
- 卡片 2: "自定义服务" 🔧
- 描述:未来扩展更多能力
- 标签:自定义、灵活配置
- 卡片 1: "DDNS 内网穿透" 🌐
-
✅ 鼠标悬停效果:
- 卡片上浮(translateY)
- 边框变蓝色
- 阴影加深
- "立即创建"按钮变蓝
截图位置:
[在此处粘贴增强页截图]
测试 7:测试点击增强服务卡片
步骤:
- 点击"DDNS 内网穿透"卡片
- 观察弹出的对话框
预期结果:
- ✅ 对话框标题:"添加 DDNS"
- ✅ 服务名称自动填充:"DDNS 内网穿透"
- ✅ 服务类型:DDNS
- ✅ 配置模式:全功能 DDNS 服务(默认选中)
- ✅ 记录类型:A(默认)
- ✅ 其他字段为空,等待用户填写
点击"自定义服务"卡片:
- ✅ 对话框标题:"添加 TURN"或"添加 STUN"(取决于服务类型)
- ✅ 配置模式:基础设施配置(默认)
记录实际结果:
[记录点击卡片的实际行为]
测试 8:检查浏览器控制台
步骤:
- 按 F12 打开开发者工具
- 切换到 Console 标签
- 执行上述所有测试操作
- 查看是否有红色错误信息
预期结果:
- ✅ 无 JavaScript 运行时错误
- ✅ 无 Vue 警告
- ✅ 无组件未定义错误
如果看到错误,记录详细信息:
错误信息:
发生时的操作:
堆栈跟踪:
测试 9:检查 Network 请求
步骤:
- 开发者工具 → Network 标签
- 清空之前的请求记录
- 点击"添加 DDNS" → 提交表单
- 查看发送的 API 请求
预期结果:
- ✅ 请求 URL:
/api/v1/services - ✅ 请求方法:POST
- ✅ 请求体包含正确的字段结构:
{
"name": "测试 DDNS",
"type": "DDNS",
"config_mode": "infrastructure",
"provider": "cloudflare",
"domain": "example.com",
"api_token": "***",
"enabled": true,
"timeout": 10
}
对于全功能模式:
{
"name": "NAS 内网穿透",
"type": "DDNS",
"config_mode": "fullservice",
"ddns_config_id": "xxx-xxx-xxx",
"record_type": "AAAA",
"subdomain": "nas",
"target_ip": "::ffff:192.168.1.100",
"port": 80,
"ttl": 600
}
记录实际请求:
[粘贴请求详情]
🐛 问题记录表
如果在测试中发现任何问题,请在此记录:
| 编号 | 问题描述 | 复现步骤 | 严重程度 | 截图 |
|---|---|---|---|---|
| 1 | 高/中/低 | |||
| 2 | 高/中/低 |
📊 测试总结
通过的测试项
- Tab 名称修改
- Tab 3 文案更新
- 基础设施配置模式
- 全功能服务模式
- 表单验证规则
- 增强页服务卡片
- 点击卡片行为
- 无控制台错误
- API 请求正确
整体评价
[对 DDNS 双模式功能的主观评价]
例如:
- UI 设计清晰直观
- 两种模式切换流畅
- 表单验证逻辑完善
- 用户体验良好
改进建议
[提出任何改进建议]
例如:
1. 可以添加更多预设的 DDNS 服务商
2. 全功能模式下可以提供快速配置向导
3. ...
🎯 下一步行动
根据测试结果:
- 如果所有测试通过 → 开始后端集成开发
- 如果有问题 → 修复后重新测试
- 如果有优化建议 → 评估后决定是否实施
测试日期:2026-03-20
测试人员:_____________
测试状态:⏳ 进行中 / ✅ 已完成 / ❌ 阻塞