Monibuca v6 Architecture

High-Performance Streaming Media Server — Rust + Workspace Crates

EXTERNAL CLIENTS Browser (Web SDK) Mobile App FFmpeg / OBS IoT Device GB28181 Camera Admin Panel INFRASTRUCTURE LAYER (src/) HTTP Server gRPC Server Database Config (Unified) Event System FFmpeg Mgr Network/QUIC User System Admin UI Auth / JWT License * * License: optional activation feature HTTP Surfaces: V5Compat /api · V6 /v6/api · ZEGO /zego/api → AppFacade ENGINE BUILT-IN SERVICES Stream Manager (Publisher / Subscriber / Track / RingBuffer) Plugin Manager (IoC / EngineContext / Dynamic Load) Room Service (Live / Meeting / WebSocket) Task System (Work hierarchy / Cancel) Core Adapters (Publisher/Subscriber/StreamMgr) FEATURE PLUGIN CRATES (plugins/) — 26 independent crates Protocol: RTMP RTSP FLV HLS WebRTC SRT WebTransport GB28181 ONVIF Media: MP4 Snap SEI Mix Transcode Crypto Utility: Debug LogRotate Report Crontab Test Cluster Device: HomeKit V4L2 ALSA Room Ext: Live Meeting monibuca-sdk (Plugin SDK Crate) + sdk-macros Plugin trait EngineContext HTTP SDK EventBus Proxy Manager Transform / Playback DatabaseApi ServiceRegistry CollectionApi ReportingApi Config Trait Room Ext API Config Framework Crates config-framework config-macros #[derive(ConfigSchema)] for plugin configs codec (Foundation Crate — zero internal deps) Types/Enums Trait Interfaces AVFrame / OnceLock NALU / SPS Parse RTP PS Demux/Mux Audio Codecs Video Codecs Error Types Transcode PublisherApi | SubscriberApi | StreamManagerApi | FrameRef | TrackHandle | Demuxer | Muxer Dependency direction ↓ CRATE DEPENDENCY GRAPH codec monibuca-sdk plugins/xxx (x26) monibuca (engine + room) config-framework codec: 0 deps on internal crates (foundation) sdk: depends on codec (alias codec_crate) + sdk-macros + config-framework plugins: depend on sdk + codec + config-framework + config-macros engine: depends on sdk + codec + config-framework + all optional plugins Room: engine built-in service (src/room/), not a plugin crate EngineContext: 10 optional capabilities via Arc<dyn Trait> injection
External Clients
Infrastructure
Engine Built-in
Plugin Crates (26)
SDK Crate
Codec Crate
Config Framework

Monibuca v6 — 26 independent plugin crates | 5 foundation crates (codec, sdk, sdk-macros, config-framework, config-macros) | Room as engine built-in service

Architecture Notes

HTTP API Surfaces

Management HTTP APIs are organized as surfaces that share one AppFacade application layer. Each surface handles path parsing, auth hooks, and response serialization; business logic lives in AppFacade and delegates to StreamManager and plugin services.

Surfaces are registered centrally in src/server/http_plugins/register.rs via register_http_plugins(). Legacy clients keep /api/*; new integrations should prefer /v6/api/*.