自建IPTV直播平台无需公网，Docker快速部署秒播体验，内网穿透随处访问管理

IPTV-API：打造属于你的个性化电视直播平台

项目介绍

IPTV-API 是一个功能强大、高度可定制的IPTV接口更新项目，它能够帮助你快速搭建一个属于自己的电视直播源管理平台。项目支持自定义频道菜单、自动获取直播源、智能测速验效，最终生成可用的高质量直播接口，让你获得秒播级的观看体验。

无论你是电视爱好者还是内容运营者，IPTV-API 都能满足你的需求。它支持多种源获取方式（本地源、组播源、酒店源、订阅源、关键字搜索），集成了 EPG 电子节目单、频道台标、接口测速等丰富功能，让直播管理变得简单高效。

最棒的是，项目支持工作流、命令行、GUI 软件、Docker 等多种运行方式，无论你的技术水平如何，都能轻松上手！

项目地址：点我跳转

部署安装

如果你想在外网也能访问这个项目，建议配置内网穿透服务。这样无论身在何处，都能随时随地管理和使用你的直播源。可以前往帕斯内网穿透注册账号，详细的操作指南请点我查看。

Docker 快速部署

IPTV-API 提供了开箱即用的 Docker 镜像，这是最快速的部署方式。

第一步：添加镜像

打开你的 NAS 设备（飞牛 NAS、群晖或其他支持 Docker 的 NAS），进入 Docker 管理界面。

点击 本地镜像 → 添加镜像 → 从 URL 添加

在镜像地址栏填入：

1guovern/iptv-api:latest

💡 国内用户如果拉取速度较慢，可以使用加速地址：docker.1ms.run/guovern/iptv-api:latest

等待镜像下载完成后，点击 启动按钮 启动容器。

第二步：容器配置

在启动容器前，需要进行以下配置：

开机自启设置

勾选 开机自动启动，这样 NAS 重启后容器会自动运行。

端口映射设置

宿主机端口：可自定义（例如 8000）

容器内端口：8000（保持不变）

💡 如果提示端口被占用，可以修改宿主机端口号。例如改为 8001，访问时使用 ip:8001 即可。容器内部端口需要保持 8000 不变。

存储挂载设置

为了能够在宿主机上直接编辑配置文件和获取结果文件，建议创建以下两个挂载点：

配置文件挂载：

容器内路径：/iptv-api/config

宿主机路径：/mnt/data/iptv-api/config（自定义）

结果文件挂载：

容器内路径：/iptv-api/output

宿主机路径：/mnt/data/iptv-api/output（自定义）

这样你就可以在 NAS 文件管理中直接修改频道模板、配置参数，以及获取生成的直播源文件。

环境变量设置

以下是可选的环境变量配置：

必须设置：

APP_PORT：服务端口（默认值：8000）- 一般保持默认即可

可选设置：

APP_HOST：服务访问地址（默认值：http://localhost）- 如果需要使用公网域名或特定 IP 访问，可在此配置

其他所有参数都可以通过挂载的 config/config.ini 文件进行高级定制，无需在环境变量中设置。

第三步：启动并验证

完成以上配置后，点击 下一步 并 启动容器。

容器启动成功后，在浏览器中访问：

1http://你的NAS_IP:8000

如果能看到 IPTV-API 的管理页面，说明部署成功！

核心功能概览

✅ 自定义模板 - 生成你想要的个性化频道列表

✅ 频道别名 - 支持正则表达式，提升频道匹配准确率

✅ 多源获取 - 本地源、组播源、酒店源、订阅源、关键字搜索多管齐下

✅ 接口测速 - 自动测试延迟、速率、分辨率，过滤无效接口

✅ EPG 电子节目单 - 显示频道预告内容

✅ RTMP 推流 - 支持 Live 与 HLS 模式，提升播放体验

✅ 定时更新 - 默认每天 6:00 和 18:00 自动更新，可自定义

✅ 多平台支持 - 工作流、命令行、GUI、Docker 等多种运行方式

总结

通过 IPTV-API，你可以轻松搭建一个功能完整、高度可定制的电视直播管理平台。无论是个人使用还是小范围分享，都能获得稳定、高效的直播体验。Docker 部署方式让整个过程变得极其简单，即使是技术小白也能在几分钟内完成配置。

现在就开始部署吧，享受属于你自己的直播平台！