---
title: 模块
description: NexCMP所有模块的默认状态、新增功能、所需基础设施及启用位置，包括启动时读取的附加模块。
url: https://nexcmp.com/zh-cn/docs/infrastructure/modules/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 模块 {#modules}

> **管理后台位置：**System › Admin › License & updates（`/license`），卡片**Module**。

## 功能说明 {#what-it-does}

模块是指可作为一个整体开启或关闭的服务或功能。处于**关闭**状态的模块会在管理菜单中隐藏，且客户无法购买；对于附加模块，其API路由会返回`404 module_disabled`。启用模块仅代表显示该功能，其背后的基础设施仍需完成连接（见最后一列）。

## 前提条件 {#requirements}

| 项目 | 要求 |
|---|---|
| 账户 | 具备写入权限的管理员。只读权限的员工可以看到开关但无法修改。 |
| 基础设施 | 参见表格：各模块列出了各自的要求。 |
| 依赖项 | 部分模块依赖其他模块（例如DDoS Shield需要DDoS & BGP）。 |

## 准备基础设施 {#prepare-the-infrastructure}

开关本身无需此操作。请按照表格中链接页面所述连接各模块的基础设施。

## 在NexCMP中连接 {#connect-in-nexcmp}

1. 打开**System › Admin › License & updates**并滚动至**Module**卡片。其中说明已禁用的模块会在管理菜单中隐藏，且客户无法购买。
2. 操作模块开关。页面会提示**Saved: reloading menu**并刷新，菜单即刻更新。

![License & updates中包含各模块开关的Module卡片](https://nexcmp.com/zh-cn/docs/images/infrastructure/modules-01-license-modules.webp)

### 模块列表 {#the-modules}

| 模块（显示名称） | 默认值 | 新增功能 | 所需依赖 | 页面 |
|---|---|---|---|---|
| **Virtual Machines** | 始终开启 | VM目录、订单、控制台、Snapshots | CloudStack或Proxmox VE | [CloudStack](https://nexcmp.com/zh-cn/docs/infrastructure/cloudstack/), [Proxmox VE](https://nexcmp.com/zh-cn/docs/infrastructure/proxmox/) |
| **Bandwidth** | **开启** | 针对VM、Kubernetes和S3的配额、附加组件、告警和超额操作 | 无额外依赖（CloudStack VM统计信息） | [Bandwidth](https://nexcmp.com/zh-cn/docs/catalog/bandwidth/) |
| **OS & ISO Images** | off | 客户可注册自定义操作系统镜像和ISO，按GB计费 | CloudStack；其二级存储VM需具备互联网访问权限 | [前提条件](https://nexcmp.com/zh-cn/docs/infrastructure/requirements/) |
| **Kubernetes** | off | Kubernetes集群（CKS） | 启用了CKS的CloudStack | [Kubernetes与私有云](https://nexcmp.com/zh-cn/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Private Cloud** | off | 包含独享带宽方案的VPC | CloudStack VPC和网络方案 | [Kubernetes与私有云](https://nexcmp.com/zh-cn/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Object Storage** | off | 基于Ceph RGW的S3账户，按量计费 | Ceph RGW以及带有S3服务的区域 | [S3](https://nexcmp.com/zh-cn/docs/infrastructure/s3/) |
| **VPN** | off | 自有节点上的VPN | 运行`cmp-agent`的节点 | [VPN 和代理节点](https://nexcmp.com/zh-cn/docs/infrastructure/vpn-proxy-nodes/) |
| **IPv6 Proxy** | off | 自有节点上的IPv6代理 | 带有IPv6前缀的代理节点 | [VPN 和代理节点](https://nexcmp.com/zh-cn/docs/infrastructure/vpn-proxy-nodes/) |
| **Bare Metal** | off | 通过iDRAC管理Dell服务器：订购、操作系统安装、控制台、电源 | 管理网络中的iDRAC 9 | [专用服务器](https://nexcmp.com/zh-cn/docs/infrastructure/dedicated/) |
| **AI Models** | off | 销售AI模型访问权限的网关：一个密钥畅用多种模型、按模型定价、用量限制、日志、钱包计费 | 自行接入的模型源：具备兼容OpenAI或Anthropic的API及您自己的密钥 | [AI Models](https://nexcmp.com/zh-cn/docs/infrastructure/ai-models/) |
| **AI** | off | AI Chat（自动化技术支持）与AI Agent（自然语言虚拟机管理） | 兼容OpenAI的提供商 | [AI提供商](https://nexcmp.com/zh-cn/docs/ai/ai-providers/) |
| **DDoS Shield** | off | 为客户提供IP防护；需要DDoS & BGP，未配置时该开关保持禁用 | DDoS & BGP附加组件 | 见下方 |
| **DDoS & BGP** | 关闭，**附加组件** | 边缘路由器控制台：BGP、RTBH、XDP、会话和边缘流量 | 运行root守护进程的边缘主机 | 见下方 |

### 各开关的功能说明 {#which-switch-does-what}

- **Bare Metal**包含两个层级。模块开关用于显示管理后台菜单和API。向客户销售则是**Services › Dedicated Server**下一个带输入确认的独立开关，且在**Infrastructure › Bare Metal › Safety**下开启**live ops**之前，对iDRAC的所有写入操作均会被拦截。参见[Dedicated servers](https://nexcmp.com/zh-cn/docs/infrastructure/dedicated/)。
- 对于**Kubernetes**、**Private Cloud**、**VPN**、**IPv6 Proxy**和**Images**，模块开关与服务页面上的销售开关控制的是同一项设置。
- **AI**还需要在**System › Settings › AI provider**下配置提供商。
- **AI Models**分为两个层级。模块开关用于显示管理后台菜单和API。向客户销售是在AI Models页面顶部的独立销售开关，默认关闭。参见[AI Models](https://nexcmp.com/zh-cn/docs/infrastructure/ai-models/)。

### 启动时读取的模块 {#modules-read-at-start-up}

有三项功能并非普通开关。它们仅在**服务启动时读取一次**，且需要标准安装中未包含的基础设施。

| 功能 | 设置 | 状态 | 所需条件 |
|---|---|---|---|
| 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`。

## 验证 {#verify}

1. 重新加载后，模块的菜单项将会出现（或消失）。
2. 对于面向客户的模块，客户登录门户后即可看到新增的菜单项。关闭的模块则不显示任何内容或显示“coming soon”。

## 限制与注意事项 {#limits-and-notes}

- 关闭模块不会删除任何内容。正在运行的虚拟机、集群、S3账户和订阅将继续运行并计费；客户只是无法创建新资源。
- 配额页面仅列出已启用模块的服务。

## 故障排查 {#troubleshooting}

| 症状 | 原因 | 解决办法 |
|---|---|---|
| 菜单项未显示 | 页面未刷新 | 刷新管理控制台。 |
| 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`. |
| 只读员工无法保存 | 其角色为只读 | 请使用管理员账户。 |