iptv-proxy 进阶玩法自定义端点、防冲突 ID 与 HTTPS 代理链接生成【免费下载链接】iptv-proxyReverse proxy on iptv m3u and m3u8 file and xtream codes client api项目地址: https://gitcode.com/gh_mirrors/ip/iptv-proxyiptv-proxy 是一款开源的IPTV 反向代理工具它能把远程的 m3u / m3u8 播放列表以及 Xtream Codes 客户端 API 统一代理到你自己控制的服务器上并生成全新的、可分享的播放链接。很多新手把 iptv-proxy 跑起来之后只满足于默认输出效果其实它还隐藏着几个非常实用的小参数自定义端点--custom-endpoint、防冲突 ID--custom-id和HTTPS 代理链接生成--https。这篇 iptv-proxy 进阶教程就带你一次性玩转这三个进阶玩法让播放链接更简洁、更稳定、更安全。iptv-proxy 是什么先看默认输出长什么样在进入进阶玩法之前先快速回顾一下 iptv-proxy 的默认行为。启动代理后它会做两件事把原始 m3u 播放列表里每个频道的地址改写成指向你自己服务器的代理地址生成一份全新的 m3u 文件供播放器加载。默认情况下你会得到类似这样的输出http://proxyserver.com:8080/iptv.m3u?usernametestpasswordpasswordtest而每个频道的代理链接则长这样http://proxyserver.com:8080/xxxxx/test/passwordtest/0/chanel1其中xxxxx是一个随机生成的防冲突 ID后面我们会详细讲它。相关的参数定义都在 cmd/root.go 里链接生成的核心逻辑在 pkg/server/server.go路由注册则在 pkg/server/routes.go感兴趣的同学可以对照源码一起看。进阶玩法一自定义端点一键让 m3u 链接更简洁默认情况下所有接口都挂在根路径/下。如果你同时代理了多套播放列表或者想让分享出去的链接更有个性就可以用--custom-endpoint参数给所有接口加上一个统一的前缀。一步配置自定义端点--custom-endpoint 使用教程启动命令只需要加一个参数iptv-proxy \ --m3u-url http://example.com/get.php?usernameuserpasswordpasstypem3u_plusoutputm3u8 \ --hostname proxy.example.com \ --port 8080 \ --custom-endpoint my-iptv \ --user test \ --password testpass设置之后播放列表地址就变成了http://proxy.example.com:8080/my-iptv/iptv.m3u?usernametestpasswordtestpass频道链接也会统一带上这个前缀。这样做有几个显而易见的好处多套列表互不干扰想代理两组不同来源时可以用my-iptv-1、my-iptv-2区分✨分享链接更美观前缀比一串随机字符更有辨识度更容易接入 CDN 或网关可以针对特定前缀做流量转发或访问控制。注意custom-endpoint会影响所有接口包括 m3u 文件、频道流以及 Xtream 相关端点配置前最好想清楚前缀命名。进阶玩法二防冲突 ID让每个频道链接不再撞车前面提到iptv-proxy 会给每个频道生成一个随机的防冲突 ID源码里叫endpointAntiColision。它的作用是避免不同频道、不同实例之间的代理链接互相覆盖。但随机 ID 也有两个让人头疼的问题❌ 每次重启代理ID 都会变化导致你保存在播放器里的频道链接全部失效❌ 如果多个 iptv-proxy 实例恰好生成相同的 ID路由就会冲突。如何用 --custom-id 固定频道链接防止 ID 冲突解决方法非常简单用--custom-id手动指定一个固定的 ID 即可。iptv-proxy \ --m3u-url http://example.com/get.php?usernameuserpasswordpasstypem3u_plusoutputm3u8 \ --hostname proxy.example.com \ --port 8080 \ --custom-id myid2024 \ --user test \ --password testpass固定之后频道链接就会稳定为这种格式http://proxy.example.com:8080/myid2024/test/testpass/0/chanel1 http://proxy.example.com:8080/myid2024/test/testpass/1/chanel2对比一下带端点的完整形态就是http://proxy.example.com:8080/自定义端点/自定义ID/用户/密码/序号/频道文件名。使用--custom-id的核心价值️彻底杜绝链接冲突多实例部署时只要每个实例指定不同的 ID 就不会撞车♻️重启后链接依然可用播放器里保存的频道地址不会因为重启而失效日志和调试更友好链接里一眼就能看出是哪套代理。如果你什么都没指定iptv-proxy 也会在启动时自动生成一个随机 ID见 pkg/server/server.go 中的endpointAntiColision所以它默认是开箱即用的只是不固定而已。进阶玩法三最安全的 HTTPS 代理链接生成方法IPTV 播放器在播放时往往会频繁请求频道流媒体地址。如果这些请求走明文 HTTP账号密码和播放记录都有被中间人窃取的风险。iptv-proxy 很贴心地提供了HTTPS 代理链接生成能力只需一个开关。最快配置方法--https 与 --advertised-port 组合命令行方式如下iptv-proxy \ --m3u-url http://example.com/get.php?usernameuserpasswordpasstypem3u_plusoutputm3u8 \ --hostname proxy.example.com \ --advertised-port 443 \ --https \ --user test \ --password testpass加上--https之后iptv-proxy 生成的所有代理链接都会从http://变成https://https://proxy.example.com:443/myid2024/test/testpass/0/chanel1这里有两个关键参数参数作用--https让生成的代理链接使用https://协议--advertised-port对外公布端口默认取--port的值放在反向代理后面时通常设为 443使用场景当你把 iptv-proxy 放在 Nginx、Traefik 等反向代理后面对外只暴露 443 端口时就必须用--advertised-port 443配合--https这样生成的链接才能被播放器正确访问。Docker 部署 iptv-proxy 的 HTTPS 配置步骤使用 Docker 部署时在docker-compose.yml参考项目根目录的 docker-compose.yml里添加环境变量即可environment: M3U_URL: /root/iptv/iptv.m3u PORT: 8080 HOSTNAME: iptv.proxyexample.xyz HTTPS: 1 ADVERTISED_PORT: 443 USER: test PASSWORD: testpass如果希望一键获得免费证书项目还提供了 Traefik 方案把traefik目录下的文件traefik/docker-compose.yml拷贝到项目根目录按其中的说明替换你的域名然后docker-compose up -d即可完成 HTTPS 代理链接的自动签发与转发。进阶玩法四顺便把 Xtream 代理也玩明白如果你订阅的 IPTV 服务是Xtream Codes 客户端 API格式iptv-proxy 同样支持代理。核心参数有三个--xtream-user上游的 Xtream 用户名--xtream-password上游的 Xtream 密码--xtream-base-url上游的 Xtream 服务器地址。再加一个--xtream-api-get可以让代理基于 Xtream API 重新生成get.php 播放列表而不是简单透传原始接口。完整的 Xtream 代理逻辑在 pkg/server/xtreamHandles.go 和 pkg/xtream-proxy/xtream-proxy.go 中支持 live、VOD、series 以及 EPG功能相当完整。代理之后你只需要把播放器里的服务器地址换成自己的域名用新的USER/PASSWORD登录就能绕过源站 IP既保护了上游账号也让访问更稳定。常见问题进阶配置避坑指南Q1修改 custom-id 后之前保存的频道链接还能用吗不能。custom-id是链接路径的一部分修改后所有频道链接都会变化需要重新加载 m3u 文件。所以建议从第一次部署起就固定一个 ID避免后期迁移。Q2开启了 --https但播放器提示链接不安全请确认你的 HTTPS 证书是由可信 CA 签发的如 Lets Encrypt并检查--hostname是否与证书域名一致。iptv-proxy 本身只负责生成 https 链接真正的 TLS 终止需要由它前面的反向代理Traefik / Nginx / Caddy来完成。Q3多个 iptv-proxy 实例同时运行如何避免冲突为每个实例分别指定不同的--custom-endpoint和--custom-id这是最简单也最稳妥的防冲突方案。Q4如何快速体验这些进阶玩法可以先用 Git 克隆仓库git clone https://gitcode.com/gh_mirrors/ip/iptv-proxy然后参考 README.md 里的参数说明从最简单的--custom-id开始尝试逐步叠加自定义端点和 HTTPS 配置。小结iptv-proxy 的进阶玩法并不复杂核心就是三个参数--custom-endpoint给所有接口加前缀链接更简洁、多套列表更好区分--custom-id固定防冲突 ID重启不失效、多实例不撞车--https --advertised-port生成 HTTPS 代理链接安全又专业。把它们组合起来你就能得到一个链接美观、长期稳定、安全加密的私人 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），仅供参考