虚量方案

更新时间：2026-05-21

• 虚量方案用于控制用户在充值端看到的"显示流量"与卡板实际流量之间的换算关系。

简单理解： 卡板实际有 1GB 流量，通过虚量方案可以让用户看到的显示为 2GB。反之也可以缩小显示。

常见用途：

• 叠加赠送：让用户看到比实际更多的流量（增加产品吸引力）
• 达量后虚量：套餐流量用完后，显示"剩余流量不足"而非 0
• 分时段虚量：高峰/低谷时段显示不同的可用流量

虚量类型说明

类型	说明	示例
达量触发	累计用量达到阈值后，开始按设定比例虚量。	阈值100MB，比例20%，则用满100MB后，每用1MB扣1.2MB
固定比例	始终按固定比例虚量。	比例30%，则每用1MB扣1.3MB
达量阶梯	按累计总用量匹配阶梯，应用对应比例。	5MB后+5%，50MB后+50%。则5MB之前虚量0%；5MB-50MB之间虚量5%；累计到50MB后虚量50%
无感阶梯	每次同步时仅以本次新增用量匹配阶梯比例，用户无感知。	500MB+10%，2GB+50%，新增<500MB虚0%；500MB-2GB虚10%；>2GB虚50%
固定总量	设定固定可用流量，系统根据套餐包总量自动计算虚量比例。	设置可用100G，套餐包300G，则系统自动转换虚量比例=200%
分时比例	按24小时时段设置不同虚量比例，实现分时段差异化计费。	凌晨0-6点低谷期虚量50%，白天高峰期虚量10%

注意

1. 虚量方案只影响充值端和套餐包的显示流量，不改变卡板的实际流量，也不影响运营商侧的计费。
2. 虚量不适用于共享池和代理商API对接套餐包。

添加虚量方案

后台位置：【物联中台】 → 【规则方案】 → 【虚量方案】 →【虚量方案】 →【添加虚量方案】， 选择虚量类型后，根据类型填写对应参数（阈值、比例、数量等）。

温馨提示：智能虚量方案功能从企业版开始提供。

绑定到套餐系列

方案配置完成后，在套餐系列的"虚量方案"中选择即可生效。

点我查看-套餐系列

绑定到套餐包

虚量方案配置完成后，在套餐包的"虚量方案"字段中选择对应方案即可生效。优先级：单卡虚量 > 套餐包虚量 > 系列虚量。为空时继承系列配置。

当套餐包绑定有虚量方案，则在该套餐包抵扣已用流量时会自动代入规则计算，属于控制粒度更细的使用方式。

点我查看-套餐包

单卡虚量

为指定裸卡设置单独的虚量方案，优先级：单卡虚量 > 套餐包虚量 > 系列虚量。

单设备虚量

为指定设备设置单独的虚量方案，优先级：单设备虚量 > 套餐包虚量 > 系列虚量。

虚量白名单

为指定卡板/设备设置虚量白名单。设为白名单后，将无视卡板/设备下的虚量方案设置。

测算工具

为了方案平台快速测试自己虚量方案的实际效果，我们提供了一致算法的测试工具，方便模拟用量测试，从而预测虚量方案是否符合自己的预期效果。

模拟测试

方案对比

可以选择多个虚量方案，设置统一的总量和用量，来对比方案之间的差异。对总量不固定的方案之间的测算对比更能感知到用量趋势和幅度变化。

反向推荐

当你不知道怎么设置虚量方案合适时，可以直接使用反向推荐，填入套餐总流量和期望真实可用流量，系统会生成多种能满足你需求的方案供你选用。

流量轮询日志

系统每次轮询同步流量时，都会将计费过程记录到日志中，方便排查虚量计费异常。

日志文件路径： /root/haoka/haoka/logs/logger/robin/年-月-日.log，每天一个文件，日志默认保留 7 天。

# 将 <号码> 替换为实际卡号或设备号，将日期替换为要查的那天
grep '<号码>' /root/haoka/haoka/logs/logger/robin/2026-05-19.log

示例输出：

2026-05-19T10:23:01.424+08:00 [INFO] [裸卡:8986****078013] 本次计费虚量：100.19MB，本次计费实量:100.19MB, 剩余流量：-2.94GB, 总量：0.00B
2026-05-19T10:23:01.424+08:00 [INFO] [裸卡:8986****078013] 触发轮询停机, 原因: 未开通套餐或套餐到期，自动停机

日志字段说明

字段	说明
本次计费虚量	本次轮询计入的虚量增量（用户看到的扣减量）
本次计费实量	本次轮询上游返回的真实新增流量
剩余流量	当前套餐包剩余可用虚量（负数说明已超量）
总量	套餐包配置的总流量