安装方式

rtp2httpd 支持多种安装方式，适应不同的使用场景。

OpenWrt 路由器部署

OpenWrt 是 rtp2httpd 的最佳运行环境。在中国大陆，通常需要先完成 IPTV 网络融合（可以搜索教程 OpenWrt IPTV 融合），通过 DHCP 获取到 IPTV 内网 IP，才能访问运营商的 IPTV 组播网络。

详见 快速上手。

静态二进制文件部署

从 Releases 页面下载对应架构的静态二进制文件 rtp2httpd-<版本号>-<架构>，上传到设备并 chmod +x 后即可运行。

默认从 /etc/rtp2httpd.conf 读取配置文件。可用 --config 或 --noconfig 参数覆盖。

示例：

# 获取自己的 CPU 架构
uname -m

# 下载二进制文件
wget https://github.com/stackia/rtp2httpd/releases/download/vX.Y.Z/rtp2httpd-X.Y.Z-x86_64
chmod +x rtp2httpd-X.Y.Z-x86_64

# 使用配置文件运行
./rtp2httpd-X.Y.Z-x86_64 --config /path/to/rtp2httpd.conf

# 仅使用命令行参数运行
./rtp2httpd-X.Y.Z-x86_64 --noconfig --verbose 2 --listen 5140 --maxclients 20

TIP

你可以使用这个示例文件 rtp2httpd.conf 作为基础来修改配置。具体说明见 配置参数详解。

Docker 容器部署

适用于支持 Docker 的设备。需要使用 host 网络模式以正确接收组播流。

基本启动方式

docker run --network=host --cap-add=NET_ADMIN --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
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
    ulimits:
      memlock:
        soft: -1
        hard: -1
    command: --noconfig --verbose 2 --listen 5140 --maxclients 20

NOTE

关于推荐参数：

• cap_add: NET_ADMIN：允许通过 SO_RCVBUFFORCE 绕过内核参数 net.core.rmem_max 限制，设置更大的 UDP 接收缓冲区
• ulimits: memlock: -1：启用零拷贝（--zerocopy-on-send）时必需，MSG_ZEROCOPY 需要锁定内存页

挂载配置文件

如果需要使用配置文件（假设配置文件位于 /path/to/rtp2httpd.conf）：

docker run --network=host --cap-add=NET_ADMIN --ulimit memlock=-1:-1 --rm \
  -v /path/to/rtp2httpd.conf:/usr/local/etc/rtp2httpd.conf:ro \
  ghcr.io/stackia/rtp2httpd:latest

TIP

你可以使用这个示例文件 rtp2httpd.conf 作为基础来修改配置。具体说明见 配置参数详解。

OpenWrt 编译安装

如果你希望通过 OpenWrt 源码构建直接把 rtp2httpd 编译到固件里，可以把本仓库直接加入 feeds.conf.default：

# 使用 main 分支最新代码
src-git rtp2httpd https://github.com/stackia/rtp2httpd.git

或者指定版本号：

# 使用 v3.10.1 版本代码
src-git rtp2httpd https://github.com/stackia/rtp2httpd.git;v3.10.1

运行 ./scripts/feeds update rtp2httpd 和 ./scripts/feeds install rtp2httpd 更新 feed。

运行 make menuconfig，找到 LuCI -> Applications -> luci-app-rtp2httpd，将其勾选为 * (编译到固件) 或 M (编译成 ipk/apk 包)，保存退出。

运行 make package/feeds/rtp2httpd/luci-app-rtp2httpd/compile -j1 V=sc 可单独编译 luci-app-rtp2httpd 和 rtp2httpd 两个包。

固件维护者集成指南

如果你维护第三方 OpenWrt 固件，希望直接将 rtp2httpd 集成到你的 feeds 仓库中（而非通过 src-git 引用），可以使用本项目提供的 Makefile.versioned：

git clone https://github.com/stackia/rtp2httpd.git
cd rtp2httpd

# 用预生成的 Makefile 替换原始 Makefile（已包含固定版本号、源码下载地址和 PKG_HASH）
mv openwrt-support/rtp2httpd/Makefile.versioned openwrt-support/rtp2httpd/Makefile
mv openwrt-support/luci-app-rtp2httpd/Makefile.versioned openwrt-support/luci-app-rtp2httpd/Makefile

# 将 openwrt-support 目录内容复制到你的 feeds 仓库
cp -r openwrt-support/* /path/to/your/feeds/

Makefile.versioned 与原始 Makefile 的区别在于：版本号已固定、PKG_HASH 已填充、构建时会从 GitHub Release 下载源码包，无需本地 git 仓库。每次 rtp2httpd 发布新版本时，main 分支 Makefile.versioned 都会自动更新。

传统编译安装

适用于需要自定义编译或开发调试的场景。

安装依赖

# Ubuntu/Debian
sudo apt-get install build-essential autoconf automake pkg-config curl

# 安装 Node.js LTS（用于构建 Web UI）
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
corepack enable

编译步骤

# 克隆仓库
git clone https://github.com/stackia/rtp2httpd.git
cd rtp2httpd

# 构建 Web UI 并嵌入静态资源
pnpm install --frozen-lockfile
pnpm run web-ui:build

# 生成构建脚本
autoreconf -fi

# 配置和编译
./configure --enable-optimization=-O3
make

# 安装
sudo make install

下一步

• 快速上手：OpenWrt 快速配置指南
• 配置参数详解：了解所有配置选项
• URL 格式说明：了解所有支持的 URL 格式
• M3U 播放列表集成：配置播放列表
• FCC 快速换台配置：启用毫秒级换台功能