FreeSwitch的mod_nibblebill实时计费模块

狂爱代码的码农

于 2025-02-20 06:12:10 发布

阅读量795

点赞数 11

分类专栏： VOIP那些事文章标签： freeswitch

本文链接：https://blog.youkuaiyun.com/weixin_44213550/article/details/145743306

版权

VOIP那些事专栏收录该内容

137 篇文章

订阅专栏

FreeSWITCH 的 mod_nibblebill 模块是一个专为实时计费设计的模块，主要用于预付费场景（如电话卡、在线充值服务等）。它允许在通话过程中动态扣除用户的账户余额，并在余额耗尽时终止通话，从而避免透支。以下从功能特性、应用场景、实现机制等方面详细介绍该模块：

一、功能特性

实时计费（动态扣费）
mod_nibblebill 支持按时间单位（如秒或分钟）实时扣除用户账户余额。例如，用户通话每分钟扣除固定费用或动态费率，系统持续监控余额，余额不足时自动挂断。
预付费支持
适用于需要预先充值的场景，如电话卡系统。用户账户初始设置一定金额，通话过程中逐步扣除，确保服务按需使用。
灵活配置
- 费率规则：可通过配置文件或数据库定义不同呼叫类型（如本地、国际）的费率。
- 计费间隔：支持设置扣费频率（如每6秒扣费一次）。
- 余额查询与更新：提供 API 接口实时查询或修改用户余额。
多后端支持
可结合其他模块（如 mod_db、mod_redis 或 mod_hash）存储用户账户信息，支持内存、数据库或分布式缓存等多种存储方式。

二、应用场景

电话卡系统
用户购买电话卡后，通话费用从卡内余额实时扣除，余额耗尽时自动终止通话。
企业预付费服务
企业可为员工设置通话预算，限制超额消费。
在线语音服务
如按分钟计费的语音会议或客服系统，结合动态费率实现灵活计费。

三、实现机制

计费触发与执行
- 通过 Dialplan 或 API 触发计费逻辑，例如在呼叫建立时调用 nibblebill 应用。
- 计费周期内，模块定期检查余额并扣费，直至通话结束或余额不足。

配置示例

<!-- 在拨号计划中调用 nibblebill -->
<action application="nibblebill" data="account_id=${caller_id_number} rate=0.05/60"/>

account_id：用户账户标识（通常为来电号码）。
rate：费率（如每分钟 0.05 元）。

与其他模块联动
- mod_db：从数据库读取用户余额。
- mod_event_socket：通过 ESL 实时监控计费事件。
- mod_json_cdr：生成带计费详情的 CDR 话单。

四、安装与使用

编译与加载
- 默认情况下，mod_nibblebill 可能未编译。需进入 FreeSWITCH 源码目录手动编译：
```
cd src/mod/applications/mod_nibblebill
make install
```
- 在 modules.conf.xml 中启用模块：
```
<load module="mod_nibblebill"/>
。
```
配置账户与费率
通过数据库或配置文件定义用户账户及费率策略。例如，使用 mod_hash 存储内存中的账户余额：
```
<params>
  <param name="hash-name" value="nibblebill"/>
  <param name="key" value="${caller_id_number}"/>
</params>
```

五、注意事项

性能影响：高频的实时扣费可能增加系统负载，需合理设置计费间隔。
容错机制：需处理网络中断或数据库连接失败的情况，避免计费错误。
安全性：余额存储与传输需加密，防止篡改。

总结

mod_nibblebill 是 FreeSWITCH 中实现预付费计费的核心模块，适用于需要实时扣费的场景。其灵活性和可扩展性使其能够与多种存储后端及计费策略集成，是构建电话卡、在线语音服务等系统的关键组件。具体配置细节可参考官方文档或结合 mod_db、mod_event_socket 等模块进一步优化。