无双IPTV
作者:B站-锤无双 · QQ群:170621740 · 📺 视频教程 · 作者主页
让家里机顶盒退役:抓取 / 验证自家 IPTV 组播直播源,一键生成 M3U 播放列表,全家电视、手机、平板都能看直播。
Windows 单文件绿色版,双击即用,无需安装任何驱动 / 运行库。
v2.2 新增 sweep 组播全段扫频(发现参考库外频道)、转发剥 RTP 头 + IGMP 周期续期、抓包空结果 snooping 诊断、
NAS Docker 鉴权转发(docker/);配套无双电视 APK 升级 v1.1(缓冲抗抖动)。详见 更新说明。
### 🧪 跨平台测试版(v2.2.1-beta)
Linux / macOS / 鸿蒙PC 版均为测试版:未做真机测试,仅供参考。
Windows 版为 v2.2.1 正式版。详见 跨平台说明 与 鸿蒙版说明。
!接线向导
✨ 功能
- 接线向导:回答几个硬件问题,自动生成插拔网线步骤 + 拓扑图。支持三种场景:
- 抓包分析:用 Windows 内置
pktmon(无需 Wireshark/Npcap),机顶盒换台自动发现组播地址,自动去重、过滤噪声。 - 频道验证:原生加组收流解析 MPEG-TS(PAT/PMT/SDT/SPS),不依赖 ffmpeg,自动命名、标出编码 / 分辨率 / 可用性。
- 全国参考库:覆盖 31 省 × 电信/联通/移动/广电,按省份+运营商载入;支持在线更新 / 离线导入。
- 生成 M3U:
udp://组播直连 +http://udpxy 转发双格式,指定目录保存 / 合并 / 自动更新。 - 一键推送 NAS:SMB 共享 / WebDAV,抓完自动同步播放列表到 NAS,配合 Tvheadend/udpxy 实现 7×24 转发。
- 转发服务:内置 udpxy 等价服务,组播转 HTTP 单播,WiFi 设备播放更稳;v2.2 起自动剥 RTP 头(兼容裸 TS)、周期补发 IGMP 报告防无查询器网络加组老化断流。
- 组播扫频
sweep(v2.2):CIDR/起止范围逐个真实加组收流,发现参考库未收录的频道(试看/轮播/地方台/改址普查);抓包 0 结果但电视能看(IGMP snooping 定向转发)时的主力发现手段。 - 抓包空结果诊断(v2.2):capture 0 候选时附 hint,指引 snooping 场景改走 verify/sweep 主动加组路线。
- NAS Docker 鉴权转发(v2.2,docker/):面向个人远程观看的加固版转发(强制 token/白名单/限流/封禁/续期/healthcheck),含群晖部署说明与 tv 开机任务依赖;见 docker/README.md。
- CLI 命令行模式(v2.1):
WushuangIPTV-CLI.exe无界面跑通全流程,JSON 输出 + 退出码,可被 AI 工具(Claude Code / DSH / Cursor 等)直接调用;仅抓包需要管理员。 - 4K 高 DPI 自适应(v2.1):按系统真实 DPI 缩放字体与界面,高分屏不再字小;1080p 下观感不变。
📷 截图
| | | |---|---| | !抓包分析 | !频道验证 | | !生成M3U+推送NAS | !转发服务 |
🚀 快速开始
- 下载 Releases 里的
WushuangIPTV.exe(无双IPTV抓源工具,单文件绿色版;或自行构建),双击运行(自动请求管理员权限)。 - ① 接线向导选你的场景 → 照步骤接线。
- ② 抓包分析:开始抓包 → 机顶盒逐个换台(每台停 3~5 秒)→ 停止并分析 → 加入频道列表。
- ③ 频道验证:选组播网卡 → 验证全部。
- ④ 生成 M3U:选输出目录 → 保存;可选「一键推送到 NAS」。
- 用 VLC / Kodi / DIYP / 无双电视 APK 打开播放列表即可。
🤖 AI 工具 / 命令行调用(v2.1)
下载 Releases 里的 WushuangIPTV-CLI.exe(控制台版,不强制管理员),AI 工具或脚本即可直接操作:
WushuangIPTV-CLI.exe info # 环境总览(网卡/参考库/建议网卡)
WushuangIPTV-CLI.exe verify --province 浙江 --carrier 电信 --out verified.json # 载入参考库并实测验证
WushuangIPTV-CLI.exe sweep --range 233.50.200.0/22 --out sweep.json # 全段扫频发现参考库外频道(v2.2)
WushuangIPTV-CLI.exe m3u --channels verified.json --outdir D:\iptv # 生成 udp+http 双版 M3U
- stdout 单个 JSON 结果、stderr JSONL 进度、退出码 0成功/1失败/2参数错误/3需管理员;
- 频道 JSON 贯穿 load→verify/sweep→m3u→proxy/push;仅
capture抓包需要管理员; - verify/sweep 默认并发 2(部分光猫限速 burst 加组,高并发易假失败;判死前低并发复核);
- 首次运行若弹 Windows 防火墙提示请点「允许访问」。
💻 跨平台版本(Linux / macOS / 鸿蒙PC)
⚠️ 三个新平台均为 v2.1 测试版:未做真机测试,仅供参考。 真实 IPTV 环境验证前请勿用于生产。
Linux 已在 WSL(Ubuntu 22.04)完成功能验证(自测 48 项 + 组播回环端到端 + 真实 tcpdump 抓包 + 打包运行);
macOS 与 Linux 共用 POSIX 代码路径,由 CI 构建覆盖;鸿蒙版已构建出 HAP,待签名与真机验证。
| 平台 | 版本 | 抓包 | 验证/M3U/转发 | 获取方式 |
|---|---|---|---|---|
| Windows 10 1809+ / 11 | v2.2.1 正式 | ✅ pktmon(管理员) | ✅ | Releases exe |
| Linux x64 | v2.2.1-beta | ✅ tcpdump(sudo) | ✅ | CI 产物 / 源码 / build_cli.sh |
| macOS Intel / Apple Silicon | v2.2.1-beta | ✅ tcpdump(sudo,系统自带) | ✅ | CI 产物 / 源码 / build_cli.sh |
| 鸿蒙PC(HarmonyOS NEXT,2in1) | v2.1.0-beta | ❌ 系统无第三方抓包权限 | ✅ 精简版 | DevEco 打开 harmony/ 签名运行 |
Linux / macOS 快速开始
# 源码方式(Python 3.10+,核心零第三方依赖)
sudo apt install python3 python3-tk tcpdump # Linux;macOS 自带 tcpdump,Python 用 python.org 版
python3 src/main.py cli info # 环境总览
python3 src/main.py cli verify --province 浙江 --carrier 电信 --out verified.json
python3 src/main.py cli m3u --channels verified.json --outdir ./out
python3 src/main.py # 图形界面(tkinter)
sudo ./WushuangIPTV-CLI capture --seconds 90 # 二进制版抓包需 sudo,其余命令免 root
构建单文件二进制(PyInstaller,不能跨平台交叉编译)
pip install pyinstaller
bash src/build_cli.sh && bash src/build.sh # 产物在 dist/
- CLI 协议与 Windows 完全一致(JSON 输出/退出码),
version显示2.2.1-beta并附beta_note声明; - NAS 推送:挂载目录或
smb://URL(smbclient);WebDAV 不变; - macOS 未签名产物首次打开需右键 → 打开;WSL2 默认 NAT 收不到物理局域网组播(需镜像网络模式或真机);
- 完整差异与注意事项:docs/跨平台说明.md。
鸿蒙PC 精简版(harmony/)
- ArkTS/ArkUI 原生工程(DevEco Studio 6 / API 22):参考库载入(应用内在线更新)、
MulticastSocket 组播实测验证、M3U 生成导出、TCPSocketServer HTTP 转发;
- 不含抓包(鸿蒙第三方应用无原始抓包权限,系统限制);
- 运行:DevEco Studio 打开
harmony/→ 登录华为账号自动签名 → 模拟器/真机;
harmony/build_hap.bat(产物未签名);
- 模拟器只能验证 UI/参考库/M3U,真实收流需鸿蒙PC真机 + 有线接入 IPTV 网络;
- 完整说明:harmony/README.md。
CI 自动构建
推送 v* 标签或手动触发 GitHub Actions:
linux-x64 / macos-x64 / macos-arm64 / windows-x64 四平台自测 + 构建,产物在 Actions Artifacts。
📱 配套 APK
| 文件 | 说明 | |---|---| | apk/WushuangTV.apk | 无双电视 · 电视版 v1.2(约1.6M,安卓4.0+ 老电视/投影仪可用,遥控器/数字选台/收藏) | | apk/WushuangTV-Phone.apk | 无双电视 · 手机版 v1.2(触屏、横屏全屏) |
发行版不内置任何私人播放地址:首次运行在设置里填自己的 M3U 地址即可观看(个人定制构建可固化自家 NAS 转发地址)。 v1.1 起直播缓冲抗抖动调优(WiFi 抖动时「正在连接」遮罩不再反复弹),同签名覆盖安装不丢设置。
🐳 NAS Docker 鉴权转发(docker/)
看直播想 7×24 不依赖 PC、或在外网看自家 IPTV:用 docker/ 的加固版组播→HTTP 转发
(强制 token、频道白名单、并发上限、失败封禁、IGMP 续期、healthcheck;host 网络 + 只读挂载 + 脚本挂载热更新)。
群晖部署含 tv 开机任务依赖(sysctl force_igmp_version=2,Docker host 网络共享内核参数,必须保留)与免 Docker root 任务兜底。
安全口径:内置 proxy 仍仅限局域网、禁止公网映射;docker/ 为知情选择下的个人远程观看例外,token 即密码、播放列表 URL 勿外传,建议配合 HTTPS。
🔧 构建
需要 Python 3.10+、PyInstaller、Pillow(仅生成图标用)。
cd src
pip install pyinstaller pillow
.\build.ps1 # Windows GUI 版,产物在 ..\dist\无双IPTV抓源工具.exe
.\build_cli.ps1 # Windows CLI 版(v2.1),产物在 ..\dist\WushuangIPTV-CLI.exe
# Linux / macOS(测试版)
bash src/build_cli.sh # CLI,产物 dist/WushuangIPTV-CLI
bash src/build.sh # GUI,产物 dist/WushuangIPTV-GUI(macOS 为 .app)
- 默认不内嵌全国参考库(见下),首次运行点「在线更新参考库」即可拉取。
- 如需内嵌:先
python fetch_national.py抓取社区数据到ref/national,再python build_refdb.py,然后构建脚本会自动打包refdb.json.gz(CI 用python src/ci_refdb.py一步完成)。 - 自测:
python selftest.py(48 项,合成数据,无需真实网络);Linux/macOS 另有python3 e2e_posix.py回环端到端冒烟。
📚 参考库数据说明
全国组播参考数据来自社区开源仓库 xisohi/CHINA-IPTV(每日更新)。
出于许可证与隐私考虑,本仓库不直接捆绑该数据;工具在运行时按需下载(仅在你点击更新时联网),或可离线导入 refdb.json。
参考库只是候选地址,各地运营商会调整,一切以本机实测验证为准。
⚖️ 法律与隐私声明
- 本工具仅供个人学习、研究,在自家局域网内自用。接收的是你已付费订阅的 IPTV 服务内容。
- 请勿将抓取的源公开分享、售卖、搭建公网服务供他人观看,或用于任何商业/非法目的;否则可能侵犯著作权/广播组织权并承担法律责任。
- 请勿克隆机顶盒账号获取未付费业务。
- 软件不后台联网、不上传任何数据;不收集任何个人信息。
- 转发服务仅限局域网,禁止映射公网;docker/ 鉴权版为个人远程观看的知情例外(见其 README 安全模型)。
📝 更新历史
见 CHANGELOG.md(Windows v2.2.1:sweep 组播扫频 + 转发剥 RTP/IGMP 续期 + snooping 诊断 + 并发防假失败; v2.2.0:docker/ 鉴权转发 + 无双电视 APK v1.1;Linux/macOS/鸿蒙 v2.2.1-beta 测试版:跨平台移植,未做真机测试,仅供参考)。
📄 License
MIT © 锤无双 (chuiziyao)