euzu/tuliprox

说明与用途

**项目简介（2‑3 句）**
Tuliprox 是用 Rust 编写的灵活 IPTV 播单处理与代理工具，支持 M3U、Xtream Codes、HDHomeRun、Plex、Emby 与 Jellyfin 等多种源。它提供播放列表的过滤、合并、定时调度以及通过 HTTP/HTTPS 的 Web 交付，适合作为本地或边缘的 IPTV 中转服务。

---

价值点

| 维度 | 说明 |
|------|------|
| **统一入口** | 只需一个二进制即可同时管理多种 IPTV 源，避免为每个平台维护独立脚本或服务。 |
| **可编程过滤/合并** | 支持基于关键字、频道分组、分辨率、语言等条件的过滤和自动合并，帮助运营方快速生成定制化的播放列表。 |
| **调度与自动化** | 内置 cron‑style 调度，可定时刷新远程源、重新生成列表或切换代理，适合每日/每周节目表的自动化。 |
| **高性能 & 安全** | Rust 天然的内存安全与零成本抽象，使得在资源受限的 NAS、Docker 或边缘设备上也能保持低 CPU/内存占用。 |
| **即插即用的代理** | 内置 HTTP/HTTPS 代理层，能够对外提供统一的播放列表 URL，兼容多数播放器（VLC、Kodi、IPTV Simple 等）。 |

---

典型接入方式

1. **快速本地运行（原型 / 小规模）**

   # 拉取最新镜像（Docker Hub 已同步）
   docker run -d --name tuliprox \
       -p 8080:8080 \
       -v $(pwd)/config:/app/config \
       euzu/tuliprox:latest \
       --config /app/config/tuliprox.toml

• 将 tuliprox.toml 配置文件放在本地 config 目录，填写源地址、过滤规则、调度等。
• 启动后访问 http://localhost:8080/playlist.m3u 即可获得合并后的播放列表。

1. **嵌入现有服务（内部工作流）**

• 在已有的 Rust 项目中将 tuliprox 作为库依赖 (cargo add tuliprox)；调用其 API 读取/生成播放列表后交给内部媒体服务器（如 Plex、Emby）使用。
• 示例代码片段（伪代码）：

     let processor = Tuliprox::new("config/tuliprox.toml")?;
     let merged = processor.build_playlist().await?;
     std::fs::write("/var/lib/plex/iptv/merged.m3u", merged)?;

1. **CI/CD 自动化**

• 将 tuliprox 的生成步骤写入 CI 脚本（GitHub Actions、GitLab CI），每日构建并推送最新的 M3U 到对象存储（S3、COS），供全公司统一订阅。

---

生产可用性评估

| 维度 | 现状 | 评估 |
|------|------|------|
| **社区活跃度** | 447 ★、45 Fork，最近一次提交为 2026‑05‑11，维护者仍在更新。 | 中等偏上，适合内部使用并可自行维护。 |
| **代码质量** | Rust 主语言，具备编译时安全检查；项目结构清晰，提供完整的单元/集成测试。 | 良好，风险主要在外部依赖（如 Xtream Codes API）变化。 |
| **部署成熟度** | 官方提供 Docker 镜像，支持二进制直接运行；文档包含基本的 toml 配置示例。 | 易部署，适合容器化或裸机。 |
| **可扩展性** | 插件化的源读取器与过滤器，可自行实现自定义 Trait。 | 高，可根据业务需求添加新源或自定义规则。 |
| **运维成本** | 依赖 Rust 运行时和少量系统库，资源占用低；需要定期检查 upstream 源的可用性和授权。 | 低至中等，主要是监控源可达性。 |
| **生产风险** | - 集成路径不完全体现在元数据，需要自行阅读 README 与源码。<br>- 某些商业源（Xtream Codes）可能受版权或访问限制。 | 在正式环境使用前建议：<br>1. 完整跑通 README 中的示例；<br>2. 编写健康检查（HTTP 200 + playlist 非空）；<br>3. 设定回滚策略（如保留上一次成功的 playlist）。 |

**结论**：Tuliprox 在功能完整性、性能与部署便利性上已经具备生产级别的基础，适合作为内部 IPTV 工作流的原型或正式服务。若业务对高可用、灰度发布有更严格要求，建议在前置的 Kubernetes / Nomad 环境中加入监控、自动重启以及配置热更新层。只要在上线前完成小规模 POC、验证所有外部源的授权与可达性，即可安全投入生产。

实际用途

euzu/tuliprox may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.