安装部署

系统要求

运行环境

项目	要求
操作系统	Linux（推荐）、macOS
CPU 架构	x86_64、aarch64
内存	视并发规模而定，建议 1GB 起
磁盘	运行时视录制需求而定

下载预编译二进制

集中入口（表格与 bin / beta 路径说明）：下载。

可以通过下载域名直接获取 CI 发布产物（与 Release 工作流一致）：

# Linux amd64
wget https://download.m7s.live/bin/monibuca_v6_linux_amd64.tar.gz
tar -xzf monibuca_v6_linux_amd64.tar.gz
chmod +x monibuca_linux_amd64
./monibuca_linux_amd64 -c config.yaml

# Linux arm64
wget https://download.m7s.live/bin/monibuca_v6_linux_arm64.tar.gz

支持的平台：

• linux/amd64
• linux/arm64

下载前端 ZIP 资源（Admin + Demo）

CI 也会发布以下前端包，可直接放在服务器工作目录，由 Monibuca 自身 HTTP 服务托管：

• https://download.m7s.live/bin/admin.zip
• https://download.m7s.live/bin/demo-live-room.zip
• https://download.m7s.live/bin/demo-meeting-room.zip
• https://download.m7s.live/bin/demo-customer-service.zip

wget https://download.m7s.live/bin/admin.zip
wget https://download.m7s.live/bin/demo-live-room.zip
wget https://download.m7s.live/bin/demo-meeting-room.zip
wget https://download.m7s.live/bin/demo-customer-service.zip

启动后可访问：

• http://<host>:8180/admin
• http://<host>:8180/demo/live-room
• http://<host>:8180/demo/meeting-room
• http://<host>:8180/demo/customer-service

产物路径规则

Release CI 将文件上传到 download.m7s.live/<dest>/，正式版本默认 dest=bin，beta 版本为 dest=beta。
例如 beta 版本可从 https://download.m7s.live/beta/ 下载对应文件。

Docker 部署

使用预构建镜像

# 完整版（包含 FFmpeg）
docker pull langhuihui/monibuca:v6

# 轻量版（不含 FFmpeg，基于 Alpine）
docker pull monibuca/v6:latest

运行容器

docker run -d \
  --name monibuca \
  -p 8180:8180 \
  -p 8443:8443 \
  -p 1935:1935 \
  -p 8554:8554 \
  -p 50051:50051 \
  -p 6000:6000/udp \
  -p 9000-9100:9000-9100/udp \
  -v $(pwd)/config.yaml:/etc/monibuca/config.yaml \
  langhuihui/monibuca:v6

容器镜像已内置以下静态资源 ZIP（与 CI 产物一致）：

• admin.zip
• demo-live-room.zip
• demo-meeting-room.zip
• demo-customer-service.zip

端口说明

端口	协议	说明
8180	TCP	HTTP 服务（API、FLV、HLS、WebRTC、管理面板）
8443	TCP	HTTPS 服务
1935	TCP	RTMP
8554	TCP	RTSP
6000	UDP	SRT
9000-9100	UDP	WebRTC 媒体端口
50051	TCP	gRPC

Docker Compose

docker-compose.yml

services:
  monibuca:
    image: langhuihui/monibuca:v6
    ports:
      - "8180:8180"
      - "8443:8443"
      - "1935:1935"
      - "8554:8554"
      - "50051:50051"
      - "6000:6000/udp"
      - "9000-9100:9000-9100/udp"
    volumes:
      - ./config.yaml:/etc/monibuca/config.yaml
      - ./data:/monibuca/data
    environment:
      - M7S_GLOBAL_LOGLEVEL=info
    restart: unless-stopped

验证安装

启动后，访问以下地址验证服务是否正常运行：

# HTTP API
curl http://localhost:8180/api/summary

# 管理面板（浏览器打开）
# http://localhost:8180/admin

# Live Room Demo
# http://localhost:8180/demo/live-room

插件开发

Monibuca 提供了独立的 monibuca-sdk crate，你可以基于 SDK 开发自定义插件，然后以动态加载或 WASM 沙箱模式运行。

详细的插件开发指南请参阅 插件开发。

---

安装完成？继续阅读 快速上手 了解基本使用方法。