RK3588 + Docker + GStreamer 实现 RTSP 推流（MJPEG AVI → H.264），VLC 成功拉流

【实战踩坑全记录】RK3588 + Docker + GStreamer 实现 RTSP 推流（MJPEG AVI → H.264），VLC 成功拉流

关键词：RK3588、Docker、GStreamer、RTSP、VLC、MJPEG、x264、gst-rtsp-server

适用人群：嵌入式 / AI 板卡 / 音视频 / 视觉工程师

一句话总结：

👉 在 RK3588 板子 Docker 容器内，把一个 MJPEG 编码的 AVI 视频文件，稳定推成 RTSP 流，并在笔记本 VLC 一条 URL 成功拉流播放。

一、背景与目标

在实际工程中，我们经常遇到如下需求：

板子（RK3588）端已有算法输出视频文件（AVI / MP4）

希望通过 RTSP 推流给上位机 / VLC / NVR / 控制台查看

程序运行在 Docker 容器中

希望做到：

一条 RTSP URL，VLC 直接打开即可播放

本篇文章完整记录了从 0 到 1 的全过程，包括：

Docker 网络与目录挂载

GStreamer 工具缺失的真实踩坑

MJPEG 视频格式误判

RTSP Server 工具缺失

最终手写 RTSP Server 程序的工程解法

二、实验环境说明

1️⃣ 硬件 / 网络

RK3588 开发板

板子 IP：192.168.150.1

笔记本 IP：192.168.150.78

二者在同一网段

2️⃣ 软件环境

Ubuntu 22.04（jammy，arm64）

Docker（host 网络模式）

GStreamer 1.20.x

VLC（笔记本端）

3️⃣ 输入视频

/root/zht_docker/result_yolov8123.avi

三、Docker 启动方式（非常关键）

强烈建议新手直接使用 host 网络模式

docker run -it --rm

--name rk3588_rtsp

--net=host

-v /root/zht_docker:/root/zht_docker

-w /root/zht_docker

your_image:latest

bash

为什么必须 --net=host？

RTSP 走 TCP（默认 8554 / 554）

避免 Docker 端口映射、iptables、NAT 等复杂问题

先把链路跑通，再谈安全与隔离

四、第一个坑：gst-discoverer-1.0 命令不存在

现象

gst-discoverer-1.0 result_yolov8123.avi

报错：

command not found

错误直觉（90% 新手会踩）

以为装了：

gstreamer1.0-tools

就一定有 gst-discoverer-1.0。

错。

正确排查方式（工程级）

apt-file update

apt-file search -x '/gst-discoverer-1.0$'

输出：

gstreamer1.0-plugins-base-apps

正确安装

apt install -y gstreamer1.0-plugins-base-apps

五、关键一步：确认视频真实编码格式

gst-discoverer-1.0 result_yolov8123.avi

核心输出：

Container: AVI

Video: JPEG

Resolution: 960x544

Framerate: 30 fps

⚠️ 重要结论

这是 MJPEG（Motion-JPEG）视频，不是 H.264 / H.265

这一步如果不做，后面推流必失败。

六、第二个大坑：RTSP Server 工具不存在

常见误区

apt install gstreamer1.0-rtsp

which test-launch

结果：没有 test-launch

原因分析（很重要）

gstreamer1.0-rtsp ≠ RTSP Server 程序

在 Ubuntu 22.04 + arm64 下：

示例程序 test-launch 不一定以二进制形式提供

工程上最稳解法：自己写 RTSP Server

七、终极解法：手写一个最小 RTSP Server（推荐）

1️⃣ 安装开发依赖

apt install -y

build-essential

pkg-config

libgstrtspserver-1.0-dev

确认头文件存在：

ls /usr/include/gstreamer-1.0/gst/rtsp-server/rtsp-server.h

2️⃣ 编写 RTSP Server 程序

创建文件 my_rtsp_server.c：

#include <gst/gst.h>

#include <gst/rtsp-server/rtsp-server.h>

int main(int argc, char *argv[]) {

gst_init(&argc, &argv);

复制代码

const gchar *pipeline =
    "( filesrc location=/root/zht_docker/result_yolov8123.avi "
    "! avidemux "
    "! jpegdec "
    "! videoconvert "
    "! x264enc tune=zerolatency speed-preset=veryfast bitrate=4000 key-int-max=30 "
    "! rtph264pay name=pay0 pt=96 config-interval=1 )";

GstRTSPServer *server = gst_rtsp_server_new();
gst_rtsp_server_set_service(server, "8554");

GstRTSPMountPoints *mounts = gst_rtsp_server_get_mount_points(server);
GstRTSPMediaFactory *factory = gst_rtsp_media_factory_new();
gst_rtsp_media_factory_set_launch(factory, pipeline);
gst_rtsp_media_factory_set_shared(factory, TRUE);

gst_rtsp_mount_points_add_factory(mounts, "/test", factory);
g_object_unref(mounts);

gst_rtsp_server_attach(server, NULL);

g_print("RTSP stream ready at rtsp://0.0.0.0:8554/test\n");
GMainLoop *loop = g_main_loop_new(NULL, FALSE);
g_main_loop_run(loop);

}

3️⃣ 编译

gcc my_rtsp_server.c -o my_rtsp_server

$(pkg-config --cflags --libs gstreamer-1.0 gstreamer-rtsp-server-1.0)

4️⃣ 启动推流（板子端）

./my_rtsp_server

输出：

RTSP stream ready at rtsp://0.0.0.0:8554/test

八、笔记本 VLC 拉流（最终验证）

在 VLC 中：

媒体 → 打开网络串流

输入：

rtsp://192.168.150.1:8554/test

🎉 画面成功显示

九、完整踩坑总结（强烈建议收藏）

✅ 技术经验沉淀

不要猜包名，用 apt-file search

先确认视频真实编码，再设计 pipeline

MJPEG ≠ H.264，必须解码再编码

RTSP 示例工具不可靠，自己写 Server 最稳

host 网络模式是新手成功率最高的方案

十、后续可优化方向（进阶）

使用 RK3588 MPP 硬编码替换 x264enc

降低 RTSP 延迟（<200ms）

Docker 启动即推流（entrypoint）

文件源 → 摄像头 → appsrc → 实时推流