USB 摄像头 → 群晖 Surveillance Station（mjpg-streamer 版）

日期：2025-10-04

目标：1080p30 硬件 MJPEG + BASIC 认证 + systemd 值守 + 群晖接入

1️⃣ 环境确认（必须记录）

# 1. 查看摄像头节点与能力（一次性）

v4l2-ctl --list-devices

v4l2-ctl -d /dev/video10 --list-formats-ext

记录：确认 MJPEG 格式存在且支持 1920×1080 @ 30 fps

[0]: 'MJPG' (Motion-JPEG, compressed)

    Size: Discrete 1920x1080

        Interval: Discrete 0.033s (30.000 fps)

2️⃣ 手动跑通（验证用）

cd /opt/mjpg-streamer

./mjpg_streamer \

  -i "/opt/mjpg-streamer/input_uvc.so -d /dev/video10 -r 1920x1080 -f 30" \

  -o "/opt/mjpg-streamer/output_http.so -p 2345 -w ./www -c admin:demo123456"

浏览器验证：

http://<设备IP>:2345/?action=stream  → 输入 admin / demo123456

3️⃣ systemd 服务文件（完整内容）

保存为 /etc/systemd/system/mjpg-streamer.service：

[Unit]

Description=MJPG-Streamer 1080p30 USB Camera

After=network.target

[Service]

Type=simple

WorkingDirectory=/opt/mjpg-streamer

ExecStart=/opt/mjpg-streamer/mjpg_streamer \

          -i "/opt/mjpg-streamer/input_uvc.so -d /dev/video10 -r 1920x1080 -f 30" \

          -o "/opt/mjpg-streamer/output_http.so -p 2345 -w ./www -c admin:demo123456"

Restart=always

RestartSec=5

User=root

[Install]

WantedBy=multi-user.target

4️⃣ 启用 & 启动

sudo systemctl daemon-reload

sudo systemctl enable --now mjpg-streamer.service

5️⃣ 状态 & 日志

sudo systemctl status mjpg-streamer.service

sudo journalctl -u mjpg-streamer.service -n 30 --no-pager

6️⃣ 群晖 Surveillance Station 接入

| 字段 | 值 |

| --- | --- |

| 品牌 | 用户自定义 |

| 类型 | MJPEG HTTP |

| URL | http://<设备IP>:2345/?action=stream |

| 用户名 | admin |

| 密码 | demo123456 |

测试 → 绿色 ✅ → 完成

7️⃣ 运维速查

| 目的 | 指令 |

| ---- | ----------------------------------------------------------- |

| 重启服务 | sudo systemctl restart mjpg-streamer.service |

| 停止服务 | sudo systemctl stop mjpg-streamer.service |

| 取消自启 | sudo systemctl disable mjpg-streamer.service |

| 查看日志 | sudo journalctl -u mjpg-streamer.service -n 50 --no-pager |

| 回滚配置 | sudo systemctl revert mjpg-streamer.service |

8️⃣ 一键备份 / 恢复

备份：

sudo tar -czf ~/mjpg-streamer-1080p30.tar.gz \

  /opt/mjpg-streamer /etc/systemd/system/mjpg-streamer.service

恢复：

sudo tar -xzpf ~/mjpg-streamer-1080p30.tar.gz -C /

sudo systemctl daemon-reload

sudo systemctl enable --now mjpg-streamer.service

✅ 交付状态：1080p30 硬件 MJPEG + BASIC 认证 + systemd 值守 + 群晖测试通过

复制本手册即可在任意新机器一键复现。