用户与规格（套餐）管理

本节面向运营管理人员（admin 角色），讲解如何在系统里管理"客户账号"以及"卖给客户的服务器配置套餐"。涉及的菜单全部位于左侧导航的 用户管理（userManagement） 之下，包括：用户列表、用户分组、规格管理（套餐）、用户 API，以及通过右上角头像进入的"当前用户"页。

名词速读

• 用户（user）：这里指的是你的客户账号，也就是租用机房服务器、IP 等资源的人。注意它和"管理员（admin）"不是一回事——管理员是运营你这套系统的内部人员，在《设置》里另行管理。本节只讲客户账号。
• 用户分组（usergroup / 用户组）：把客户按"类别"归类的标签，比如"普通客户""VIP 客户""测试账号"。
• 规格 / 套餐（Package）：你打算卖给客户的一种"服务器配置组合 + 资源额度"的模板，类似手机套餐——规定了 CPU、内存、硬盘、IP 数量、带宽这些"含什么"。把套餐分配给客户后，系统会按套餐条件挑出符合要求的服务器交付给客户。
• 用户 API 凭证：发给客户、让客户用程序（而不是网页）对接系统的"机器人钥匙"，由 KEY 和 secret 两段字符串组成。
• 双因素验证（2FA / 两步验证）：登录或执行敏感操作时，除了密码，还要再输入一个手机 App 生成的 6 位动态验证码，相当于给账户加了第二把锁。

---

一、用户列表（用户管理 > 用户列表）

进入 用户管理 > 用户列表，即可看到全部客户账号的表格。这是客户账号管理的主入口。

1.1 列表显示的字段

列名	含义说明
用户名	客户的登录账号，唯一、不可重复。点击用户名可进入该用户的详情页。
昵称	客户的显示名称，可随意填写，便于辨认。
用户组	该客户所属的分组名称（见第三节）。
状态	账号当前状态，可在此列直接下拉切换：启用 / 封号 / 禁用（含义见下表）。
邮箱	客户的电子邮箱，用于接收通知、生成头像等。
电话号码	自动拼接为"国际区号 + 号码"，如 +86 138...。
最后登陆时间	该账号上一次成功登录系统的时间。
操作	提供"修改（铅笔图标）""删除（垃圾桶图标）"两个图标按钮。

账号状态的三种取值：

状态	系统值	含义
启用	Active	正常账号，可登录、可使用资源。
封号	Banned	被封禁的账号，通常用于违规客户。
禁用	Disabled	停用的账号，例如客户暂停服务。

提示：在"状态"列直接选择新状态后，会弹出"确定要修改状态为 XX"的二次确认，确认后立即生效，无需进入编辑弹窗。该操作需要"编辑用户"权限。

1.2 筛选与排序

列表顶部有筛选条，可按用户名、昵称、用户组、状态、邮箱、电话号码、最后登陆时间等条件查询。其中"用户组""状态"以下拉方式选择，"用户组"支持输入关键字远程搜索。表格各列支持点击表头排序。

1.3 新增用户

1. 点击列表右上角的 添 加 按钮，弹出"添加 用户"对话框。
2. 按下表填写字段（带 * 的为必填）。
3. 点击 立即添加 完成创建（成功后右上角弹出"添加 用户成功"提示）。

字段	是否必填	说明与校验规则
用户名	必填	只允许字母、数字、下划线、连字符（a-z A-Z 0-9 _ -）。系统范围内唯一，重复会被拒绝；创建后不可修改。
昵称	必填	客户显示名称。
设置密码	必填	右侧有"眼睛"图标可切换明文显示；旁边的"魔棒"图标可一键随机生成强密码。若系统启用了密码强度策略，过于简单的密码会被拒绝（提示"密码太简单"）。
确认密码	必填	必须与上面的密码完全一致，否则提示"两次密码输入不一样"。
邮箱	必填	需符合邮箱格式，否则提示"请输入正确的邮箱格式"。
电话号码	选填	左侧选国际区号（默认 +86），右侧填号码。号码须符合手机号格式，否则提示"请输入正确的手机号"。
分组	必填	从下拉中选择一个用户组，决定该客户归属哪一类。
Telegram ID	选填	用于把该客户与其 Telegram 会话绑定，便于通过 Telegram 机器人推送通知。字段旁有提示图标说明："此字段为绑定用户 Tg 的会话 id，可通过 Dcim Tg Bot 获取"。

说明：若新增时未选择分组，系统会自动归入第一个"非管理员"用户组。

1.4 编辑用户

• 在列表"操作"列点击 修改（铅笔图标） 打开编辑弹窗，或点击用户名进入详情页编辑。
• 编辑弹窗中用户名为灰色不可改；其余字段（昵称、邮箱、电话、分组、Telegram ID、密码）均可修改。
• 若要改密码，必须同时填写"修改密码"和"确认密码"两栏，否则系统会提示需要确认密码。
• 只有真正发生改变的字段才会被提交，修改记录会写入操作审计日志。

1.5 删除用户

• 单个删除：在"操作"列点击 删除（垃圾桶图标）。
• 批量删除：先勾选多行，再点击列表底部的 删除 按钮。
• 两种方式都会弹出"确认删除 N 个用户 ?"的提示。

警告：删除用户是联动操作。该客户名下绑定的服务器关联会被解除，其占用的 IP 子网会被释放（user_id 归还到公共池）、相关 IP 地址状态会被重置为"空闲（Idle）"。请务必在客户确认退租后再删除。

安全提示：删除用户属于敏感操作。若系统在《设置》中开启了"敏感操作二次验证"，执行删除前需要先输入双因素动态口令（详见第七节）。

---

二、用户详情页

在用户列表点击某个用户名，进入该客户的详情页。页面以标签页（Tab）形式组织，包含以下标签：

📷 （界面截图待补充：用户详情页，展示顶部标签页（用户信息/通知设置/服务器信息/子网信息/IP信息）与用户信息表单）

标签页	内容
用户信息	头像、基本资料、密码、状态、语言，以及"两步验证（双因素）"的绑定/解绑。
通知设置	配置该客户能收到哪些类型的通知，以及通过 Web / 邮件 / 短信 哪种渠道接收（见 2.3）。
服务器信息	该客户名下当前持有的服务器列表。
子网信息	该客户名下持有的 IP 子网（一段连续 IP 地址的集合，详见《IDC 术语速查表》）。
IP 信息	该客户名下具体的 IP 地址明细。

2.1 用户信息面板的可操作项

• 头像：可点击"点击上传"上传 jpg / png / jpeg / gif 图片（提示限制为 jpg/png、不超过 500KB）；也可前往 gravatar.com 上传——系统会按客户邮箱自动显示对应的 Gravatar 头像（一个根据邮箱自动生成网络头像的公共服务）。
• 主要设置：可修改昵称、邮箱、手机号、状态、语言，点击 更新设置 保存，重置 可放弃修改。语言可选：English（en-US）、中文（zh-CN）、繁體（zh-TW）、한국어（ko-KR）。
• 修改密码：同样需要"修改密码 + 确认密码"两栏一致；右侧同样有"眼睛"显隐与"魔棒"随机生成密码图标。

2.2 两步验证（双因素验证）

页面下方有"两步验证"区域，用于给客户账号开启第二把锁：

• 若该账号未绑定，会显示一个二维码。客户用谷歌身份验证器（Google Authenticator）等 App 扫描二维码后，会得到一个不断变化的 6 位验证码，将其填入"请输入验证码"框，点击 绑定 即可开启。绑定后"双因素"状态显示"已绑定"。
• 若已绑定，点击 解绑，在弹出的"确定解绑二步验证?"确认框中确认后即可关闭。

安全建议：页面用红字强调——开启双因素验证后，即使黑客通过攻破客户电子邮箱获得了账户访问权，没有动态口令也无法拿走资产。因此系统强烈建议开启双因素验证并使用谷歌动态口令。

📷 （界面截图待补充：用户详情页底部的两步验证区域，展示二维码与绑定/解绑操作）

2.3 通知设置标签页

该标签页用于决定"这个客户在发生哪些事件时、通过哪种渠道收到通知"。页面是一张可勾选的表格：

• 事件按类别分组展开：服务器、交换机、被控（accused，指被纳管监控的设备）、系统。每个类别下列出具体的通知事项。
• 每条通知事项有三个勾选框，对应三种通知渠道：Web 通知（站内消息）、邮件通知、短信通知。
• 每个渠道的表头也带一个总开关，可一键全选 / 取消该渠道下所有事项。
• 调整完成后点击右上角 保存（提示"修改成功"）；点击 重置 可放弃改动、恢复为已保存的设置。

📷 （界面截图待补充：用户详情页的通知设置标签，展示服务器/交换机/被控/系统分组与Web/邮件/短信三列勾选框）

---

三、用户分组（用户管理 > 用户分组）

进入 用户管理 > 用户分组，管理客户的分类标签。该页是一个简单的表格，支持就地（在表格行内）编辑。

3.1 列表字段

列名	含义
启用	一个开关。打开（绿色）表示该分组启用；关闭（红色）表示禁用。切换时会弹出"确定修改为 启用/禁用 状态 ?"确认。
名称	分组名称。
操作	"修改""删除"两个文字按钮（编辑状态下"修改"变为"提交"）。

3.2 常见操作

• 新增分组：点击右上角 添 加，表格末尾会出现一行可编辑的输入框，填写名称后点击该行的 提交（或按回车）即可保存；点击 取消 放弃。
• 重命名：点击该行的 修改，名称变为可编辑输入框，改完点 提交。
• 启用 / 禁用：直接拨动"启用"列的开关，确认后生效。
• 删除：点击行内 删除（单个，确认提示"确认删除用户分组 ?"），或勾选多行后点击列表底部的 删除（批量，确认提示"确认删除 N 个用户分组 ?"）。

提示：分组名称不能为空，提交空名称会报"名称不能为空"。

安全提示：删除用户分组同样属于敏感操作，开启"敏感操作二次验证"后需先输入双因素动态口令。

---

四、规格 / 套餐管理（用户管理 > 规格管理）

4.1 什么是"规格 / 套餐"

规格（Package，菜单中称"规格管理"）就是你打算卖给客户的一套服务器"配置模板"。可以把它理解为手机套餐：套餐里写明了"几核 CPU、多少内存、多大硬盘、几个 IP、多少带宽"。

它的用途有两层：

1. 对客户：定义了一种可售卖的产品配置。
2. 对系统：当你把某个套餐"分配"给客户时，系统会用套餐里的硬件条件，去机房里自动筛选符合条件、且尚未出租的服务器，再交付给客户。

进入 用户管理 > 规格管理 查看所有套餐。

4.2 列表字段

列名	含义
规格名称	套餐名称（点击可进入套餐详情页）。
CPU	CPU 型号，后面带 x 数量（如 Intel Xeon x 2 表示 2 颗）。
内存大小(G)	内存容量，单位 GB（吉字节，衡量内存大小的单位）。
IP数量	该套餐附带的 IP 地址个数。
使用详情	一个进度条，显示符合此套餐条件的服务器的"已用 / 总数"以及"可用"数量——也就是有多少已被占用、还剩多少可分配。
带宽(Mbps)	网络带宽，单位 Mbps（兆比特每秒，衡量网速快慢，详见《IDC 术语速查表》）。
(上行/下行)端口 Mbps	上行端口与下行端口速率。"上行"指服务器往外发数据的速率，"下行"指往服务器收数据的速率。
自动采集硬件信息	"是 / 否"。"是"表示按服务器实际探测到的真实硬件来匹配；"否"表示按采购入库时登记的硬件信息来匹配（详见下文 4.4）。
操作	"修改""删除"图标按钮。

4.3 新增 / 编辑套餐

1. 点击右上角 添 加（或在某行点 修改 图标），弹出"规格 添加/修改"对话框。
2. 填写各项配置。
3. 点击 立即添加 / 立即修改 保存（成功提示"操作成功"）。

字段	是否必填	说明与取值
名称	必填	套餐名称，系统内唯一，不可与已有套餐重名。
内存大小	选填	单位 GB，新增时需为不小于 1 的数字。
IP数量	选填	套餐附带的 IP 个数，新增时需为不小于 1 的数字。
CPU名称	选填	从下拉中选择，下拉项来自系统已登记的 CPU 型号库（部件批次中类型为"CPU"的型号）。选了库里不存在的型号会被拒绝。
CPU总数	选填	CPU 颗数，新增时需为不小于 1 的数字。
硬盘	选填	可添加多块硬盘。每块需选择硬盘类型（HD / SSD / SAS）、接口类型（SATA / SAS），并填写硬盘大小（数字）。点复制图标可快速增加一行，点垃圾桶图标删除。
PCI设备	选填	可添加多个 PCI 扩展设备（如显卡/网卡等插卡设备）。每项选择 PCI 模型 与 PCI 类型，下拉项来自系统已登记的 PCI 部件库。同样支持复制/删除多行。
上行端口	选填	上行速率（Mbps），新增时需为不小于 1 的数字。
下行端口	选填	下行速率（Mbps）。
自动采集硬件信息	开关	取值"是 / 否"，含义见下文 4.4。

说明：套餐列表里有"带宽(Mbps)"一列，但新增/编辑弹窗里没有单独的"带宽"输入框，带宽通过上行/下行端口体现。

术语小贴士

• HD / SSD / SAS（硬盘类型）：HD 是传统机械硬盘，SSD 是更快的固态硬盘，SAS 是企业级高速硬盘。
• SATA / SAS（接口类型）：硬盘连接服务器的"接口标准"，SAS 通常用于企业级、性能更高。
• PCI 设备：插在服务器主板扩展槽上的硬件卡，常见如显卡（GPU）、专用网卡等。

校验提示：硬盘大小必须是数字；硬盘类型须为 HD/SSD/SAS 之一、接口须为 SATA/SAS 之一，否则保存会报错。

4.4 "自动采集硬件信息"开关的区别（重要）

这是套餐里最容易混淆、但很关键的一个开关，决定系统用哪份"硬件清单"来匹配服务器：

• 关（否）：按服务器采购入库时手工登记的硬件参数来匹配。此模式下系统还要求服务器具备"对外端口可用"等条件，且只有当套餐同时填写了 CPU 总数与内存时才会去匹配。
• 开（是）：按系统对服务器实际探测/采集到的真实硬件来匹配（此模式不再强制比对 IP 数量）。

两种模式都只会从"用于出租（type = rent）"类型的服务器中筛选。简单理解：如果你信任"实际探测到的硬件"，就开启自动采集；如果你想严格按采购台账匹配，就关闭它。

4.5 套餐详情页

在套餐列表点击规格名称，进入套餐详情页。该页有两个标签：

• 服务器信息：符合此套餐条件的服务器列表。
• 规格详情：以卡片形式展示该套餐的"硬件信息（名称、CPU 型号、CPU 核数、内存、带宽）""数据信息（磁盘数据、PCI 设备）""端口信息（上行/下行端口）""IP 信息（IP 数量）"。

📷 （界面截图待补充：套餐详情页的规格详情标签，展示硬件信息/数据信息/端口信息/IP信息四张卡片）

4.6 把套餐分配（绑定）给客户和服务器

套餐定义好之后，真正"交付"给客户的动作是把套餐 + 客户 + 机房组合起来下单，由系统按套餐条件挑选空闲服务器交付。该操作通常在服务器 / 交付相关流程中触发（"规格分配服务器"），分配时可设置的要点包括：

• 目标客户：把这套配置卖给哪个客户。
• 目标机房（数据中心）：从哪个机房的服务器里挑。
• 自定义带宽（选填）：可单独指定上行、下行，覆盖套餐默认端口速率。
• 保留 / 不重新分配 IP（选填）：用于客户需要保留特定 IP 的场景。
• 操作系统（选填）：交付时预装的镜像（系统模板，详见《IDC 术语速查表》）。

说明：分配的前提是该套餐确实有"可用"服务器（参见列表"使用详情"进度条）。若可用数为 0，则无法分配。具体的下单 / 交付界面与字段以服务器交付模块为准（视部署配置而定）。

4.7 删除套餐

在列表"操作"列点删除图标（单个），或勾选后用底部 删除 按钮（批量）。删除前会弹出"确认删除 N 规格 ?"二次确认；删除套餐属于敏感操作，开启"敏感操作二次验证"后需先输入双因素动态口令。

---

五、用户 API 凭证（用户管理 > 用户 API）

5.1 用途说明

用户 API 凭证是发给客户、让客户用程序自动对接系统的"钥匙"。比如客户希望用脚本批量查询自己的服务器、自动重装系统，就需要这把钥匙。一把钥匙由两段字符串组成：

• KEY：相当于"用户名"。
• secret：相当于"密码"，只在创建时显示一次，务必当场保存。

进入 用户管理 > 用户 API 查看与管理这些凭证。

5.2 列表字段

列名	含义
标签	给这把钥匙起的备注名，便于区分。
关联用户	这把钥匙属于哪个客户（点击可跳转该客户详情）。
IP地址	允许使用这把钥匙的来源 IP 白名单（限制只有这些 IP 能调用，提升安全性）。
最后调用时间	这把钥匙上一次被使用的时间。
操作	"修改""删除"图标按钮。

5.3 新增凭证

1. 点击右上角 添 加，弹出"用户 API 添加"对话框。
2. 填写字段后点击 立即添加。

字段	是否必填	说明
标签	必填	这把钥匙的备注名。
IP地址	选填	允许调用的 IP；多个用英文逗号分隔。每个都必须是合法 IPv4 地址，否则报"无效 IP 地址"。
选择用户	必填	这把钥匙归属的客户，可输入用户名远程搜索。

3. 创建成功后，弹窗顶部出现绿色提示"添加系统 API 成功 !（请自行保存 key 和 secret!）"，并在下方以两个输入框分别展示这把钥匙的 KEY 和 secret，方便复制。

📷 （界面截图待补充：用户API创建成功后展示KEY与secret的提示界面，提醒自行保存）

警告：secret 只在此刻显示一次，请立即复制保存并交给客户。关闭弹窗后无法再次查看。若丢失，只能删除后重新创建。

5.4 编辑 / 删除凭证

• 编辑：可修改标签、IP 白名单、关联用户（不会改变也不会重新显示 KEY / secret）。IP 白名单同样要求每个都是合法 IPv4。
• 删除：单个用行内删除图标，批量用底部 删除 按钮，均会弹出"确认删除 N 条数据 ?"二次确认。删除属于敏感操作，开启"敏感操作二次验证"后需先输入双因素动态口令。

---

六、当前用户页

当前用户页面用于查看与编辑"当前登录账号"自身的资料（头像、密码、邮箱、手机、状态、语言、两步验证等），界面与第二节的"用户信息"面板相同。它通过界面右上角的个人头像 / 账户菜单进入，而非出现在用户管理的列表导航中。管理员可在此维护自己的登录信息与安全设置。

📷 （界面截图待补充：当前用户页，展示自身资料编辑与两步验证区域）

---

七、操作小结与注意事项

• 用户名一旦创建不可修改，请在创建前与客户确认。
• 删除客户会连带释放其 IP 子网与解除服务器绑定，务必谨慎。
• 用户详情页除基本资料外，还有 通知设置 标签，可逐项配置 Web / 邮件 / 短信 通知。
• 套餐名称唯一；套餐的"自动采集"开关决定按"真实硬件"还是"采购台账"匹配服务器，两者都只匹配"出租型"服务器。
• 套餐新增 / 编辑弹窗里没有"带宽"输入框，带宽通过上行 / 下行端口体现。
• 用户 API 的 secret 仅显示一次，丢失需重建；IP 白名单的每个地址必须是合法 IPv4。
• 删除用户、删除用户分组、删除套餐、删除用户 API 凭证等敏感操作，当系统在《设置》中开启了"敏感操作二次验证"时，需先输入双因素动态口令才能执行。