w4ff1e/onvif-media-transcoder
w4ff1e
基于Rust的ONVIF兼容媒体转码器，支持将RTSP、HTTP等媒体流转换为ONVIF标准RTSP流，内置WS-Discovery服务实现设备自动发现。
下载次数: 0状态：社区镜像维护者：w4ff1e仓库类型：镜像最近更新：7 个月前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ONVIF媒体转码器
https://img.shields.io/badge/license-MIT-blue.svg](LICENSE) https://img.shields.io/github/actions/workflow/status/W4ff1e/onvif-media-transcoder/docker-publish.yml?branch=main&label=build](https://github.com/W4ff1e/onvif-media-transcoder/actions/workflows/docker-publish.yml) https://img.shields.io/docker/pulls/w4ff1e/onvif-media-transcoder?logo=docker](https://hub.docker.com/r/w4ff1e/onvif-media-transcoder) https://img.shields.io/docker/v/w4ff1e/onvif-media-transcoder?logo=docker&sort=semver](https://hub.docker.com/r/w4ff1e/onvif-media-transcoder/tags) https://img.shields.io/docker/image-size/w4ff1e/onvif-media-transcoder/latest?logo=docker](https://hub.docker.com/r/w4ff1e/onvif-media-transcoder) https://img.shields.io/badge/ONVIF-%E5%85%BC%E5%AE%B9-green.svg]([] https://img.shields.io/badge/rust-1.70%2B-orange.svg]([] https://img.shields.io/badge/security-policy-red.svg](SECURITY.md)
⚠️ AI生成代码警告：本项目包含使用GitHub Copilot辅助生成的代码，尽管经过测试，但生产环境使用前需进行安全审查和验证。
概述
基于Rust开发的ONVIF媒体转码器，可将HLS、MP4、RTSP等多种输入流转换为ONVIF Profile S兼容的RTSP流，内置WS-Discovery服务实现设备自动发现，支持多种认证方式。
功能
- 支持MediaMTX兼容的多源输入流（HLS、MP4、RTSP、HTTP）
- 符合ONVIF Profile S标准，提供设备/媒体服务端点
- 内置WS-Discovery多播发现服务
- 支持HTTP Basic/Digest及WS-Security认证
- 无重新编码的低延迟流重封装
快速部署
Docker运行示例
bash# 默认演示流 docker run --rm --network host w4ff1e/onvif-media-transcoder:latest # 自定义流配置 docker run --rm --network host \ -e INPUT_URL="https://your-stream.m3u8" \ -e DEVICE_NAME="我的摄像头" \ -e ONVIF_USERNAME="admin" \ -e ONVIF_PASSWORD="secure123" \ w4ff1e/onvif-media-transcoder:latest
环境变量配置
| 变量名 | 默认值 | 描述 |
|---|---|---|
| INPUT_URL | 演示HLS流 | 源视频流地址 |
| RTSP_OUTPUT_PORT | 8554 | RTSP输出端口 |
| ONVIF_PORT | 8080 | ONVIF服务端口 |
| ONVIF_USERNAME | admin | 认证用户名 |
| WS_DISCOVERY_ENABLED | true | 是否启用设备发现 |
注意：WS-Discovery需使用--network host模式确保跨网络发现功能正常。
架构
服务由三个核心组件构成：
- ONVIF服务（Rust）：提供SOAP协议的设备管理接口
- WS-Discovery服务（Rust）：UDP多播设备发现
- MediaMTX：轻量级RTSP服务器实现流重封装
兼容性
支持的ONVIF端点
- 设备服务：GetCapabilities、GetDeviceInformation
- 媒体服务：GetProfiles、GetStreamUri、GetVideoSources
发现协议
- WS-Discovery（UDP 3702端口）
- 多播地址：239.255.255.250:3702
测试验证
bash# 测试ONVIF设备能力 curl -X POST http://localhost:8080/onvif/device_service \ -H "Content-Type: application/soap+xml" \ -d '<?xml version="1.0"?><soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"><soap:Body><GetCapabilities/></soap:Body></soap:Envelope>' # 检查RTSP流 ffprobe rtsp://localhost:8554/stream
安全建议
- 生产环境需修改默认认证凭据
- 限制网络访问范围，避免公网直接暴露
- 定期更新镜像以获取安全补丁
许可证
本项目采用MIT许可证，详见LICENSE文件。 免责声明：本软件按现状提供，不承担任何使用风险。 ===END===
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 onvif-media-transcoder 镜像标签
docker pull docker.xuanyuan.run/w4ff1e/onvif-media-transcoder:<标签>
DockerHub 原生拉取命令
docker pull w4ff1e/onvif-media-transcoder:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"