jambonz/rtpengine-sidecar
jambonz
sbc-rtpengine-sidecar是基于create-drachtio-app创建的sidecar应用，用于SBC与rtpengine集成，处理SIP请求（如OPTIONS）和rtp事件，支持通过环境变量配置，适用于VoIP系统中SBC和rtpengine的协同工作。
下载次数: 0状态：社区镜像维护者：jambonz仓库类型：镜像最近更新：19 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
sbc-rtpengine-sidecar
镜像概述和主要用途
sbc-rtpengine-sidecar是使用https://www.npmjs.com/package/create-drachtio-app%E5%88%9B%E5%BB%BA%E7%9A%84sidecar%E5%BA%94%E7%94%A8%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%AE%9E%E7%8E%B0SBC%EF%BC%88%E4%BC%9A%E8%AF%9D%E8%BE%B9%E7%95%8C%E6%8E%A7%E5%88%B6%E5%99%A8%EF%BC%89%E4%B8%8Ertpengine%E7%9A%84%E9%9B%86%E6%88%90%E3%80%82%E8%AF%A5%E5%BA%94%E7%94%A8%E5%88%9D%E5%A7%8B%E7%94%A8%E4%BA%8E%E5%A4%84%E7%90%86SIP%E8%AF%B7%E6%B1%82%E5%92%8Crtp%E4%BA%8B%E4%BB%B6%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E8%BF%9B%E8%A1%8C%E7%81%B5%E6%B4%BB%E9%85%8D%E7%BD%AE%E3%80%82%E7%94%A8%E6%88%B7%E5%8F%AF%E6%A0%B9%E6%8D%AE%E5%AE%9E%E9%99%85%E9%9C%80%E6%B1%82%E4%BF%AE%E6%94%B9%E6%88%96%E6%89%A9%E5%B1%95%E5%85%B6%E5%8A%9F%E8%83%BD%E9%80%BB%E8%BE%91%E3%80%82
核心功能和特性
- SIP请求处理：响应SIP OPTIONS请求并返回200（用户可根据需求自定义逻辑）
- rtp事件监听：通过指定端口监听来自rtpengine的rtp事件
- 灵活配置：支持通过环境变量配置多种参数，包括服务器地址、端口、集成服务（如AWS SNS、Redis）等
- 多环境适配：可配置为Kubernetes服务运行，支持集群部署
- 可扩展性：基于drachtio框架，便于扩展以处理更多SIP请求类型和业务逻辑
使用场景和适用范围
- SBC部署环境中与rtpengine协同工作的sidecar组件
- 需要处理SIP OPTIONS请求进行存活探测的VoIP系统
- 需收集和处理rtpengine生成的rtp事件的场景
- 基于drachtio框架构建的SIP应用扩展
使用方法和配置说明
环境变量配置
应用通过以下环境变量进行配置：
| 变量名 | 含义 | 必填 |
|---|---|---|
| AWS_REGION | AWS区域 | 否 |
| AWS_SNS_PORT | 监听AWS SNS请求的TCP端口 | 否 |
| DTMF_ONLY | 运行在仅DTMF模式 | 否 |
| RTPENGINE_DTMF_LOG_PORT | 监听来自rtpengine的rtp事件的端口 | 是 |
| RTPENGINE_URL | rtpengine的WebSocket URL | 否 |
| DRACHTIO_HOST | drachtio服务器的IP地址（通常为'127.0.0.1'） | 否 |
| DRACHTIO_PORT | drachtio服务器控制连接的监听端口（通常为9022） | 否 |
| DRACHTIO_SECRET | 共享密钥 | 否 |
| JAMBONES_CLUSTER_ID | 集群ID | 否 |
| JAMBONES_LOGLEVEL | 应用日志级别，可选'info'或'debug' | 否 |
| JAMBONES_REDIS_HOST | Redis主机 | 否 |
| JAMBONES_REDIS_PORT | Redis端口 | 否 |
| JAMBONES_SBCS | 内部网络中SBC的IP地址列表，逗号分隔 | 否 |
| OPTIONS_PING_INTERVAL | SIP OPTIONS探测间隔 | 否 |
| K8S | 服务是否作为Kubernetes服务运行 | 否 |
Docker部署示例
基本运行命令
bashdocker run -d \ -e RTPENGINE_DTMF_LOG_PORT=5000 \ -e DRACHTIO_HOST=127.0.0.1 \ -e DRACHTIO_PORT=9022 \ --name docker.xuanyuan.run/sbc-rtpengine-sidecar \ docker.xuanyuan.run/sbc-rtpengine-sidecar
带AWS SNS和Redis配置的示例
bashdocker run -d \ -e RTPENGINE_DTMF_LOG_PORT=5000 \ -e AWS_REGION=us-west-2 \ -e AWS_SNS_PORT=4000 \ -e JAMBONES_REDIS_HOST=redis-host \ -e JAMBONES_REDIS_PORT=6379 \ -e JAMBONES_LOGLEVEL=debug \ --name docker.xuanyuan.run/sbc-rtpengine-sidecar \ docker.xuanyuan.run/sbc-rtpengine-sidecar
SIP请求处理
应用初始配置处理以下SIP请求：
OPTIONS请求
对于传入的SIP OPTIONS消息，应用会返回200响应。用户应根据实际业务需求实现自定义处理逻辑。
测试
生成项目时未包含测试套件。如需获取基于Docker的初始测试套件，建议使用--test标志重新生成项目。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 rtpengine-sidecar 镜像标签
docker pull docker.xuanyuan.run/jambonz/rtpengine-sidecar:<标签>
DockerHub 原生拉取命令
docker pull jambonz/rtpengine-sidecar:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"