Cloudpods – 测试

Docs: 登录测试用例

Mon, 01 Jan 0001 00:00:00 +0000

适用范围

覆盖云联壹云 Web 控制台的登录、登录安全策略、退出与会话管理。涉及的产品功能参见：

环境与账号

项目	值
地址	https://test.yunion.io
账号	cloudadmin
密码	cloudadmin@test
域	Default

登录页元素（以实际界面为准）：账号登录/手机号登录页签、用户名输入框、密码输入框、登录按钮、图形验证码（按策略出现）、指定登录域入口、忘记密码、第三方/CAS 登录入口。

用例总览

编号	用例名称	优先级	类型
TC-LOGIN-001	使用正确的用户名和密码登录	P0	正向
TC-LOGIN-002	使用错误的密码登录	P0	反向
TC-LOGIN-003	使用不存在的用户名登录	P1	反向
TC-LOGIN-004	用户名或密码为空提交	P1	校验
TC-LOGIN-005	指定登录域登录	P1	正向
TC-LOGIN-006	域与用户不匹配时登录失败	P2	反向
TC-LOGIN-007	连续输错密码后出现图形验证码	P1	安全
TC-LOGIN-008	连续输错密码超过上限锁定账户并产生安全告警	P1	安全
TC-LOGIN-009	禁用"控制台登录"的用户无法登录	P1	反向
TC-LOGIN-010	被禁用的用户无法登录	P1	反向
TC-LOGIN-011	启用 MFA 的用户登录	P1	正向
TC-LOGIN-012	密码已过期的用户无法登录	P2	反向
TC-LOGIN-013	登录后落地视图正确	P0	正向
TC-LOGIN-014	退出登录后会话失效	P0	正向
TC-LOGIN-015	未登录直接访问内页跳转登录页	P1	安全
TC-LOGIN-016	切换登录界面语言	P2	正向
TC-LOGIN-017	认证源（LDAP）用户登录	P2	正向
TC-LOGIN-018	登录会话有效期	P2	安全

优先级：P0

前置条件：cloudadmin 账号已启用且允许控制台登录。

步骤：

浏览器打开 https://test.yunion.io 。
在"账号登录"页签中输入用户名 cloudadmin。
输入密码 cloudadmin@test。
单击"登录"按钮。

预期结果：

提交后界面提示"正在登录，请稍候"一类的过渡状态。
登录成功，跳转到控制面板页面，右上角显示当前用户。
顶部区域显示视图切换入口，当前视图为管理后台视图。
浏览器中生成登录凭证（yunionauth）及 scope、domain、tenant 等 Cookie。
再次输入地址访问控制台，无需重新登录。

实测结果：通过（接口层已验证，见附录 B）。

优先级：P0

前置条件：同 TC-LOGIN-001。

步骤：

打开登录页。
输入用户名 cloudadmin。
输入错误密码 wrongpass123。
单击"登录"按钮。

预期结果：

登录失败，停留在登录页。
页面提示"用户名或密码错误"（接口返回 incorrect username or password）。
密码输入框被清空或以密文形式保留，不出现明文回显。
未生成有效登录凭证，无法进入控制台。

实测结果：通过。接口返回 HTTP 401，响应体为 {"class":"IncorrectUsernameOrPassword","code":401,"details":"incorrect username or password"}。

优先级：P1

步骤：

打开登录页。
输入用户名 no_such_user_9999。
输入任意密码。
单击"登录"按钮。

预期结果：

登录失败。
提示信息与 TC-LOGIN-002 一致，不区分"用户名不存在"与"密码错误"，避免泄露账号是否存在。

优先级：P1

步骤：

打开登录页，用户名与密码均留空，单击"登录"按钮。
仅填写用户名，密码留空，单击"登录"按钮。
仅填写密码，用户名留空，单击"登录"按钮。

预期结果：

三种情况均不发起登录请求，直接停留在当前页。
对应的输入框下方出现校验提示"请输入用户名"/“请输入密码”。
输入框标红或有明显错误态。

优先级：P1

前置条件：Default 域存在已启用且允许控制台登录的用户。

步骤：

打开登录页，单击"指定登录域"入口。
在域列表中选择 Default。
输入用户名 cloudadmin、密码 cloudadmin@test。
单击"登录"按钮。
在控制台右上角用户菜单中重新打开登录域设置，单击"重置登录域"。

预期结果：

指定登录域后界面显示"当前登录域：Default"。
登录成功，进入控制台。
重置登录域后，登录页恢复为平台级登录，不预选任何域。

优先级：P2

前置条件：存在一个 cloudadmin 未加入的域（如新建域 testdomain）。

步骤：

打开登录页，单击"指定登录域"，选择 cloudadmin 未加入的域。
输入用户名 cloudadmin、密码 cloudadmin@test。
单击"登录"按钮。

预期结果：

登录失败，提示用户名或密码错误。
不发生跨域越权登录。

优先级：P1

前置条件：确认平台已配置密码错误次数阈值（keystone 服务参数 password_error_lock_count，默认 0 表示不锁定）。该用例会占用 cloudadmin 的错误次数，执行前请与管理员确认阈值，避免锁定账号。

步骤：

使用 cloudadmin 与错误密码连续登录，直到界面出现验证码输入框。
记录触发验证码所需的失败次数。
在验证码输入框中输入错误验证码，单击"登录"。
输入正确验证码后提交。

预期结果：

达到阈值后登录页出现图形验证码输入框，且验证码图片可刷新。
验证码错误时提示"请输入有效的验证码"/“验证码错误”，登录被拒绝。
验证码正确且密码正确时登录成功。

备注：若平台未开启验证码策略，本用例标记为"不适用"并记录平台配置值。

优先级：P1

前置条件：password_error_lock_count 已配置为大于 0 的值。

步骤：

使用 cloudadmin 与错误密码连续登录，超过配置的阈值。
尝试使用正确密码登录。
使用管理员账号登录，查看安全告警列表。

预期结果：

超过阈值后账户被锁定，即使输入正确密码也无法登录，提示账户已锁定。
安全告警页面生成一条"异常登录"告警记录。
告警同时发送给被锁定用户本人、其所在域的域管理员和系统管理员。
解除锁定后，使用正确密码可正常登录。

备注：该用例会锁定 cloudadmin 账号，请勿在生产或共享环境执行；执行前确认可解锁。

优先级：P1

前置条件：准备一个已启用但**关闭"登录控制台"**的本地用户。

步骤：

使用管理员在用户管理中新建用户，关闭"登录控制台"。
退出当前登录，使用该用户登录控制台。

预期结果：

登录被拒绝，提示无控制台登录权限或用户名密码错误。
该用户仍可通过 API 等方式访问（如平台允许），但无法登录控制台。

优先级：P1

前置条件：准备一个处于禁用状态的用户，且该用户当前已在线。

步骤：

使用该用户登录控制台并保持在线。
使用管理员在用户管理中禁用该用户。
该用户继续操作控制台页面。
该用户退出后再次登录。

预期结果：

禁用操作不会强制在线用户立即退出。
用户退出后再次登录失败，提示用户已禁用。
使用被禁用用户的正确密码登录同样失败。

优先级：P1

前置条件：全局配置已启用双因子认证，且目标用户已开启 MFA 并完成凭证绑定。

步骤：

使用已开启 MFA 的用户登录，输入正确的用户名和密码。
在出现的登录保护页面中输入 6 位安全码。
使用错误安全码提交一次。
使用正确安全码提交。

预期结果：

密码校验通过后不直接进入控制台，而是要求输入 6 位安全码。
错误安全码提示"安全码不正确，请重新输入"，无法进入控制台。
正确安全码提交后成功进入控制台。

备注：test.yunion.io 上 cloudadmin 当前未开启 MFA（登录凭证中 totp_on=false），执行本用例需先准备一个开启 MFA 的用户；若全局双因子认证未启用，用户侧 MFA 开关不生效。

优先级：P2

前置条件：存在密码已过期的用户。

步骤：

使用密码已过期的用户登录。
使用密码还有 7 天过期的用户登录。

预期结果：

密码已过期的用户无法登录系统。
密码还有 7 天过期的用户可正常登录，登录后提示密码即将过期，建议尽快修改。

优先级：P0

前置条件：cloudadmin 为 Default 域 system 项目的 admin 角色。

步骤：

使用 cloudadmin 登录。
查看顶部区域视图切换入口。
依次切换到域管理后台视图、项目视图，再切回管理后台视图。

预期结果：

默认落地管理后台视图，可看到系统级资源。
视图切换入口正常展示，切换后左侧导航菜单随视图变化。
域管理后台视图要求平台已开启三级权限；未开启时该视图不出现。

优先级：P0

步骤：

登录控制台，记录当前地址。
单击右上角用户图标，选择"退出"。
使用浏览器后退按钮回到退出前的页面。
直接粘贴退出前的内页地址访问。

预期结果：

退出后跳转到登录页。
后退或直接访问内页均被重定向到登录页，不展示业务数据。
浏览器中的登录凭证已失效。

第三方认证源（如 CAS）用户退出后，若认证服务器侧会话未销毁，可能被自动重新登录，属于认证源行为，需单独确认。

优先级：P1

步骤：

清除浏览器 Cookie 或使用无痕窗口。
直接访问内页地址，如 /vminstance 一类的资源列表地址。

预期结果：

请求被拦截，跳转到登录页。
登录成功后跳转回原访问的内页地址（如平台支持回跳）。

优先级：P2

步骤：

打开登录页，将界面语言切换为英文。
切换回简体中文。

预期结果：

登录页文案随语言切换，登录按钮、输入框提示、错误提示均为目标语言。
切换语言不影响已输入的用户名和密码。

优先级：P2

前置条件：平台已配置并启用 LDAP 认证源，且已同步用户。

步骤：

在登录页选择对应的认证源（如"指定登录域"中选择认证源对应的域）。
输入 LDAP 用户的用户名和密码登录。

预期结果：

认证源用户可正常登录控制台。
用户管理中被标记为 LDAP 认证源的用户，不支持在平台侧重置密码。

优先级：P2

步骤：

登录控制台，查看登录凭证 Cookie 的过期时间。
保持页面空闲超过凭证有效期后，再操作页面或访问内页。

预期结果：

登录凭证有效期默认为 24 小时（Max-Age=86399）。
凭证过期后，操作页面或访问内页被重定向到登录页，需重新登录。

实测结果：通过。实测登录响应中 yunionauth、scope、domain、tenant 四个 Cookie 的 Max-Age 均为 86399 秒。

附录 A：接口层验证脚本

登录相关的界面行为可用登录接口快速回归。以下脚本对 https://test.yunion.io 执行接口级验证，可直接复制运行（需要 curl 与 python3）。

#!/bin/bash
# verify_login.sh — 登录接口回归验证
BASE="https://test.yunion.io"
USER="cloudadmin"
PASS="cloudadmin@test"
DOMAIN="Default"

echo "== TC-LOGIN-001 正确凭据登录 =="
code=$(curl -s -o /tmp/login_ok.txt -w "%{http_code}" \
 -c /tmp/login_cookie.txt \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"$USER\",\"password\":\"$PASS\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login")
echo "HTTP $code"
if [ "$code" = "200" ]; then
 echo "PASS: 登录成功"
 grep -q yunionauth /tmp/login_cookie.txt && echo "PASS: 已下发 yunionauth 凭证"
else
 echo "FAIL: 预期 200，实际 $code"
fi

echo
echo "== TC-LOGIN-002 错误密码登录 =="
resp=$(curl -s -w "\n%{http_code}" \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"$USER\",\"password\":\"wrongpass123\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login")
body=$(echo "$resp" | head -n -1)
code=$(echo "$resp" | tail -n 1)
echo "HTTP $code"
echo "$body" | grep -q IncorrectUsernameOrPassword \
 && echo "PASS: 返回 IncorrectUsernameOrPassword" \
 || echo "FAIL: 未返回预期错误类型"

echo
echo "== TC-LOGIN-003 不存在用户登录（提示应与错误密码一致） =="
resp=$(curl -s -w "\n%{http_code}" \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"no_such_user_9999\",\"password\":\"whatever\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login")
body=$(echo "$resp" | head -n -1)
code=$(echo "$resp" | tail -n 1)
echo "HTTP $code"
echo "$body" | grep -q IncorrectUsernameOrPassword \
 && echo "PASS: 与错误密码返回一致，未泄露账号是否存在" \
 || echo "FAIL: 错误类型与错误密码不一致"

echo
echo "== TC-LOGIN-018 会话有效期 =="
exp=$(curl -s -D - -o /dev/null \
 -X POST -H 'Content-Type: application/json' \
 -d "{\"username\":\"$USER\",\"password\":\"$PASS\",\"domain\":\"$DOMAIN\"}" \
 "$BASE/api/v1/auth/login" | grep -i '^set-cookie: yunionauth' | grep -o 'Max-Age=[0-9]*')
echo "yunionauth $exp"
[ "$exp" = "Max-Age=86399" ] && echo "PASS: 有效期为 24 小时" || echo "WARN: 有效期与预期 86399 不同"

登录成功后可用 /tmp/login_cookie.txt 中的凭证调用其他业务接口，例如：

curl -s -b /tmp/login_cookie.txt "$BASE/api/v1/servers?limit=5"

附录 B：本环境实测记录

以下接口行为在 https://test.yunion.io 实测确认（2026-09-15），可作为用例预期结果的基准。

检查项	实测结果
控制台可达性	HTTP 200，HTTP/2，nginx
登录接口	`POST /api/v1/auth/login`，请求体 `{"username","password","domain"}`
正确凭据	HTTP 200，响应体为空，下发 `yunionauth`/`scope`/`domain`/`tenant` Cookie
错误密码	HTTP 401，`{"class":"IncorrectUsernameOrPassword","details":"incorrect username or password"}`
cloudadmin 默认 scope	`system`（管理后台视图）
cloudadmin 默认域	`Default`
cloudadmin MFA 状态	未开启（凭证中 `totp_on=false`、`totp_verified=false`）
登录凭证有效期	86399 秒（24 小时）
图形验证码接口	`GET /api/v1/auth/captcha`，返回 `image/png` 并下发 `captcha` Cookie

说明：以上为接口层实测结论；依赖界面交互的用例（如验证码出现时机、MFA 交互、密码过期提示）仍需按用例步骤在浏览器中执行确认。

Docs: 创建虚拟机测试用例

Mon, 01 Jan 0001 00:00:00 +0000

适用范围

覆盖新建虚拟机的各项参数配置与创建结果验证。参数含义参见新建虚拟机，创建后的操作参见实例操作与详情查看。

操作入口（参见手册"操作入口"一节）：

创建本地IDC虚拟机：虚拟机页面单击列表上方"新建"按钮；
创建私有云虚拟机：单击顶部"私有云"页签，再单击"新建"按钮；
创建公有云虚拟机：单击顶部"公有云"页签，再单击"新建"按钮。

在任意新建虚拟机页面，都可通过顶部"本地IDC"、“私有云”、“公有云"页签切换要创建的平台。

环境核查

执行用例前请先核查本节各项，任一项不满足将导致对应用例无法通过（此时应记为"阻塞"而非"失败”）。

本地IDC

基础资源中存在启用且在线状态的云联壹云平台宿主机，或云管平台已对接 VMware 平台且存在启用状态的 VMware 宿主机；
目标可用区存在属性为"guest"的可用 IP 子网；
系统镜像列表中存在状态为"可用"的公共镜像或自定义镜像。

私有云

云管平台已导入 OpenStack、ZStack、泽塔云或 HCSO 云账号的资源；
基础资源中存在启用状态、属于上述平台的宿主机；
对应平台有可用的 IP 子网。

公有云

云管平台已导入阿里云、AWS、Azure、华为云、腾讯云或 UCloud 云账号；
云账号已启用且状态正常、余额充足；
对应平台区域存在 VPC 和 IP 子网。

核查结果可参考本文档"附录 A：本环境资源实测快照"中的实测数据。

用例总览

编号	用例名称	优先级	平台
TC-VM-001	本地IDC创建Linux虚拟机（最小必填参数）	P0	本地IDC
TC-VM-002	批量创建多台虚拟机并按序号命名	P0	本地IDC
TC-VM-003	使用有序后缀占位符 # 命名	P2	本地IDC
TC-VM-004	使用主机名表达式命名	P2	本地IDC
TC-VM-005	指定IP子网并手动配置静态IP	P1	本地IDC
TC-VM-006	管理员密码随机生成并在列表查看	P0	本地IDC
TC-VM-007	管理员密码关联密钥	P1	本地IDC
TC-VM-008	添加数据盘	P1	本地IDC
TC-VM-009	高级配置绑定弹性公网IP	P2	本地IDC
TC-VM-010	高级配置绑定安全组	P2	本地IDC
TC-VM-011	远程终端协议与显卡型号组合	P2	本地IDC
TC-VM-012	Windows镜像创建并远程连接	P1	本地IDC
TC-VM-013	从ISO启动创建虚拟机	P2	本地IDC
TC-VM-014	自定义数据（cloud-init）	P2	本地IDC
TC-VM-015	ARM架构镜像创建虚拟机	P2	本地IDC
TC-VM-016	ZStack平台创建虚拟机	P1	私有云
TC-VM-017	OpenStack平台创建虚拟机	P1	私有云
TC-VM-018	阿里云按量付费创建虚拟机	P1	公有云
TC-VM-019	公有云包年包月与到期释放	P2	公有云
TC-VM-020	必填项与非法值校验	P0	通用
TC-VM-021	虚拟机名称重复	P1	通用
TC-VM-022	无可用宿主机或IP子网时创建失败	P1	通用
TC-VM-023	创建过程状态流转	P0	通用
TC-VM-024	创建后生命周期操作与删除	P0	通用

TC-VM-001 本地IDC创建Linux虚拟机（最小必填参数）

优先级：P0

前置条件：本地IDC存在在线宿主机与可用 IP 子网，镜像列表中存在可用的 Linux 公共镜像。

步骤：

使用 cloudadmin 登录，进入"资源管理/计算/主机/虚拟机"页面。
单击顶部"本地IDC"页签，单击列表上方"新建"按钮。
基本配置：区域选择默认区域，可用区选择存在在线宿主机的可用区。
设置名称，如 tc-vm-001。
实例配置：数量保持 1，平台选择"云联壹云"。
规格配置：CPU 核数选择 1，内存选择 1G（或选择"不限"后挑选一个最小套餐）。
镜像配置：操作系统选择公共镜像中的 Linux 镜像，如 openEuler-Linux-24.03 LTS SP4-x86_64。
系统盘：磁盘类型选择默认类型，容量不低于镜像的最小磁盘要求。
登录配置：管理员密码选择"随机生成"。
网络配置：网络选择"自动调度"或指定一个可用的 IP 子网。
单击"新建"按钮。

预期结果：

单击"新建"后弹出创建成功提示，页面跳转回虚拟机列表。
列表中出现新建的虚拟机，名称为 tc-vm-001。
虚拟机状态由"创建中"流转为"运行中"。
虚拟机的区域、可用区、镜像、规格与提交的配置一致。

TC-VM-002 批量创建多台虚拟机并按序号命名

优先级：P0

步骤：

按 TC-VM-001 的步骤进入新建页面，名称设置为 tc-batch。
实例配置中数量设置为 3。
其余参数保持与 TC-VM-001 一致，单击"新建"按钮。

预期结果：

创建成功后列表中出现 3 台虚拟机。
第一台名称为 tc-batch，其余为 tc-batch-1、tc-batch-2（名称大于 1 台时，除第一台外其他以 名称-1~N 表示）。
3 台虚拟机均正常流转到"运行中"。
3 台虚拟机分配到的 IP 地址互不冲突。

TC-VM-003 使用有序后缀占位符 # 命名

优先级：P2

步骤：

进入新建页面，名称设置为 tc-host##。
数量设置为 2。
其余参数保持默认，单击"新建"按钮。

预期结果：

创建出的虚拟机名称为 tc-host00 和 tc-host01（一个 # 占一个位置）。
序号按占位符位数补零。

TC-VM-004 使用主机名表达式命名

优先级：P2

步骤：

进入新建页面，名称设置为 ${region}-${zone}。
其余参数保持默认，单击"新建"按钮。
再以 ${host} 为名称创建一个虚拟机。

预期结果：

名称按表达式求值，显示为"区域名-可用区名称"。
变量名需小写，使用 ${host} 时显示为创建该虚拟机的宿主机名称。
表达式中的变量按手册"主机名表达式举例说明"取值，不支持的变量名不生效或被原样输出。

TC-VM-005 指定IP子网并手动配置静态IP

优先级：P1

前置条件：目标可用区存在可用 IP 子网，且子网内有未分配的 IP。

步骤：

进入新建页面，在"网络配置"中选择"指定IP子网"。
选择 VPC 与 IP 子网。
单击"手动配置IP"按钮，填写一个子网网段内、且未被占用的 IP 地址。
单击"确定"保存 IP 配置。
完成其他参数配置后单击"新建"按钮。

预期结果：

“手动配置IP"对话框中填写的 IP 被正确保存并回显。
虚拟机创建成功后，其 IP 地址与手动指定的地址一致。
对同一 IP 重复创建第二台虚拟机时，创建失败或提示 IP 已被占用。

TC-VM-006 管理员密码随机生成并在列表查看

优先级：P0

步骤：

进入新建页面，在"登录配置"中管理员密码选择"随机生成”。
完成其他参数配置后单击"新建"按钮。
创建成功后，在虚拟机列表中找到该虚拟机，查看"密码"列。
复制密码，使用该密码通过 VNC 或远程连接登录虚拟机。

预期结果：

“随机生成"不显示明文密码，创建后可在虚拟机列表的密码列查看并复制管理员密码。
Linux 系统的管理员账号为 root，Windows 系统为 administrator。
使用复制的密码可成功登录虚拟机。

TC-VM-007 管理员密码关联密钥

优先级：P1

前置条件：已存在至少一个密钥对。

步骤：

在"登录配置"中管理员密码选择"关联密钥”。
选择一个已有密钥。
完成其他参数配置后单击"新建"按钮。
创建成功后，使用对应私钥通过 SSH 登录虚拟机。
未创建密钥时，尝试选择"关联密钥"。

预期结果：

关联密钥后，虚拟机需使用私钥远程登录，不使用密码登录。
使用配套私钥可成功登录。
未创建密钥时"关联密钥"不可选或提示需先新建密钥。

TC-VM-008 添加数据盘

优先级：P1

步骤：

在"磁盘配置"的系统盘区域确认磁盘类型与容量。
在"数据盘"区域单击添加，设置磁盘类型、介质与容量。
再添加一块数据盘（可选）。
完成其他参数配置后单击"新建"按钮。
创建成功后，在虚拟机详情页查看磁盘信息。

预期结果：

数据盘为可选项，可添加多块，磁盘类型同系统盘。
仅第一块数据盘支持选择磁盘类型，后续添加的数据盘类型与第一块一致。
创建成功后详情页磁盘列表中包含所有配置的磁盘，容量与配置一致。
数据盘已挂载到虚拟机，但不会自动分区，需登录后手动分区。

TC-VM-009 高级配置绑定弹性公网IP

优先级：P2

前置条件：平台已配置可用的 EIP 线路。

步骤：

展开"高级配置"，在"弹性公网IP"中选择"新建"。
选择线路类型，网络计费方式选择"按带宽计费"，设置带宽（如 1Mbps）。
完成其他参数配置后单击"新建"按钮。
创建成功后，查看虚拟机的 EIP 信息。

预期结果：

EIP 随虚拟机一并创建并绑定成功。
虚拟机详情中可看到绑定的 EIP 及带宽配置。
按带宽计费时，超过带宽的流量将丢包（可通过实际传输验证）。

TC-VM-010 高级配置绑定安全组

优先级：P2

前置条件：存在可用的安全组及其规则。

步骤：

展开"高级配置"，在"安全组"中选择 1 个安全组。
尝试选择超过 5 个安全组。
完成参数配置（不超过上限）后单击"新建"按钮。

预期结果：

可为虚拟机绑定安全组，最多支持 5 个，超过后无法继续选择或有明确提示。
绑定后安全组规则生效，未放行的端口不可访问、已放行的端口可访问。

TC-VM-011 远程终端协议与显卡型号组合

优先级：P2

前置条件：云联壹云平台虚拟机。

步骤：

展开"高级配置"，“远程终端协议"选择 VNC，“显卡型号"依次尝试 Standard 与 QXL。
将"远程终端协议"改为 SPICE，观察"显卡型号"的可选项。
保存创建并打开虚拟机的远程终端。

预期结果：

VNC 协议下显卡型号可选 Standard 和 QXL。
SPICE 协议下显卡型号仅可选 QXL。
远程终端可正常打开并显示虚拟机画面。

备注：VNC 无声音和 usb 传输，不适用于虚拟桌面；SPICE 在色彩、音频和 usb 方面表现较好，适用于虚拟桌面。

TC-VM-012 Windows镜像创建并远程连接

优先级：P1

步骤：

进入新建页面，操作系统选择 Windows 类镜像（如 windows_server_2022_...qcow2）。
系统盘容量不低于镜像的最小磁盘要求。
管理员密码选择"随机生成”。
完成其他参数配置后单击"新建"按钮。
创建成功后，在列表中复制管理员密码，打开远程终端连接。
使用 administrator 账号与复制的密码登录。

预期结果：

虚拟机创建成功并进入"运行中”。
远程终端可正常显示 Windows 登录界面。
使用 administrator 与复制到的密码可成功登录。
若通过挂载 ISO 安装 Windows，安装完成后需另行安装 Virtio 驱动（驱动可在镜像市场-ISO 中获取）。

TC-VM-013 从ISO启动创建虚拟机

优先级：P2

前置条件：镜像列表中存在 ISO 格式的镜像。

步骤：

进入新建页面，操作系统选择"从ISO启动"，选择一个 ISO 镜像。
查看"登录配置"区域。
完成其他参数配置后单击"新建"按钮。
创建成功后打开远程终端，安装操作系统。

预期结果：

选择"从ISO启动"后不支持设置管理员密码，提示需在安装操作系统时设置。
磁盘类型均显示为"数据盘"（显示不影响正常使用）。
远程终端可进入 ISO 引导的安装界面。
仅云联壹云和 VMware 平台支持从 ISO 启动。

TC-VM-014 自定义数据（cloud-init）

优先级：P2

步骤：

展开"高级配置"，在"自定义数据"中以文本方式填入一段 shell 脚本（如创建文件、写入主机名）。
完成参数配置后单击"新建"按钮。
创建成功后登录虚拟机，检查脚本执行结果。
再次以"上传json文件"的方式提交配置。

预期结果：

文本与上传 json 文件两种方式均可提交。
云联壹云平台支持 shell、python、perl 脚本；私有云和公有云平台支持 shell、yaml 脚本。
虚拟机首次启动后脚本被执行，检查结果与脚本预期一致。

TC-VM-015 ARM架构镜像创建虚拟机

优先级：P2

前置条件：存在 ARM 架构的宿主机与 ARM 架构镜像。

步骤：

进入新建页面，“CPU架构"选择 ARM。
查看操作系统镜像列表。
引导方式选择 UEFI，尝试选择 BIOS。
完成参数配置后单击"新建"按钮。

预期结果：

仅云联壹云平台支持 ARM 架构，其他平台该选项不可用。
CPU 架构为 ARM 时，镜像列表按架构过滤，仅展示 ARM 架构镜像。
ARM 架构仅支持 UEFI 引导方式，无法选择 BIOS。

TC-VM-016 ZStack平台创建虚拟机

优先级：P1

前置条件：云管平台已导入 ZStack 资源，且 ZStack 区域存在在线宿主机与可用 IP 子网。

步骤：

进入虚拟机页面，单击顶部"私有云"页签。
单击"新建"按钮，单击顶部"私有云"页签。
选择 ZStack 对应的区域与可用区（区域用于确定虚拟机所属平台）。
设置名称，选择规格与 ZStack 平台镜像。
网络配置中选择可用的 IP 子网。
单击"新建"按钮。

预期结果：

虚拟机在 ZStack 平台上创建成功并进入"运行中”。
列表中该虚拟机显示的所属平台为 ZStack。
可通过远程终端与 SSH 正常访问。

TC-VM-017 OpenStack平台创建虚拟机

优先级：P1

前置条件：云管平台已导入 OpenStack 资源，且区域存在在线宿主机与可用 IP 子网。

步骤：

在"私有云"页签下选择 OpenStack 对应的区域与可用区。
选择镜像作为系统盘（OpenStack 支持以镜像为系统盘，镜像存储为系统盘存储）。
系统盘配置完成后，尝试设置数据盘类型。
完成网络与其他参数配置后单击"新建"按钮。

预期结果：

虚拟机在 OpenStack 平台上创建成功并进入"运行中"。
系统盘以镜像为存储时，数据盘类型可以设置。
虚拟机的区域、平台、规格与提交配置一致。

TC-VM-018 阿里云按量付费创建虚拟机

优先级：P1

前置条件：已导入可用且余额充足的阿里云云账号，对应区域存在 VPC 和 IP 子网。

步骤：

进入虚拟机页面，单击顶部"公有云"页签，再单击"新建"按钮。
计费方式选择"按量付费"。
通过地域、平台、区域、可用区确定可选套餐，选择阿里云及就近区域。
选择一个已有缓存标志的镜像（避免长时间缓存镜像）。
选择 VPC 与 IP 子网，完成其他参数配置。
单击"新建"按钮。

预期结果：

虚拟机在阿里云上创建成功并同步到云管平台，状态为"运行中"。
费用按实际使用量计费。
使用未缓存镜像时创建时间较长，镜像名称右侧带有已缓存标志时创建较快。
公有云仅按量付费的虚拟机支持"到期释放"。

TC-VM-019 公有云包年包月与到期释放

优先级：P2

前置条件：国内公有云云账号。

步骤：

在"公有云"页签下新建虚拟机，计费方式选择"包年包月"。
查看是否可勾选"自动续费"，并设置购买时长。
切换计费方式为"按量付费"，设置"到期释放"为"1小时"。
完成参数配置后单击"新建"按钮。

预期结果：

包年包月为预付费模式，支持勾选自动续费。
仅国内公有云支持包年包月；仅阿里云包年包月支持购买一周，选择一周时平台自动选择阿里云。
阿里云按周购买的续费周期为一周，按月为一个月，按年为一年；其他平台续费周期均为一个月。
到期释放仅按量付费的虚拟机支持，超时后虚拟机被删除并放入回收站。
放入回收站后仍然收费，需在回收站中清除。

TC-VM-020 必填项与非法值校验

优先级：P0

步骤：

进入新建页面，不填写任何内容直接单击"新建"按钮。
依次补齐区域、名称、规格、镜像、网络等必填项，每补齐一项重新提交，观察提示变化。
名称填写非法字符（如空格、/ 等特殊字符）。
系统盘容量填写小于镜像最小磁盘容量的值。
CPU 核数或内存填写超出宿主机剩余资源的规格。

预期结果：

必填项缺失时提交被拦截，对应字段标红并提示"请输入/请选择 xxx"。
所有必填项补齐前无法提交成功。
非法名称被拦截并给出明确提示。
系统盘容量小于镜像最小磁盘要求时不可提交或给出提示。
规格超出可用资源时，该规格不可选或提交后创建失败并给出原因。

TC-VM-021 虚拟机名称重复

优先级：P1

前置条件：已存在一台名为 tc-dup 的虚拟机。

步骤：

新建虚拟机，名称填写为已存在的 tc-dup。
完成其他参数配置后单击"新建"按钮。

预期结果：

创建被拒绝，提示名称已存在。
虚拟机和裸金属共用名称空间，尝试使用已有裸金属的名称创建虚拟机时同样被拒绝。
名称在系统中唯一。

TC-VM-022 无可用宿主机或IP子网时创建失败

优先级：P1

前置条件：准备一个无在线宿主机的可用区，或一个 IP 已耗尽/不可用的子网。

步骤：

新建虚拟机，可用区选择一个没有在线宿主机的可用区。
完成其他参数配置后单击"新建"按钮。
再选择一个宿主机在线、但 IP 子网不满足条件的场景重复提交。

预期结果：

无可用宿主机时创建失败，提示无可用宿主机或调度失败。
无可用 IP 子网时网络配置无法选择子网，或提交后失败并提示原因。
若平台启用了主机申请流程（工单），则在参数校验通过后发起工单申请，审核完成后才自动部署；未启用时直接创建。

TC-VM-023 创建过程状态流转

优先级：P0

步骤：

新建一台虚拟机，单击"新建"后立即观察列表中的状态。
在虚拟机列表右上方查看各状态的数量统计。
持续观察直到状态不再变化。
打开该虚拟机的详情页，核对各项信息。

预期结果：

提交后虚拟机先以"创建中"状态出现在列表中。
创建成功后状态流转为"运行中"；创建失败时为"操作失败"。
列表右上方显示虚拟机总数以及处于运行、关机、操作失败以及未知状态的虚拟机数量，且随状态变化实时更新。
详情页中的名称、区域、可用区、规格、镜像、IP、磁盘等信息与提交配置一致。

TC-VM-024 创建后生命周期操作与删除

优先级：P0

前置条件：已完成 TC-VM-001，存在一台"运行中"的虚拟机。

步骤：

在虚拟机列表中选择该虚拟机，执行"关机"。
确认关机后，执行"开机"。
执行"重启"。
执行"删除"。
删除后，在回收站中查看并执行清除。

预期结果：

关机操作后状态变为"关机"，开机后恢复"运行中"。
重启过程中远程终端连接会中断；若勾选"强制重启"，虚拟机中未保存的数据将会丢失。
删除后虚拟机进入回收站，列表默认不再展示。
回收站中可看到已删除的虚拟机，执行清除后彻底删除。
云上虚拟机放入回收站后仍可能继续收费，不再使用时需及时清除。

附录 A：本环境资源实测快照

以下数据在 https://test.yunion.io 实测获取（2026-09-15），用于用例前置条件核查与参数取值参考。其他环境中资源名称不同，执行时按实际下拉列表替换即可。

本地IDC

项目	实测值
区域	`default`（Beijing OneCloud）
可用区	`Wangjing`、`yunion`、`test`
在线宿主机（云联壹云/KVM）	`test-69-onecloud01`（40C/257923MB）、`test-66-onecloud02`（40C/257755MB）、`ampere-10-127-100-7-10-127-100-7`（32C/65079MB）、`test-d2000-01-10-127-100-8`（8C/15929MB）
在线宿主机（VMware/ESXi）	`10-127-40-2`（48C/131008MB）、`10-127-40-4`（24C/98258MB）
离线宿主机	`esxi2`、`bm15`、`vbm1`、`vbm2`
guest IP子网（示例）	`default-86`（10.206.0.1 ~ 10.206.15.254，网关 10.206.0.1）、`default-85`、`default-84` 等，每个 VPC 下一个

私有云

平台	区域	可用区	在线宿主机	可用 IP 子网
ZStack	`zs-test`	`ZONE-test`、`zone2`	`Host-test`（12C/11824MB）	有（每可用区约 50 个子网）
OpenStack	`ops-test-RegionOne`	`nova`	`test-72-openstack01`（40C/262050MB）	有（约 50 个子网）

可用镜像（示例）

类型	镜像名称	架构	最小磁盘
公共镜像	`openeuler-24.03-lts-sp4-x86_64`	x86_64	40GB
公共镜像	`openEuler-Linux-24.03 LTS SP2-x86_64`	x86_64	40GB
公共镜像	`Kylin-Server-10-SP2-aarch64-Release-Build09-20231122.qcow2`	aarch64	—
其他	`CentOS-Linux-7.9-x86_64-2009`	x86_64	8GB
其他	`Debian-Linux-14 (Forky)-x86_64-latest`	x86_64	3GB
其他	`windows_server_2022_updated_july_2026_x86_64_20260820.qcow2`	x86_64	—
其他	`windows_11_pro_26h1_x86_64_20260816.qcow2`	x86_64	80GB

公共镜像（is_public=true）在下拉列表的"公共镜像"分组中展示；其余图片多为自定义镜像或主机镜像，按实际分组选择。

已有虚拟机

环境中已存在 qj-ubuntu-tmp、qj-test-w22、test-rocky、glb-test-4.0.4 等虚拟机，执行名称唯一性相关用例时注意避开这些名称。

附录 B：接口层验证

创建过程的资源状态可通过接口快速核对。先执行 verify_login.sh 取得登录凭证（见登录测试用例附录 A），然后：

BASE="https://test.yunion.io"
COOKIE=/tmp/login_cookie.txt

# 查看虚拟机列表与状态
curl -s -b $COOKIE "$BASE/api/v1/servers?limit=20" \
 | python3 -c "import sys,json;[print(s['name'],s['status'],s.get('hypervisor')) for s in json.load(sys.stdin)['data']]"

# 查看在线宿主机（创建前置条件核查）
curl -s -b $COOKIE "$BASE/api/v1/hosts?limit=50" \
 | python3 -c "import sys,json;[print(h['name'],h['host_type'],h['host_status']) for h in json.load(sys.stdin)['data']]"

# 查看可用 IP 子网（创建前置条件核查）
curl -s -b $COOKIE "$BASE/api/v1/networks?server_type=guest&limit=20" \
 | python3 -c "import sys,json;[print(n['name'],n['guest_ip_start'],n['guest_ip_end']) for n in json.load(sys.stdin)['data']]"

# 查看镜像列表
curl -s -b $COOKIE "$BASE/api/v1/images?limit=20" \
 | python3 -c "import sys,json;[print(i['name'],i.get('os_arch'),i.get('disk_format')) for i in json.load(sys.stdin)['data']]"

接口中的 status 取值与界面状态的对应关系：running = 运行中、ready = 关机、start_fail/create_fail = 操作失败。接口层仅用于快速核查环境与状态，界面交互、参数校验提示、工单流程等仍需按用例步骤在浏览器中执行。

Docs: 测试用例

Mon, 01 Jan 0001 00:00:00 +0000

本目录维护云联壹云 Web 控制台核心功能的测试用例，用于功能验证与版本回归。用例依据 Web控制台手册的功能描述编写，步骤与参数含义与手册保持一致。

测试环境

测试用例默认在以下环境执行，如在其他环境执行，请先按下文"环境差异"一节调整用例中的参数。

项目	值
控制台地址	https://test.yunion.io
管理员账号	cloudadmin
管理员密码	cloudadmin@test
默认域	Default
默认视图	管理后台视图（cloudadmin 为 Default 域 system 项目的 admin）
本地IDC区域	Default（Beijing OneCloud）
本地IDC可用区	test、yunion、Wangjing

用例编号规则

用例编号格式为 TC-<模块>-<序号>：

TC-LOGIN-xxx：登录与退出相关用例，参见登录。
TC-VM-xxx：创建虚拟机相关用例，参见创建虚拟机。

优先级说明：

优先级	含义
P0	冒烟用例，每次版本发布必测
P1	主要功能用例，版本回归必测
P2	边界与组合场景，按需执行

通用约定

前置条件

执行任何用例前，需满足：

浏览器可访问控制台地址，且能正常加载登录页；
使用 cloudadmin 账号可正常登录；
本地IDC区域存在在线状态的宿主机（否则创建虚拟机的用例无法通过）；
本地IDC区域存在可用的 IP 子网（否则网络配置无法选择）。

第 3、4 项的核查方法参见创建虚拟机的"环境核查"一节。

结果记录

每条用例执行后，在"实测结果"中记录：

结论：通过 / 失败 / 阻塞；
实际现象：与预期不一致时，记录界面提示原文；
截图或接口响应：失败用例必附；
执行人、执行时间、被测版本号。

环境差异

用例中的资源名称（镜像名、IP 子网名、宿主机名）取自 test.yunion.io 的实测快照，其他环境中这些名称大概率不同，执行时请按实际下拉列表中的可选项替换，不影响用例的判定标准。

用例目录

登录：登录、登录安全、退出与会话，共 18 条用例。
创建虚拟机：本地IDC、私有云、公有云创建虚拟机及各参数组合，共 24 条用例。

Cloudpods – 测试

Docs: 登录测试用例

适用范围

环境与账号

用例总览

TC-LOGIN-001 使用正确的用户名和密码登录

TC-LOGIN-002 使用错误的密码登录

TC-LOGIN-003 使用不存在的用户名登录

TC-LOGIN-004 用户名或密码为空提交

TC-LOGIN-005 指定登录域登录

TC-LOGIN-006 域与用户不匹配时登录失败

TC-LOGIN-007 连续输错密码后出现图形验证码

TC-LOGIN-008 连续输错密码超过上限锁定账户并产生安全告警

TC-LOGIN-009 禁用"控制台登录"的用户无法登录

TC-LOGIN-010 被禁用的用户无法登录

TC-LOGIN-011 启用 MFA 的用户登录

TC-LOGIN-012 密码已过期的用户无法登录

TC-LOGIN-013 登录后落地视图正确

TC-LOGIN-014 退出登录后会话失效

TC-LOGIN-015 未登录直接访问内页跳转登录页

TC-LOGIN-016 切换登录界面语言

TC-LOGIN-017 认证源（LDAP）用户登录

TC-LOGIN-018 登录会话有效期

附录 A：接口层验证脚本

附录 B：本环境实测记录

Docs: 创建虚拟机测试用例

适用范围

环境核查

本地IDC

私有云

公有云

用例总览

TC-VM-001 本地IDC创建Linux虚拟机（最小必填参数）

TC-VM-002 批量创建多台虚拟机并按序号命名

TC-VM-003 使用有序后缀占位符 # 命名

TC-VM-004 使用主机名表达式命名

TC-VM-005 指定IP子网并手动配置静态IP

TC-VM-006 管理员密码随机生成并在列表查看

TC-VM-007 管理员密码关联密钥

TC-VM-008 添加数据盘

TC-VM-009 高级配置绑定弹性公网IP

TC-VM-010 高级配置绑定安全组

TC-VM-011 远程终端协议与显卡型号组合

TC-VM-012 Windows镜像创建并远程连接

TC-VM-013 从ISO启动创建虚拟机

TC-VM-014 自定义数据（cloud-init）

TC-VM-015 ARM架构镜像创建虚拟机

TC-VM-016 ZStack平台创建虚拟机

TC-VM-017 OpenStack平台创建虚拟机

TC-VM-018 阿里云按量付费创建虚拟机

TC-VM-019 公有云包年包月与到期释放

TC-VM-020 必填项与非法值校验

TC-VM-021 虚拟机名称重复

TC-VM-022 无可用宿主机或IP子网时创建失败

TC-VM-023 创建过程状态流转

TC-VM-024 创建后生命周期操作与删除

附录 A：本环境资源实测快照

本地IDC

私有云

可用镜像（示例）

已有虚拟机

附录 B：接口层验证

Docs: 测试用例

测试环境

用例编号规则

通用约定

前置条件

结果记录

环境差异

用例目录