RTSProxy 是一款高性能、多模式的 RTSP 媒体流分发中间件，提供双向 RTSP 透明代理与 HTTP 媒体流转换分发能力。它集成了动态 URL 路由重写、时间偏移（Timeshift）、NAT 穿越打洞及基于 DPI（深度报文检测）的流控优化，旨在为复杂网络环境提供稳健、灵活的流媒体转发解决方案。
services:
rtsproxy:
image: ghcr.io/plsy1/rtsproxy:latest
container_name: rtsproxy
ports:
- 8554:8554
restart: always执行 docker compose up -d 即可启动。
在 OpenWrt 终端执行：
wget -qO- https://raw.githubusercontent.com/plsy1/rtsproxy/main/install.sh | sh安装脚本将自动部署二进制程序及 luci-app-rtsproxy 管理界面，安装完成后即可在 OpenWrt LuCI 菜单中直接进行图形化配置。
如果您需要在 Linux 环境下直接构建二进制程序，请确保已安装 meson 和 ninja：
meson setup build && ninja -C build
./build/rtsproxy项目内置了自动化交叉编译脚本，支持一键下载 SDK 并完成构建（默认为 x86_64 架构）：
chmod +x build_openwrt.sh
./build_openwrt.sh编译生成的 .ipk 安装包将存放在 bin/openwrt/ 目录下。
将上游 RTSP 流实时解复用并封装为 MPEG-TS 流，通过 HTTP 协议下发。适用于播放器兼容性要求高、需穿透复杂防火墙或进行 Web 播放的场景。
- 访问路径：
http://<proxy-ip>:<port>/rtp/<upstream-host>:<port>/<path>
作为透明中继器转发 RTSP 信令，并对媒体流进行双向中继。它能自动处理 NAT 穿透并根据链路状况动态调整传输参数。
- 访问路径：
rtsp://<proxy-ip>:<port>/rtp/<upstream-host>:<port>/<path>
访问内置的监控面板，实时监控会话状态、码率及丢包率。
- 默认路径：
http://<proxy-ip>:<port>/admin/ - 鉴权示例：
http://<proxy-ip>:<port>/admin/?token=your_token(若开启了--auth-token)
Tip
静态资源放行：开启鉴权后，代理会自动放行 WebUI 所需的 JS/CSS 资源，确保监控页面在未授权前也能正确加载基础框架。
Options:
-p, --port <port> 设置代理主端口 (默认: 8554)
-n, --enable-nat 开启 NAT 穿越
--nat-method <method> 设置 NAT 穿越模式: stun, zte (默认: stun)
-b, --buffer-pool-count <count> 设置 BufferPool 块数量 (默认: 8192)
-s, --buffer-pool-block-size <size> 设置 BufferPool 块大小 (默认: 2048)
-t, --auth-token <token> 设置鉴权 Token (可选)
-l, --listen-interface <iface> 设置服务监听网口 (下游)
-c, --config <path> 从指定 TOML 文件读取配置
--http-interface <iface> 设置 HTTP 模式上游网口
--mitm-interface <iface> 设置 MITM 模式上游网口
--stun-host <host> 设置 STUN 服务器地址 (默认: stun.l.google.com)
--stun-port <port> 设置 STUN 服务器端口 (默认: 19302)
-w, --watchdog 开启自动重启模式
-d, --daemon 后台运行
-k, --kill 杀死正在运行的实例
--log-file <path> 将日志写入指定文件
--log-level <level> 设置日志等级: error, warn, info, debug (默认: info)
--strip-padding 开启 MPEG-TS 空包剥离 (带宽优化)
--wait-keyframe 开启起播关键帧等待 (防止起播初始绿屏)Tip
多网口绑定 (Multi-Interface Support)：
你可以通过 --listen-interface 指定服务监听的本地网口，并通过可重复的 --upstream-route CIDR,iface 按目标网段选择上游出口。多个网段同时匹配时使用最长前缀；未匹配时使用系统路由表。
独立部署可通过 -c /path/config.toml 显式读取 TOML；该模式以配置文件为唯一配置来源。未传 -c 时不会查找配置文件，只使用命令行参数和程序默认值。OpenWrt 使用原生 UCI 配置 /etc/config/rtsproxy，与 TOML 相互独立。两种方式都支持全局设置、CIDR 出口路由、黑名单和 URL 重写规则，不再支持 JSON 配置。
TOML 示例：
[settings]
port = 8554
log_level = "info"
[security]
blacklist = ["127.0.0.0/8", "169.254.0.0/16"]
[[upstream_routes]]
cidr = "192.168.2.0/24"
interface = "eth1"
[[rewrite_rules]]
action = "replace"
match = "/iptv/import"
replacement = "/iptv"OpenWrt UCI 示例：
config rtsproxy 'main'
option enabled '1'
option port '8554'
list blacklist '127.0.0.0/8'
config upstream_route
option cidr '192.168.2.0/24'
option interface 'eth1'
config rewrite
option action 'replace'
option match '/iptv/import'
option replacement '/iptv'
URL 重写规则支持以下操作：
操作类型 (action) |
说明 | 示例配置项 |
|---|---|---|
remove |
移除匹配的路径片段 | match: "/.sdp" |
replace |
字符串或模式替换 | match: "/iptv/import", replacement: "/iptv" |
timeshift |
时间平移：自动偏移回看地址中的时间戳 | shift_hours: -8 (用于 GMT 转换) |
通配符支持：
{number}: 匹配任意连续数字（如频道 ID、时间戳）。
blacklist 是可重复的 UCI list，包含 CIDR 格式的 IP 地址段。代理将拒绝向这些地址发起上游连接，用于防止内网穿透攻击或递归环回死循环。
Note
递归环回检测：即使未配置黑名单，RTSProxy 也会自动识别并拒绝指向其自身监听端口的请求。
- 高效内存管理：基于
BufferPool的预分配内存池实现应用层零拷贝，极大降低 CPU 负载与内存碎片。
- 下游自适应：根据客户端
SETUP请求中的Transport自动切换 UDP 或 TCP Interleaved 回传。 - 上游无感回退：优先尝试 UDP 拉流，若遇到
461 Unsupported Transport错误，代理将自动拦截并立即无感切换至 TCP 模式重试，对客户端完全透明。
- 秒开优化 (
--wait-keyframe)：实时扫描 H.264/H.265 NAL 单元（SPS/PPS/VPS/IDR），确保从关键帧开始转发，杜绝起播瞬间的绿屏或花屏。 - 带宽压缩 (
--strip-padding)：DPI 实时识别并丢弃 MPEG-TS 中的空包（Null Packets），通常可节省 10%-30% 的下游带宽占用。
- STUN 模式：探测 WAN 口映射端口，解决标准 NAT 环境下上游 UDP RTP 流无法触达的问题。
- 运营商专网打洞 (ZTE)：针对中兴等机顶盒协议，模拟 84 字节身份验证报文，在 RTP 通道上主动打通 NAT 映射路径。
本项目为 OpenWrt 提供了完整的 LuCI 控制面板支持。
- 一键安装：见 快速开始。
- UCI 配置:
/etc/config/rtsproxy。 - LuCI 管理：全局设置、黑名单、出口路由和 URL 重写规则均直接写入 UCI。
LICENSE: 本项目遵循开源协议。欢迎提交 Issue 或 Pull Request。