对接小米摄像头 RTSP 完整笔记
go2rtc 对接小米摄像头 RTSP 完整笔记
用途:从小米/创米摄像头获取官方 RTSP 流,无需改固件、无需开权限
适用:NVR 录像 · HomeKit · Frigate 识别 · 群晖 Surveillance Station · 内网播放器
版本:v1.0 · 2026-07-30
一、架构图
小米摄像头 ←→ go2rtc ←→ RTSP 流
↓
┌──────┬──────┬──────┬────────┐
NVR HomeKit Frigate 群晖SS 播放器
二、docker-compose.yml
services:
go2rtc:
container_name: go2rtc
image: alexxit/go2rtc:master-hardware
restart: always
network_mode: host # 直接宿主机网络
privileged: true # 硬件解码需要
environment:
- TZ=Asia/Shanghai
volumes:
- ./config:/config # 配置文件映射
docker-compose up -d
三、go2rtc.yaml(核心配置)
3.1 小米授权 Token
# 从小米工具获取的账号授权
xiaomi:
"256723528": "V1:pwROAesIuzM...(加密串)"
3.2 视频流定义
streams:
micam1:
- xiaomi://256723528:cn@192.168.4.15?did=451909299&model=chuangmi.camera.029a02&subtype=hd
# 可选:H265 → H264 转码(兼容 HomeKit 等不支持 H265 的设备)
micam1_h264:
- ffmpeg:micam1#video=h264#width=1280#height=720#hardware#raw=-r 15
四、访问地址
| 用途 | 地址 | 端口 |
|---|---|---|
| 🌐 Web 管理后台 | http://192.168.4.4:1984/ |
1984 |
| 📡 RTSP 主流 | rtsp://192.168.4.4:8554/micam1 |
8554 |
| 📡 RTSP 转码流 | rtsp://192.168.4.4:8554/micam1_h264 |
8554 |
| 🔗 原始小米协议 | xiaomi://256723528:cn@192.168.4.15?... |
— |
五、局域网扫描(找摄像头 IP)
# Fedora 安装
sudo dnf install arp-scan -y
# 扫描局域网所有设备
sudo arp-scan --localnet
# 输出示例
192.168.4.15 xx:xx:xx:xx:xx:xx Xiaomi Communications
六、群晖 Surveillance Station 接入
# 群晖后台 → Surveillance Station
# → 添加摄像头 → 选择 RTSP 网络摄像头
# → 填入:
# 路径:rtsp://192.168.4.4:8554/micam1
# 品牌:自定义
# 型号:RTSP
七、关键参数说明
| 参数 | 说明 |
|---|---|
xiaomi: |
小米账号授权串(必须从小米工具获取) |
256723528 |
小米账号 ID |
cn |
地区代码,cn = 中国大陆 |
192.168.4.15 |
摄像头本地局域网 IP |
did=451909299 |
摄像头设备 ID |
model=chuangmi.camera.029a02 |
摄像头型号 |
subtype=hd |
清晰度:hd 高清 / sd 标清 |
1984 |
go2rtc Web 管理端口 |
8554 |
RTSP 推流端口 |
八、完整工作流程
flowchart LR
A[小米工具获取凭证] --> B[填入 go2rtc.yaml]
B --> C[docker-compose up -d]
C --> D[打开 Web 后台 1984]
D --> E{出流?}
E -->|✅ 正常| F[接入 NVR/群晖/HomeKit]
E -->|❌ 无流| G[检查 IP/Token/网络]
G --> C
文字版
① 小米工具获取 → 小米ID + 加密串 + did + model
② 填入 go2rtc.yaml 的 xiaomi: 和 streams: 字段
③ docker-compose up -d 启动容器
④ 打开 http://IP:1984 检查流状态
⑤ 正常出流 → RTSP 地址接入各系统
九、命令速查
| 命令 | 作用 |
|---|---|
docker-compose up -d |
启动 go2rtc |
docker-compose down |
停止 go2rtc |
docker-compose logs -f |
查看实时日志 |
sudo arp-scan --localnet |
局域网扫描找摄像头 IP |
ffplay rtsp://IP:8554/micam1 |
VLC/ffplay 测试播放 |
📎 关联: [[handbrake-output-naming-standards]] · [[go2rtc-xiaomi-camera-rtsp-config]]
🐳 Docker 多媒体合集 · 🐧 Linux-Knowledge-Base
— Hermes Agent · 2026-07-30

浙公网安备 33010602011771号