模块
管理后台位置：System › Admin › License & updates（
/license），卡片Module。
功能说明
模块是指可作为一个整体开启或关闭的服务或功能。处于关闭状态的模块会在管理菜单中隐藏，且客户无法购买；对于附加模块，其API路由会返回404 module_disabled。启用模块仅代表显示该功能，其背后的基础设施仍需完成连接（见最后一列）。
前提条件
| 项目 | 要求 |
|---|---|
| 账户 | 具备写入权限的管理员。只读权限的员工可以看到开关但无法修改。 |
| 基础设施 | 参见表格：各模块列出了各自的要求。 |
| 依赖项 | 部分模块依赖其他模块（例如DDoS Shield需要DDoS & BGP）。 |
准备基础设施
开关本身无需此操作。请按照表格中链接页面所述连接各模块的基础设施。
在NexCMP中连接
- 打开System › Admin › License & updates并滚动至Module卡片。其中说明已禁用的模块会在管理菜单中隐藏，且客户无法购买。
- 操作模块开关。页面会提示Saved: reloading menu并刷新，菜单即刻更新。
模块列表
| 模块（显示名称） | 默认值 | 新增功能 | 所需依赖 | 页面 |
|---|---|---|---|---|
| Virtual Machines | 始终开启 | VM目录、订单、控制台、Snapshots | CloudStack或Proxmox VE | CloudStack, Proxmox VE |
| Bandwidth | 开启 | 针对VM、Kubernetes和S3的配额、附加组件、告警和超额操作 | 无额外依赖（CloudStack VM统计信息） | Bandwidth |
| OS & ISO Images | off | 客户可注册自定义操作系统镜像和ISO，按GB计费 | CloudStack；其二级存储VM需具备互联网访问权限 | 前提条件 |
| Kubernetes | off | Kubernetes集群（CKS） | 启用了CKS的CloudStack | Kubernetes与私有云 |
| Private Cloud | off | 包含独享带宽方案的VPC | CloudStack VPC和网络方案 | Kubernetes与私有云 |
| Object Storage | off | 基于Ceph RGW的S3账户，按量计费 | Ceph RGW以及带有S3服务的区域 | S3 |
| VPN | off | 自有节点上的VPN | 运行cmp-agent的节点 | VPN 和代理节点 |
| IPv6 Proxy | off | 自有节点上的IPv6代理 | 带有IPv6前缀的代理节点 | VPN 和代理节点 |
| Bare Metal | off | 通过iDRAC管理Dell服务器：订购、操作系统安装、控制台、电源 | 管理网络中的iDRAC 9 | 专用服务器 |
| AI Models | off | 销售AI模型访问权限的网关：一个密钥畅用多种模型、按模型定价、用量限制、日志、钱包计费 | 自行接入的模型源：具备兼容OpenAI或Anthropic的API及您自己的密钥 | AI Models |
| AI | off | AI Chat（自动化技术支持）与AI Agent（自然语言虚拟机管理） | 兼容OpenAI的提供商 | AI提供商 |
| DDoS Shield | off | 为客户提供IP防护；需要DDoS & BGP，未配置时该开关保持禁用 | DDoS & BGP附加组件 | 见下方 |
| DDoS & BGP | 关闭，附加组件 | 边缘路由器控制台：BGP、RTBH、XDP、会话和边缘流量 | 运行root守护进程的边缘主机 | 见下方 |
各开关的功能说明
- Bare Metal包含两个层级。模块开关用于显示管理后台菜单和API。向客户销售则是Services › Dedicated Server下一个带输入确认的独立开关，且在Infrastructure › Bare Metal › Safety下开启live ops之前，对iDRAC的所有写入操作均会被拦截。参见Dedicated servers。
- 对于Kubernetes、Private Cloud、VPN、IPv6 Proxy和Images，模块开关与服务页面上的销售开关控制的是同一项设置。
- AI还需要在System › Settings › AI provider下配置提供商。
- AI Models分为两个层级。模块开关用于显示管理后台菜单和API。向客户销售是在AI Models页面顶部的独立销售开关，默认关闭。参见AI Models。
启动时读取的模块
有三项功能并非普通开关。它们仅在服务启动时读取一次，且需要标准安装中未包含的基础设施。
| 功能 | 设置 | 状态 | 所需条件 |
|---|---|---|---|
| DDoS & BGP | module_ddos | 关闭时显示为Add-on package，开启时显示为Installed。控制台中没有开关。 | 以root身份运行的边缘路由器守护进程（BGP、RTBH、XDP、流量统计）。控制面板以非特权用户运行，无法运行这些进程。 |
| AI | module_ai | 常规开关。路由会立即生效；AI Chat的后台作业（工单排查、定时回复）将在服务下次重启时启动。控制台会提示建议重启。 | AI提供商。 |
| Web SSH终端 | feature_ssh_web | 默认关闭，控制台中没有开关 | 独立的SSH代理服务及其路由。未配置时，客户门户的Console标签页仅显示VNC。AI Agent不需要此服务：它通过控制面板自身建立的SSH连接来执行命令。 |
修改启动设置后，请重启服务：sudo systemctl restart nexcmp nexcmp-vmd。
验证
- 重新加载后，模块的菜单项将会出现（或消失）。
- 对于面向客户的模块，客户登录门户后即可看到新增的菜单项。关闭的模块则不显示任何内容或显示“coming soon”。
限制与注意事项
- 关闭模块不会删除任何内容。正在运行的虚拟机、集群、S3账户和订阅将继续运行并计费；客户只是无法创建新资源。
- 配额页面仅列出已启用模块的服务。
故障排查
| 症状 | 原因 | 解决办法 |
|---|---|---|
| 菜单项未显示 | 页面未刷新 | 刷新管理控制台。 |
| DDoS Shield开关处于禁用状态 | DDoS & BGP未安装 | DDoS Shield需要DDoS & BGP插件。 |
| “This module is an add-on package and cannot be switched here”（HTTP 409或422） | 您（或脚本）尝试切换DDoS & BGP | 该模块属于附加软件包，不提供开关。 |
| “DDoS Shield需要DDoS & BGP附加组件” | 同理，适用于DDoS Shield | 请先安装该插件。 |
模块路由返回404 module_disabled | 模块已关闭 | 开启该模块。 |
| AI Chat正常回复但工单调查从未启动 | AI模块开启后未重启服务 | sudo systemctl restart nexcmp nexcmp-vmd. |
| 只读员工无法保存 | 其角色为只读 | 请使用管理员账户。 |