rtp2httpd 是一个多媒体流转发服务器。本项目是 oskar456/rtp2httpd 的完全重构版本，在原项目基础上加入了许多新功能，专为中国大陆 IPTV 环境设计。
rtp2httpd 支持将组播 RTP/UDP 流、RTSP 流转换为 HTTP 单播流，并实现了运营商级的 FCC（Fast Channel Change）快速换台协议，为 IPTV 用户提供接近原生机顶盒的观看体验。
- 组播 RTP 转单播 HTTP：将组播 RTP/UDP 流转换为标准 HTTP 流
- 原始 UDP 流转发：支持非 RTP 封装的 UDP 流直接转发
- RTSP 转 HTTP 视频流：完整支持 RTSP/RTP 协议栈，包括 TCP 和 UDP 传输模式
- 可以实现 IPTV RTSP 时移源的回看
- 可以把家庭摄像机的 RTSP 流转换为 HTTP 流，方便在 IPTV 播放器中观看
- UDPxy 兼容性：完全兼容 UDPxy URL 格式，可无缝替换
- 频道快照：支持通过 HTTP 请求快速获取频道的快照图片，降低播放端解码压力
- 运营商级 FCC 协议：实现毫秒级换台响应，媲美原生 IPTV 机顶盒
- 智能流缓存：预加载关键帧，确保换台时立即提供可解码视频流
- NAT 穿透支持：支持 NAT-PMP 和打洞技术，适应复杂网络环境
- Web 状态页面：通过浏览器访问
/status查看实时运行状态 - 客户端连接统计：显示每个连接的 IP、状态、带宽使用、传输数据量
- 系统日志查看：实时查看服务器日志，支持动态调整日志级别
- 远程管理功能：通过 Web 界面强制断开客户端连接
- 非阻塞 IO 模型：使用 epoll 事件驱动，高效处理大量并发连接
- MSG_ZEROCOPY 零拷贝技术：使用 Linux 内核 MSG_ZEROCOPY 特性，避免数据在用户态和内核态之间的拷贝
- 多核优化：支持多 worker 进程，充分利用多核 CPU 提高最大吞吐量（默认单 worker，可配置）
- 智能批量发送：自动积攒小包后批量发送，减少系统调用开销 90%，同时兼顾低延时
- Buffer Pool 管理：预分配缓冲池，避免频繁内存分配，内存总用量可控
- 高并发支持：单个 worker 可支持 100+ 并发流媒体客户端
Untitled.mov
提示：建议搭配专门针对 IPTV 直播优化的播放器使用，例如 APTV / TiviMate / Cloud Stream 等。
IMG_4082.MOV
单流码率 8 Mbps。总仅占用 25% CPU 单核 (i3-N305)，消耗 4MB 内存。
OpenWrt 是 rtp2httpd 的最佳运行环境。在完成 IPTV 网络融合后（可以搜索教程 OpenWrt IPTV 融合），通过 DHCP 获取到 IPTV 内网 IP，可直接访问整个 IPTV 网络，无需 NAT 穿透。
本项目支持的最低 OpenWrt 版本为 21.02，在更低版本上 LuCI 配置界面可能无法加载，但通过手动编辑 /etc/config/rtp2httpd 文件并运行 /etc/init.d/rtp2httpd restart 仍然可以使用。
支持的最低 Linux 内核版本为 4.14，因为依赖 MSG_ZEROCOPY 特性，低于此版本将无法运行。
使用一键安装脚本自动下载并安装最新版本：
curl -fsSL https://raw.githubusercontent.com/stackia/rtp2httpd/main/openwrt-support/install.sh | sh脚本会自动：
- 检测设备的 CPU 架构
- 从 GitHub Release 获取最新版本
- 下载并安装所有必需的软件包（主程序 + LuCI 界面 + 语言包）
如果无法使用一键脚本，可以手动在 Releases 页面下载对应架构的软件包：
rtp2httpd_x.y.z-1_<arch>.ipk- 主程序包luci-app-rtp2httpd_x.y.z_all.ipk- LuCI Web 界面luci-i18n-rtp2httpd-en_x.y.z_all.ipk- 英文语言包luci-i18n-rtp2httpd-zh-cn_x.y.z_all.ipk- 中文语言包
opkg install rtp2httpd_*.ipk luci-app-rtp2httpd_*.ipk luci-i18n-rtp2httpd-*.ipk安装完成后，在 LuCI 管理界面的 "服务" 菜单中找到 "rtp2httpd" 进行配置：
可以在 "状态" -> "系统日志" 查看日志。或者 ssh 手动运行 logread -e rtp2httpd 查看日志。
从 Releases 页面下载对应架构的静态二进制文件 rtp2httpd-<版本号>-<架构>，上传到设备并 chmod +x 后即可运行。
默认从 /etc/rtp2httpd.conf 读取配置文件。可用 --config 或 --noconfig 参数覆盖。
适用于支持 Docker 的设备。必须使用 host 网络模式以接收组播流。
--ulimit memlock=-1:-1 参数
rtp2httpd 使用 MSG_ZEROCOPY 技术需要锁定内存页。Docker 容器默认的 locked memory 限制（64KB）太小，会导致 ENOBUFS 错误，表现为：
- 客户端无法播放
- 服务端 buffer pool 疯狂增长
- 统计数字中的 ENOBUFS 错误飙升
正确的启动方式：
docker run --network=host --ulimit memlock=-1:-1 --rm \
ghcr.io/stackia/rtp2httpd:latest \
--noconfig --verbose 2 --listen 5140 --maxclients 20使用 docker-compose：
services:
rtp2httpd:
image: ghcr.io/stackia/rtp2httpd:latest
network_mode: host
ulimits:
memlock:
soft: -1
hard: -1
command: --noconfig --verbose 2 --listen 5140 --maxclients 20# 安装依赖（Ubuntu/Debian）
sudo apt-get install build-essential autoconf automake pkg-config
# 编译安装
autoreconf -fi
./configure --enable-optimization=-O3
make
sudo make installrtp2httpd 支持多种流媒体协议，通过不同的 URL 前缀进行区分：
http://服务器地址:端口/rtp/组播地址:端口[?fcc=FCC服务器:端口]示例：
http://192.168.1.1:5140/rtp/239.253.64.120:5140
http://192.168.1.1:5140/rtp/239.253.64.120:5140?fcc=10.255.14.152:15970http://服务器地址:端口/rtsp/RTSP服务器:端口/路径[?参数][&playseek=时间范围]示例：
http://192.168.1.1:5140/rtsp/192.168.1.100:554/live/stream1
http://192.168.1.1:5140/rtsp/camera.local:554/h264/ch1/main/av_stream?playseek=20240101120000-20240101130000playseek 参数格式：
playseek 参数用于指定时移回看的时间范围，支持多种时间格式：
-
yyyyMMddHHmmss 格式（14 位数字）
- 示例：
playseek=20240101120000-20240101130000 - 表示从 2024 年 1 月 1 日 12:00:00 到 13:00:00
- 会根据 User-Agent 中的时区信息自动转换为 UTC
- 示例：
-
Unix 时间戳格式（10 位以内数字）
- 示例：
playseek=1704096000-1704099600 - 直接使用 Unix 时间戳（秒）
- 已经是 UTC 时间，无需时区转换
- 示例：
-
时间范围格式
开始时间-结束时间：指定时间段开始时间-：从指定时间开始到当前（开放式范围）开始时间：等同于开始时间-
rtp2httpd 在处理 RTSP 时移回看功能时，会根据 HTTP 请求中的 User-Agent 头自动识别客户端时区，确保时间参数正确转换。
时区设置只影响 RTSP 时移回看功能，对直播流无影响。
时区识别机制：
- 服务器会解析 User-Agent 中的
TZ/标记来获取客户端时区信息 - 支持的时区格式：
TZ/UTC+8- UTC 偏移格式（东八区）TZ/UTC-5- UTC 偏移格式（西五区）TZ/UTC- 标准 UTC 时区
- 如果 User-Agent 中没有时区信息，默认使用 UTC 时区
使用场景：
当使用 playseek 参数进行时移回看时：
- yyyyMMddHHmmss 格式：客户端可以使用本地时区的时间格式（如
20240101120000），服务器会根据 User-Agent 中的时区信息自动转换为 UTC 时间，然后在 RTSP DESCRIBE 请求中将转换后的 UTC 时间作为playseek查询参数附加到 URL 上（保持 yyyyMMddHHmmss 格式） - Unix 时间戳格式：直接使用 UTC 时间戳，无需时区转换，服务器会直接在 RTSP DESCRIBE 请求中将时间戳作为
playseek查询参数附加到 URL 上（保持时间戳格式）
示例：
# 示例 1: 使用 yyyyMMddHHmmss 格式 + 时区
# 客户端在东八区（UTC+8），User-Agent 包含 TZ/UTC+8
# 请求 2024年1月1日 12:00:00（本地时间）的视频
curl -H "User-Agent: MyPlayer/1.0 TZ/UTC+8" \
"http://192.168.1.1:5140/rtsp/camera.local:554/stream?playseek=20240101120000-20240101130000"
# 服务器会自动将本地时间转换为 UTC 时间（04:00:00）
# RTSP DESCRIBE 请求: DESCRIBE rtsp://camera.local:554/stream?playseek=20240101040000-20240101050000
# 示例 2: 使用 Unix 时间戳格式（无需时区）
# 请求 2024年1月1日 04:00:00 UTC 到 05:00:00 UTC 的视频
curl "http://192.168.1.1:5140/rtsp/camera.local:554/stream?playseek=1704085200-1704088800"
# Unix 时间戳已经是 UTC 时间，直接附加到 RTSP URL
# RTSP DESCRIBE 请求: DESCRIBE rtsp://camera.local:554/stream?playseek=1704085200-1704088800rtp2httpd [选项]
网络配置：
-l, --listen [地址:]端口 绑定监听地址和端口 (默认: *:5140)
-m, --maxclients <数量> 最大并发客户端数 (默认: 5)
-w, --workers <数量> 工作进程数 (默认: 1)
--upstream-interface-unicast <接口> 用于单播流量 (FCC/RTSP) 的上游网络接口
--upstream-interface-multicast <接口> 用于组播流量 (RTP/UDP) 的上游网络接口
性能优化：
-b, --buffer-pool-max-size <数量> 零拷贝缓冲池最大缓冲区数量 (默认: 16384)
每个缓冲区 1536 字节，16384 个约占用 24MB 内存
增大此值以提高多客户端并发时的吞吐量
FCC 快速换台：
-n, --fcc-nat-traversal <0/1/2> FCC NAT 穿透模式
0=禁用, 1=打洞 (已废弃，不要用), 2=NAT-PMP (默认: 0)
服务控制：
-d, --daemon 后台守护进程模式
-D, --nodaemon 前台运行模式 (默认)
-c, --config <文件> 指定配置文件路径
-C, --noconfig 不读取配置文件
日志控制：
-v, --verbose 增加日志详细程度
-q, --quiet 仅显示致命错误
安全控制：
-H, --hostname <主机名> 检查 HTTP Host 头的主机名
-T, --r2h-token <令牌> HTTP 请求认证令牌 (所有请求必须携带 r2h-token 查询参数)
兼容性：
-U, --noudpxy 禁用 UDPxy 兼容模式 (禁用后只能使用 config 文件中定义的 URL)
其他：
-S, --video-snapshot 启用视频快照功能 (默认: 关闭)
-F, --ffmpeg-path <路径> FFmpeg 可执行文件路径 (默认: ffmpeg)
-A, --ffmpeg-args <参数> FFmpeg 额外参数 (默认: -hwaccel none)
-h, --help 显示帮助信息配置文件路径：/etc/rtp2httpd.conf
[global]
# 日志详细程度: 0=致命错误 1=错误 2=警告 3=信息 4=调试
verbosity = 3
# 最大并发客户端数
maxclients = 20
# 是否后台运行
daemonise = no
# UDPxy 兼容性
udpxy = yes
# FCC NAT 穿透模式
fcc-nat-traversal = 0
# HTTP 请求认证令牌（可选，默认: 无）
# 设置后，所有 HTTP 请求必须携带 r2h-token 查询参数，且值与此配置匹配
# 例如: http://server:5140/service?r2h-token=your-secret-token
;r2h-token = your-secret-token-here
# 上游网络接口 (可选)
# 用于单播流量 (FCC/RTSP) 的接口
;upstream-interface-unicast = eth1
# 用于组播流量 (RTP/UDP) 的接口
;upstream-interface-multicast = eth0
# 组播周期性重新加入间隔（秒，默认: 0 禁用）
# 设置为正值（如 150）以周期性重新加入组播组
# 这是针对以下网络环境的兼容性解决方案：
# - 启用 IGMP snooping 的交换机在没有路由器 IGMP Query 时超时
# - 配置不当的网络设备会丢弃组播成员关系
# 推荐值: 120-180 秒（小于典型交换机超时 260 秒）
# 仅在遇到组播流中断时启用
;mcast-rejoin-interval = 0
# 工作进程数（默认: 1）
workers = 1
# 零拷贝缓冲池最大缓冲区数量（默认: 16384）
# 每个缓冲区 1536 字节，16384 个约占用 24MB 内存
# 增大此值以提高多客户端并发时的吞吐量，例如设置为 32768 或更高
buffer-pool-max-size = 16384
# 启用视频快照功能（默认: no）
# 启用后可通过 `snapshot=1` 查询参数获取视频流的实时快照
;video-snapshot = no
# FFmpeg 可执行文件路径（默认: ffmpeg，使用系统 PATH）
# 如果 ffmpeg 不在 PATH 中或想使用特定版本，请指定完整路径
;ffmpeg-path = /usr/bin/ffmpeg
# FFmpeg 额外参数（默认: -hwaccel none）
# 这些参数在生成快照时传递给 ffmpeg
# 常用选项: -hwaccel none, -hwaccel auto, -hwaccel vaapi, -hwaccel qsv
;ffmpeg-args = -hwaccel none
[bind]
# 绑定地址和端口
* 5140
192.168.1.1 8081
[services]
# 预定义服务 (可选)
# 格式:
# RTP/UDP 流: 服务名 MRTP 组播地址 端口
# RAW UDP 流: 服务名 MUDP 组播地址 端口
# RTSP 流: 服务名 RTSP RTSP_URL
# 类型: MRTP(RTP 流) MUDP(UDP 流) RTSP(RTSP 流)
cctv1 MRTP 239.253.64.120 5140
cctv2 MRTP 239.253.64.121 5140
rtsp1 RTSP rtsp://192.168.1.100:554/stream1
rtsp2 RTSP rtsp://10.0.0.50:8554/live/channel1?auth=token123可以 先看看这里，也许有网友分享过当地的 FCC 服务器地址。否则就需要从 IPTV 机顶盒抓包获取。
- 抓包方法：使用 Wireshark 等工具抓取当地机顶盒网络包
- 关键字段：查找
ChannelFCCIP和ChannelFCCPort字段
如果 rtp2httpd 并非直接运行在路由器上，而是运行在局域网内其他设备（例如 NAS、PC 等），则需要启用 NAT 穿透功能以确保 FCC 正常工作。
不使用 FCC 则不受影响。
运行在局域网内设备时，要求上级路由器启用全追锥形 NAT，并转发 IGMP 组播流（可以使用 igmpproxy / omcproxy 等组播代理工具）。如遇不可播放请尝试不同的 --fcc-nat-traversal 参数。
rtp2httpd 支持使用 FFmpeg 来生成视频流的快照 (snapshot) 功能。如果播放器集成了此功能，将会获得极快的频道预览图的加载速度。
这个功能默认是关闭的，需要通过 --video-snapshot 选项开启。
请求视频 JPEG 快照有两种方式，任选一种即可：
- 在 HTTP URL 加上查询参数
snapshot=1 - 请求 Header 加上
Accept: image/jpeg
当 rtp2httpd 处理快照请求时，会从视频流中截取关键帧 (I 帧) 并使用 FFmpeg 转码为 JPEG 格式返回给客户端。在未开启 --video-snapshot 时，快照请求将正常返回普通媒体流数据。
在搭配 FCC 使用时，通常在 0.3 秒内即可返回快照。在不使用 FCC 时，由于大多数运营商组播流是每秒发送一个 I 帧，因此快照请求最长会在 1 秒返回。
不要使用 OpenWrt 官方源的 ffmpeg 包，它阉割了 h264 / hevc 编解码器，将导致无法解码视频流。
最简易得获得 FFmpeg 的方法是从 https://johnvansickle.com/ffmpeg/ 下载静态编译的可执行文件（但这个版本并非支持所有硬件加速）。
你可以通过以下参数自定义 FFmpeg 的行为：
ffmpeg-path：指定 FFmpeg 可执行文件的路径
- 默认值：
ffmpeg（使用系统 PATH 中的 ffmpeg） - 使用场景：
- FFmpeg 不在系统 PATH 中
- 需要使用特定版本的 FFmpeg
- 使用自定义编译的 FFmpeg
ffmpeg-args：指定传递给 FFmpeg 的额外参数
- 默认值：
-hwaccel none（禁用硬件加速） - 常用选项：
-hwaccel none：禁用硬件加速（兼容性最好）-hwaccel vaapi：使用 VA-API 硬件加速（Intel GPU）- 针对 Intel GPU 的预编译 FFmpeg：stackia#37
-hwaccel v4l2m2m：使用 V4L2 硬件加速（多见于一些嵌入式 SoC）
在一些不支持硬件解码、CPU 规格较低的设备上，访问快照可能会产生很大的 CPU 占用。
配置示例：
# 使用特定路径的 FFmpeg 并启用硬件加速
rtp2httpd --video-snapshot --ffmpeg-path /opt/ffmpeg/bin/ffmpeg --ffmpeg-args "-hwaccel vaapi"
# 在配置文件中设置
# /etc/rtp2httpd.conf
video-snapshot = yes
ffmpeg-path = /usr/local/bin/ffmpeg
ffmpeg-args = -hwaccel auto建议修改内核参数，开启 BBR 后可以进一步降低换台延迟。
# 安装开发依赖
sudo apt-get install build-essential autoconf pkg-config check
# 从源码编译
git clone https://github.com/stackia/rtp2httpd.git
cd rtp2httpd
# 生成构建脚本
autoreconf -fi
# 配置和编译
./configure
make
# 运行单元测试
make check本项目基于 GNU General Public License v2.0 开源协议发布。这意味着：
- ✅ 可以部署在商业环境中（如企业内部使用）
- ✅ 可以基于它提供收费的 IPTV 转码服务
- ✅ 可以销售包含此软件的硬件设备
⚠️ 如果修改代码，必须公开修改后的源代码⚠️ 如果分发二进制文件，必须同时提供源代码⚠️ 不能将其闭源后再销售
- 原始项目 rtp2httpd 的开发者们
- 为 FCC 协议实现提供技术支持的社区贡献者
- 所有测试和反馈用户