---
title: 带宽配额与流量包
description: 介绍NexCMP如何根据CloudStack统计数据按服务计量流量、默认配额、80%与100%预警、超额处理策略及流量包。
url: https://nexcmp.com/zh-cn/docs/catalog/bandwidth/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 带宽配额与流量包 {#bandwidth-quotas-and-add-ons}

> **管理后台位置：**Services › Bandwidth: Summary (`/bandwidth`)、Add-on (`/bandwidth/addons`) 以及 Quotas, pricing & policy (`/bandwidth/policy`)。模块开关位于 System › Admin › License & updates。

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

Bandwidth为每个计量服务分配每月流量**配额**。NexCMP会监测用量，在达到80%和100%时提醒客户；当超出配额时，将根据您的**超额策略**执行相应操作。客户可使用钱包购买额外TB的**流量包**；您也可以免费为其发放流量包。

| 服务 | 配额 |
|---|---|
| 虚拟机 | 每台虚拟机每月（默认为2048 GB，即2 TB） |
| Kubernetes | 虚拟机配额乘以worker节点数量 |
| Object Storage | 每位客户每月的下载流量（默认为100 GB）；超出后按常规按量付费价格计费 |
| VPN | 保留其方案的配额；可在VPN页面升级带宽 |
| 私有云 | **不限流量** |

## 前提条件 {#requirements}

| 项目 | 要求 |
|---|---|
| 模块 | **Bandwidth**默认开启。可在License & updates下将其关闭以隐藏。 |
| 计量来源 | 使用默认来源**CloudStack VM statistics**。请在CloudStack中保持启用虚拟机统计数据收集；默认保留720分钟已足够。 |
| Proxmox VE | Proxmox VE上的虚拟机**不计量**。 |
| 汇率 | 加油包价格以VND输入。参见[货币与汇率](https://nexcmp.com/zh-cn/docs/catalog/currency-and-exchange-rates/)。 |
| 依赖项 | [CloudStack](https://nexcmp.com/zh-cn/docs/infrastructure/cloudstack/)用于虚拟机和Kubernetes流量，[S3](https://nexcmp.com/zh-cn/docs/infrastructure/s3/)用于存储下载。 |

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

除连接CloudStack外无需额外操作。NexCMP每5分钟通过单次调用读取该账户下所有虚拟机的`listVirtualMachinesUsageHistory`，时间窗口最长两小时。每个采样周期为一分钟并进行**累加**。采样取自3分钟前的数据以确保其有充足时间送达。超过CloudStack保留期（约12小时）的缺口将被跳过并记录。

::: info 数据含义
用量按每台虚拟机的网络接口进行统计，因此包含虚拟机之间的流量，而不仅是访问互联网的流量。统计值可能会略高于边缘路由器的计量。
:::

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

1. 打开**Services › Bandwidth › Quotas, pricing & policy**。
2. 设置各项数值并点击**Save**；系统会要求输入原因并予以记录。后台worker将在约30秒内应用更改。

   | 字段 | 默认值 | 说明 |
   |---|---|---|
   | 启用带宽（客户菜单与购买加油包） | 开启 | 该模块销售端的开关。 |
   | 虚拟机，GB/月（Kubernetes = 该值 × worker数） | 2048 | 每周期每台虚拟机的配额。 |
   | S3，每客户每月下载量（GB） | 100 | 超出后按常规S3按量计费收取。 |
   | 配额计费方向（虚拟机、Kubernetes） | 入站 + 出站 | 或**仅出站**。 |
   | +1 TB价格（VND） | 100,000 | 按报价汇率折算为美分。 |
   | 单次最大购买量（TB） | 50 | |
   | 超额策略 | suspend | **notify**、**throttle**或**suspend**（见下文）。 |
   | 实际执行暂停起始时间 | 迁移日期 + 24小时 | 在此日期之前不会暂停任何服务；仅向客户发出预警。 |
   | 限速速率限制（Mbps） | | 仅在throttle模式下使用。 |

      ![带宽策略：默认配额、加油包价格与超额策略](https://nexcmp.com/zh-cn/docs/images/catalog/bandwidth-01-policy.webp)

### 超额策略 {#overage-policies}

| 策略 | 服务用量超过100%时的处理方式 |
|---|---|
| **notify** | 通知客户。不采取其他操作。 |
| **throttle** | 目前与notify相同：限速器在此版本中尚未接入。 |
| **suspend**（默认） | 暂停虚拟机、集群或S3账户，直到客户购买加油包或进入下一周期。仅自**suspend-from**日期起生效。 |

80%和100%告警（铃铛与邮件）始终运行，每个阈值、周期和服务触发一次。若解除因带宽超额而被暂停的服务，但其仍处于超额状态，则下一次检查（5分钟内）会再次将其暂停。若要保持其正常运行，请**发放加油包**。

### 查看用量与发放加油包 {#watch-usage-and-grant-add-ons}

打开**Services › Bandwidth › Summary**。此页面列出所有服务及其在当前周期的用量、包含加油包的总配额、剩余配额以及80%和100%阈值线。KPI卡片显示服务数量、近30天售出的加油包数量及采集器状态（running、cursor）。**Daily**表格按天显示当前周期详情。

![显示采集器状态及各服务用量的Bandwidth Summary](https://nexcmp.com/zh-cn/docs/images/catalog/bandwidth-02-summary.webp)

若要为客户扩充额度，可在相应服务上点击**Grant**（免费赠送按整TB计算的加油包）。打开**Add-on**可查看购买和赠送记录，按最新优先排序，并支持类型筛选。

![显示购买与免费赠送记录的Add-on历史](https://nexcmp.com/zh-cn/docs/images/catalog/bandwidth-03-addons.webp)

### 客户视角 {#what-customers-see}

客户门户中会新增**Bandwidth**菜单，显示用量、剩余配额以及通过钱包扣款的**buy +1 TB**操作（受单次购买上限限制）。加油包仅在当前计费周期内有效。

## 验证 {#verify}

1. **Summary**页面中的采集器处于运行状态，且其cursor每隔几分钟向前移动。
2. 产生流量的虚拟机约在10至15分钟后显示用量。
3. 若要查看告警，可在**测试**环境中将虚拟机配额调低至几GB并产生部分流量。切勿在生产环境中执行此操作：配额会应用至所有虚拟机。

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

- 用量按周期（一个月）统计。加油包和配额仅适用于当前周期。
- “Enforce actual suspend from”可防止在首次启用该模块时立即暂停客户服务。
- 在此版本中，限速策略仅发送通知。
- 修改配额将应用于所有站点（包括分销商站点）。分销商的加油包零售价和批发价将根据其折扣或加价计算。
- 针对**Dedicated servers**的带宽为独立功能；请参阅[Dedicated servers](https://nexcmp.com/zh-cn/docs/infrastructure/dedicated/)。

## 故障排查 {#troubleshooting}

| 症状 | 原因 | 解决办法 |
|---|---|---|
| 运行中的虚拟机用量始终为零 | Worker已停止、CloudStack连接断开，或虚拟机统计信息未启用 | 检查`sudo nexcmp status`并点击**Test connection**（在[CloudStack](https://nexcmp.com/zh-cn/docs/infrastructure/cloudstack/)中）；启用CloudStack虚拟机统计信息。 |
| 用量数据存在断层 | 超出CloudStack数据保留期限，或Worker停机超过约12小时 | 无法恢复；断层已被记录。 |
| 用量略高于预期 | 包含了虚拟机之间的流量及其他网卡接口流量 | 属正常现象；向客户说明即可。 |
| 已暂停的服务在解锁后再次变为暂停状态 | 仍超出配额 | 赠送加油包或提高配额。 |
| 策略为**suspend**但没有任何服务被暂停 | 设定的暂停起始日期晚于当前时间 | 将其设置为当前时间（生效时页面会显示“ACTIVE”）。 |
| “bw_over_policy必须为notify、throttle或suspend” | 通过API传递了无效策略 | 请使用这三个值之一。 |
| Proxmox虚拟机未显示用量 | 未对此类虚拟机计量 | 属正常现象。 |
| 客户无法购买加油包 | 带宽功能已关闭，或钱包余额不足 | 检查开关状态及钱包余额。 |