gb28181-rs:Rust 的 GB28181 设备端库——两条接缝接入你的采集管线
gb28181-rs· MIT · Rust 1.80 ·手写 SIP不依赖任何 SIP 框架让 Rust 程序以设备身份注册到 GB/T 28181 平台注册与摘要认证、目录应答、INVITE 点播、RTP/PS 推流、录像回放与下载全部内置。宿主只需要提供两样东西视频帧和可选的录像索引。crategb28181-rscrates.io当前版本0.5.10.6.0 加固版在途许可证MIT协议版本GB/T 28181-2016 / 2022关键依赖tokio、serde serde-xml-rs、encoding_rs、md-5 sha2测试134 个含与 Go 孪生库的逐字节金串对齐测试仓库https://github.com/mickeyzzc/gb28181-rs它补的是哪个空Rust 的 GB28181 生态约等于零crates.io 上只有一个 2023 年就弃坑的gb281810.1.0下载量一千五以及 2026 年 7 月才冒头、尚无生产证据的实验性 siprs 系列。GitHub 上唯一活跃的 Rust GB28181 项目是一个平台应用不是库。想在 Rust 里做设备端此前只有一条路自己手写。gb28181-rs 不是按规范文档新写的而是从我们一款 Rust 摄像头固件的生产实现中整体抽取而来——那套代码在真实平台面前跑了很久README 里列的硬化清单digest 认证的 URI 匹配、Via branch 唯一性、本机地址检测、MANSCDP 属性/元素双形态、TCP 传输、回放控制每一项背后都是一次真机互操作故障。设计只留两条接缝这个库的 API 哲学是库管协议宿主管业务宿主侧要实现的东西收敛到两个 traitgb28181-rs你的程序SIP 信令 RTP/PS 流采集/编码管线H.264/H.265 NALUFrameSource 实现录像索引RecordingSource 实现Gb28181ServerREGISTER/Digest/保活/目录INVITE/BYE/INFOPS 封装 RTP 推流直播 · 回放 · 下载GB28181 平台FrameSource必须直播帧的来源。库在 INVITE 到来时向你要一个订阅你把编码器输出的访问单元推进通道即可RecordingSource可选录像索引。实现它平台就能查 RecordInfo、发起回放与下载。其余一切——REGISTER 生命周期、401 摘要认证、保活、目录/设备信息/状态应答、SDP 解析、PS 封装、RTP 打包、回放节奏控制——都是库的事。上手三十行接入[dependencies] gb28181-rs 0.5.1 # git 方式: gb28181-rs { git https://github.com/mickeyzzc/gb28181-rs.git, tag v0.5.1 }usegb28181_rs::{FrameSource,FrameSubscription,RecordingSource,SegmentMeta,Gb28181Config,Gb28181Server,set_record_active};// 1) 直播帧:在你的采集管线枢纽上实现 FrameSourcestructMyFrameHub{/* ... */}implFrameSourceforMyFrameHub{fnsubscribe_with_capacity(self,capacity:usize)-FrameSubscription{/* ... */}fnunsubscribe(self,id:u64){/* ... */}}// 2) 录像:在你的录像索引上实现 RecordingSourcestructMyRecordings{/* ... */}implRecordingSourceforMyRecordings{fnlookup(self,start_ms:u64,end_ms:u64)-VecSegmentMeta{/* ... */}}// 3) 启动设备服务。停机是优雅的:收发循环、保活任务、// 进行中的媒体任务都会依次停下。#[tokio::main]asyncfnmain()-anyhow::Result(){letmutconfig:Gb28181Configtoml::from_str(std::fs::read_to_string(config.toml)?)?;// 身份字段可由宿主配置,默认值是中性的(见下文)config.user_agentSome(my-host/1.0 (gb28181-rs).to_string());letmutserverGb28181Server::start(config,std::sync::Arc::new(MyFrameHub{/* ... */}),Some(std::sync::Arc::new(MyRecordings{/* ... */})),).await?;// ... 运行你的程序;退出时:server.shutdown().await}没有现成的采集管线库自带MockFrameHub——一个带容量上限、写满即丢的参考FrameSource实现先跑通信令再接真帧。配置要点Gb28181Config是 serde 结构体TOML/JSON 都能直接反序列化。默认值刻意取自规范文档的示例值平台地址192.168.1.1、设备 ID34020000001320000001、密码12345678、端口 5060——如果启动时发现你还在用这些示例默认值会打一条警告避免拿演示配置上了生产这类事故。身份字段全部可配且默认中性user_agent默认gb28181-rs/版本device_name默认Camera 设备ID厂商/型号默认Unknown。也就是说这个库不会在报文里替任何产品/厂商打广告白标设备放心用。能力细览信令与认证。手写的 GB/T 28181 SIP 子集REGISTER/INVITE/MESSAGE/BYE/ACK/OPTIONSUDP TCP加 SDP。摘要认证同时支持 MD5 与 SHA-256 算法、qopauthcnonce 用 CSPRNG 生成user_agent、local 地址等身份要素都可配不会把实现细节泄到报文之外。MANSCDP。Catalog/DeviceInfo/DeviceStatus/RecordInfo/Keepalive 的应答构造全都有元素式与属性式双形态都发得出入站报文按 UTF-8 或 GB2312/GBK/GB18030 自动识别出站按规范惯例以 GB2312 编码。20 位国标设备 ID 有专门的格式解析模块类型码 111IPC、118NVR。媒体。H.264/H.265 NALU → MPEG-2 PS → RTPUDP 与 TCPSSRC、超 64KB 访问单元的有界 PES 切分、采集时间戳穿透全部内置。PS 封装既可以走服务器的直播路径也可以单独拿出来用letpsgb28181_rs::mux_h264_to_ps([sps,pps,idr],true,pts,dts);回放与下载。实现了RecordingSource之后RecordInfo 查询、按实时节奏的回放推流、全速的下载推流以及平台通过 SIP INFO 下发的 PlaybackControl暂停/播放/拖动/倍速都有完整处理。正在本地录像时调用set_record_active(true)DeviceStatus 就会如实上报RecordON/Record。录像段格式。库内置一个参考格式Annex-B 裸流 每帧一条 PTS 记录的.ts.jsonl边车文件读取器随库提供。用它录像的宿主天然获得 RecordInfo/回放支持零格式适配。与 Go 孪生库逐字节对齐GB28181 的媒体面没有差不多兼容PS 封装差一个字段平台端解复用就可能丢帧。gb28181-rs 与姊妹库 gb28181-go 之间有一组金串测试把封装输出钉死成十六进制常量两个语言的实现必须产出逐字节相同的 PS 流/// 小型关键帧(SPSPPSIDR)—— 与 Go 孪生库逐字节一致/// (pack header PSM 单个带时间戳的 PES)。#[test]fngolden_keyframe_matches_go_twin(){letsps:Vecu8vec![0x67,0x42,0x80,0x28,0xDA,0x01,0xE0,0x08];letpps:Vecu8vec![0x68,0xCE,0x3C,0x80];letidr:Vecu8vec![0x65,0x88,0x84,0x00,0x4B,0x00,0x01,0x00];letpsmux_h264_to_ps([sps,pps,idr],true,90_000,90_000);constGOLDEN:str000001ba440016fc8401009c43f8000001bb000b01000000041be000000000000001e0002bc00a310005bf21110005bf21000000000167428028da01e00800000168ce3c80000001658884004b000100;assert_eq!(hex(ps),GOLDEN);}同一组测试还覆盖 P 帧和 200KB 大访问单元的四段 PES 切分每段声明长度逐字节核对。实际意义Rust 设备对接 Go 平台以及任何以 Go 实现为参照的平台的媒体兼容性不靠祈祷靠断言。真机实战这个库的抽取过程本身就是一次全链路验证从固件源码树抽出宿主一侧删掉了六千七百余行随即在真机上对 GB28181 平台跑完整回归——digest 注册、目录查询、INVITE、RTP-PS 解复用、H.264 录像落盘——全绿后才切换。此后作为 Rust 摄像头产品的 GB28181 栈日常生产运行。一个反向的教训也值得记录我们曾有另一个 Rust 项目直接复制了这份代码的早期版本。没有库边界之后上游的互操作修复自然到不了它那里——短短几个月它接连复现了上游早已修完的三类问题digest 认证的 URI 与 Request-URI 不一致、MANSCDP 字段该用属性形态、MESSAGE 缺路由头。复制即分叉这正是这个库存在的理由。工程质量134 个测试信令、编解码、媒体封装、回放节奏各有专门覆盖另有库卫生无 panic 路径等与服务器生命周期集成测试CI 三道闸cargo fmt --check、cargo clippy --all-targets -- -D warnings、cargo test另有两个附加作业——MSRV 1.80 实际构建验证、Windows 交叉检查打v*标签即自动测试并发布到 crates.ioexamples/四个演示全部可以离线或本机回环跑通ps_muxPS 封装/解封装/大帧切分纯离线device_demo手写假平台与真实设备服务在本机对接——注册、目录、INVITE、RTP/PS 解复用、BYE平台侧还验证 digest 应答成功退出码 0playback_demoRecordInfo、节奏化回放、PAUSE/倍速 PLAY、BYEmanscdp_demo设备 ID 解析、保活构造、各类应答报文。cargorun--exampledevice_demo# 推荐从这个开始:两分钟看完协议全程边界与路线刻意不做平台端/UAS 角色、SIP over TLS/WebSocket。设备端库把一件事做透。0.6.0 加固版在途分支待发布无 panic 构造器、端口与身份可配置化、GB2312 出入站编解码、log 门面、优雅停机外加库卫生源码扫描守卫禁 print 宏/品牌/panic/实验室 IP。README 如实标注API 面已趋稳但尚未冻结生产环境我们的摄像头产品线每日实战中。

相关新闻

一个 Skill 就能做完整 PPT?PPT Master 来了!

一个 Skill 就能做完整 PPT?PPT Master 来了!

一个 Skill 就能做完整 PPT?PPT Master 来了! 文章目录 一、PPT Master Skill 核心能力二、环境安装三、实际测试任务与 Prompt四、完整操作过程五、最终产物与效果六、实际使用后的判断 最近试了一下开源的 PPT Master Skill。和常见的“一句话直接生…

2026/11/16 3:38:05 阅读更多 →
机器人开发工程化实战:从ROS2核心技能到商业化落地避坑指南

机器人开发工程化实战:从ROS2核心技能到商业化落地避坑指南

如果你是一名机器人开发者,或者正在考虑进入这个领域,最近可能被各种展会、新品和融资新闻刷屏。但热闹背后,我们真正需要关心的是什么?是那些炫酷的Demo,还是能真正落地、解决实际问题的技术? 最近&#…

2026/11/16 3:38:04 阅读更多 →
被低估的论文神器[特殊字符]不止查重降重!Paperxie隐藏功能全解锁

被低估的论文神器[特殊字符]不止查重降重!Paperxie隐藏功能全解锁

很多人对Paperxie的认知,只停留在「免费查重、好用降重」这两个基础功能上,真的太浪费这款全能神器了!! 在实测过数十款AI论文工具后,我发现绝大多数平台功能单一、套路满满,要么只能简单写作,…

2026/11/16 3:38:15 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻