如何用 Docker Compose 一键部署 iptv-proxy10 分钟启动你的 IPTV 代理服务【免费下载链接】iptv-proxyReverse proxy on iptv m3u and m3u8 file and xtream codes client api项目地址: https://gitcode.com/gh_mirrors/ip/iptv-proxy如果你正在寻找一个简单可靠的 IPTV 代理服务解决方案那么开源项目 iptv-proxy 会是一个很棒的选择。它是一个基于 Go 语言编写的轻量级反向代理工具核心功能是把 m3u / m3u8 播放列表和 Xtream Codes 客户端 API 统一代理转发帮助你隐藏真实流媒体源地址、统一认证鉴权并让任意播放器都能稳定接入。本文将手把手带你用 Docker Compose 一键部署 iptv-proxy全程无需手动编译源码10 分钟内即可启动属于自己的 IPTV 代理服务。什么是 iptv-proxy为什么你需要一个 IPTV 代理iptv-proxy 本质上是一个翻译官它读取你的原始 IPTV 订阅m3u 文件或 Xtream Codes 账号然后把所有频道地址重写为指向代理服务器的全新链接。这样做有三大好处️隐藏真实源播放器只看到你的代理域名原始服务器地址不泄露统一认证把上游的账号密码替换为你自己设定的 USER / PASSWORD安全性更高兼容性强转换后的播放列表可以直接导入 TiviMate、IPTV Smarters、VLC 等主流播放器。项目核心配置与路由逻辑分别位于 cmd/root.go 与 pkg/config/config.go但普通用户完全不需要关心源码我们只需使用官方提供的 Dockerfile 和 docker-compose.yml 即可。部署前的准备工作3 项前置条件在开始 Docker Compose 部署之前请先确认以下条件Docker 与 Docker Compose建议 Docker 20 版本Docker Compose v2 可直接使用docker compose命令一份 IPTV 源可以是远程 m3u 链接如http://xxx/get.php?...也可以是本地的iptv.m3u文件若使用 Xtream Codes 账号则需要 base-url、用户名和密码一台可访问的服务器或 NAS本机测试使用localhost即可外网使用则需公网 IP 或域名。一切就绪后我们开始一键安装。10 分钟快速部署 iptv-proxyDocker Compose 一键安装步骤第一步获取项目文件打开终端克隆项目仓库到本地git clone https://gitcode.com/gh_mirrors/ip/iptv-proxy cd iptv-proxy克隆完成后你会看到项目根目录下的 docker-compose.yml 以及用于放置本地播放列表的iptv/文件夹。第二步准备你的 IPTV 源文件如果使用本地 m3u 文件把它复制到iptv/目录并命名为iptv.m3ucp /你的路径/playlist.m3u iptv/iptv.m3u如果使用远程 m3u 链接则跳过此步直接修改环境变量即可。第三步修改 compose 配置最快配置方法打开docker-compose.yml重点修改environment部分environment: M3U_URL: /root/iptv/iptv.m3u # 本地文件路径远程源则填 https://example.com/get.php?usernameuserpasswordpasstypem3u_plusoutputm3u8 PORT: 8080 # 监听端口 HOSTNAME: localhost # 对外暴露的主机名或 IP GIN_MODE: release USER: test # 代理访问用户名 PASSWORD: testpassword # 代理访问密码只需改这四个关键项即可跑通其余为可选配置。第四步一键启动服务在项目根目录执行docker compose up -d等待镜像构建完成看到Started状态即代表 IPTV 代理服务启动成功 核心环境变量详解让配置不再神秘想进一步定制项目在 cmd/root.go 中定义了全部可配置参数对应环境变量如下环境变量作用示例M3U_URLm3u 文件路径或远程链接/root/iptv/iptv.m3uPORT代理服务监听端口8080HOSTNAME对外暴露的主机名/IPlocalhostADVERTISED_PORT反代场景下的对外端口443HTTPS置为1生成 https 链接1XTREAM_USERXtream 上游用户名xtream_userXTREAM_PASSWORDXtream 上游密码xtream_passwordXTREAM_BASE_URLXtream 上游基础地址http://example.tv:1234M3U_CACHE_EXPIRATIONm3u 缓存过期时间小时1需要代理 Xtream Codes 服务时只需补上XTREAM_USER、XTREAM_PASSWORD、XTREAM_BASE_URL三个变量系统会自动开启 Xtream 代理支持 live、vod、series 和完整 EPG。如何验证你的 IPTV 代理服务是否正常运行启动后用浏览器或 curl 访问代理生成的播放列表curl http://localhost:8080/iptv.m3u?usernametestpasswordtestpassword如果返回一份包含#EXTINF标签且所有频道地址都指向localhost:8080的 m3u 内容说明代理转发已生效。接下来只需把这个地址添加到任意播放器即可VLC媒体 → 打开网络串流 → 粘贴上述 URLTiviMate / IPTV Smarters在订阅管理中添加新订阅填入 URL 与账号密码。Xtream 用户则使用标准 API 地址http://localhost:8080/get.php?usernametestpasswordtestpasswordtypem3u_plusoutputts常见问题排查让部署一次成功端口被占用8080冲突时修改docker-compose.yml中ports与PORT两个值两者必须一致播放列表为空检查M3U_URL路径是否写错本地文件是否确实放在iptv/目录该目录已挂载到容器/root/iptv播放器提示 401确认 URL 中的username、password与USER、PASSWORD环境变量一致远程源加载缓慢适当调大M3U_CACHE_EXPIRATION缓存时长。进阶技巧配合 Traefik 为 IPTV 代理服务开启 HTTPS对外提供服务时强烈建议启用 HTTPS。项目在traefik/目录内置了完整方案参考 traefik/docker-compose.yml 把 iptv-proxy 与 Traefik 编排在一起设置HOSTNAME为你的域名、HTTPS: 1、ADVERTISED_PORT: 443Traefik 便会自动申请证书并完成 TLS 终止让播放器通过https://你的域名/iptv.m3u安全访问。总结通过 Docker Compose 一键部署 iptv-proxy你可以在 10 分钟内轻松拥有一个稳定、私密且兼容性极佳的 IPTV 代理服务。无论是保护源地址、统一账号认证还是让 Xtream Codes 源无缝接入任意播放器这个轻量级代理都能胜任。现在就动手试试享受自建 IPTV 代理服务的乐趣吧【免费下载链接】iptv-proxyReverse proxy on iptv m3u and m3u8 file and xtream codes client api项目地址: https://gitcode.com/gh_mirrors/ip/iptv-proxy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考