fyb3roptik/threadfin
fyb3roptik
Threadfin是用于Plex、Emby、Jellyfin等的M3U代理服务器，支持TS和M3U8格式，模拟SiliconDust HDHomeRun调谐器，使不支持IPTV的软件能使用IPTV频道，Docker镜像包含Linux x86 64位Threadfin、ffmpeg支持，以非特权用户运行。
28 次收藏下载次数: 0状态：社区镜像维护者：fyb3roptik仓库类型：镜像最近更新：8 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Threadfin Docker镜像文档
镜像概述和主要用途
Threadfin是一款M3U代理服务器，专为Plex、Emby、Jellyfin等客户端以及支持.TS和.M3U8（HLS）流媒体格式的提供商设计。它通过模拟SiliconDust HDHomeRun OTA调谐器，将IPTV风格的频道暴露给通常不支持IPTV的软件。本Docker镜像包含Linux x86 64位版本的Threadfin核心程序、ffmpeg媒体处理支持，并以非特权用户身份运行以提升安全性。
核心功能和特性
- 作为M3U代理服务器，支持.TS和.M3U8流媒体格式的转发与处理
- 模拟SiliconDust HDHomeRun调谐器，扩展IPTV服务对传统媒体中心软件的兼容性
- 集成ffmpeg，提供媒体格式转换和流处理能力
- 以非特权用户运行，降低容器运行风险
- 支持通过环境变量配置git分支、调试级别和服务端口
默认容器路径
容器预配置了以下环境变量及对应路径，便于数据持久化和配置管理：
| 变量 | 路径 |
|---|---|
| $THREADFIN_HOME | /home/threadfin |
| $THREADFIN_BIN | /home/threadfin/bin |
| $THREADFIN_CONF | /home/threadfin/conf |
| $THREADFIN_CONF/data | /home/threadfin/conf/data |
| $THREADFIN_CONF/backup | /home/threadfin/conf/backup |
参数说明
可通过环境变量自定义容器配置，参数说明如下：
| 参数 | 描述 |
|---|---|
| -e THREADFIN_BRANCH=beta | 设置Threadfin的git分支，可选值：main（稳定版）/beta（测试版），默认值：beta |
| -e THREADFIN_DEBUG=0 | 设置调试级别，取值范围：0-3，默认值：0（关闭调试） |
| -e THREADFIN_PORT=34400 | 设置Threadfin服务监听端口 |
使用示例
Docker Run部署
bashdocker run -d \ -p 34400:34400 \ -e THREADFIN_BRANCH=main \ -e THREADFIN_DEBUG=1 \ --name threadfin \ docker.xuanyuan.run/threadfin/threadfin
上述命令将启动Threadfin容器，映射宿主机34400端口到容器内服务端口，使用main分支代码并开启调试级别1。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 threadfin 镜像标签
docker pull docker.xuanyuan.run/fyb3roptik/threadfin:<标签>
DockerHub 原生拉取命令
docker pull fyb3roptik/threadfin:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"