通过 ADB 审计 Android TV 和 Google TV 设备是否存在 BadBox、XCPE 和 Vo1d 恶意软件,并配备 VPN 流量哨兵、IoC 黑名单和可逆修复功能。
一套自主的双层取证、恶意软件清除与可逆修复套件(CLI + 原生 Android TV 应用,内置本地回环 VPN 哨兵),专为审计、检测、验证、清除并恢复被供应链木马、僵尸网络和恶意软件(BadBox、XCPE、Vo1d、Fuyao、Videostrong/SZBBOYS 及住宅代理软件)入侵的 Android TV、Google TV 及通用流媒体设备而设计。
语言: 英语(默认)| Para a versão em Português (PT-PT), consulte README.pt.md | 📱 已测试设备登记表 | 🔬 架构决策记录(ADR) | 📜 第三方声明
成千上万的低价 Android TV 盒子与智能电视出厂即被预装感染,或通过恶意流媒体应用和被植入木马的固件遭到入侵。这些恶意软件通常会:
package_verifier_user_consent = -1 静默关闭 Google Play 保护机制。/system 或 /vendor 分区(可抵御恢复出厂设置)。本套件提供两条完整的审计与清理路径:
audit_security.py),具备子网发现、节省 token 的纯 JSON 模式、强制备份、APK 隔离以及防注入的参数化回滚功能。在运行工具或派遣 AI 代理之前,请在电视上启用 ADB 调试,以便通过 Wi-Fi 对其进行审计:
[!WARNING] 🔒 安全最佳实践(完成后请关闭调试):
在家庭 Wi-Fi 网络上永久启用 ADB / USB 调试会暴露一个管理端口(5555),本地网络上的其他设备或恶意应用理论上可以探测该端口。
审计和修复完成后,请务必记得在开发者选项中关闭 USB 调试!
本仓库在 AGENTS.md 中包含了自包含的操作指南,现代 AI 编程智能体会自动遵循这些指南。你无需手动配置 Python、安装驱动或编写命令。
[!IMPORTANT] 🛡️ 面向 AI 智能体的安全自主工作流:
始终指示 AI 智能体先运行--quick-scan(100% 只读诊断)。在执行--remediate之前,请先审阅技术发现和修复计划。
只需打开你的 AI 智能体并发送这一条提示词:
Clone https://github.com/Mafarricos/badbox-tv-audit.git, read AGENTS.md, and audit my Android TV at IP <TV_IP>.
(提示:如果你不知道电视的 IP 地址,可以询问智能体:...read AGENTS.md, discover my Android TV devices on subnet 192.168.1.0/24, and audit them.)
智能体将自主执行以下操作:
AGENTS.md 以获取取证说明。community_audit_submission.json),可用于帮助更新受感染设备数据库。app/)该应用会自动本地化(如果设备语言为葡萄牙语则显示葡萄牙语;其他所有语言则显示英语),并且 100% 支持方向键导航:
/oem/、/vendor/、Play Protect 完整性、木马痕迹(Vo1d、XCPE),并检查软件包签名。[CRITICAL]): 如果电视向已知 C2 服务器或恶意域名发起连接。[SUSPICIOUS]): 如果连接到已知僵尸网络/代理端口,但未匹配到已知 C2 IP/域名。[ANOMALY]): 如果在电视空闲时检测到异常的高端口网络流量。监控期间网络连接说明: 在 VPN 哨兵运行窗口期间,DNS 查询(UDP 端口 53)会被主动检查并转发,以便恶意域名查询能够成功,而直接的 TCP/UDP 数据包会在回环接口中被检查并丢弃。因此,在监控激活期间,常规互联网浏览/流媒体会暂时暂停,一旦停止 VPN 便会立即恢复。
android.uid.system(UID 1000,例如 com.oemservice)的出厂软件包,会跳过 VPN 隔离,以免阻断核心 Android 系统服务,应用会显示冻结它们所需的确切 ADB 命令(adb shell pm disable-user --user 0 <package>)。同时说明 Android TV 设置会对平台签名的系统应用禁用图形化“停用”按钮(canDisable=false)。为防止二进制供应链攻击破坏仓库完整性,密钥库和预构建 APK 不会纳入 git 跟踪(SEC-01)。
xcpe-scanner-tv.apk)到 tools/,并使用 apksigner 对照 tools/apk_pin.json 进行验证。你也可以从 GitHub Releases 手动下载并放置到 tools/xcpe-scanner-tv.apk。./gradlew assembleDebug 在本地构建应用,流水线会检测到本地构建,并在给出明确安全警告的情况下允许使用调试密钥。cd app && ./gradlew assembleDebugcd app && ./gradlew testDebugUnitTestdocs/RELEASE_SIGNING.md该套件会自动检测你的系统语言(国际用户默认为英语,如果你的操作系统为葡萄牙语则默认为葡萄牙语)。你也可以使用 --lang en 或 --lang pt 显式强制指定语言。
--quick-scan):100% 只读,耗时 5-10 秒,不在设备上安装任何内容。审计所有已知威胁家族(XCPE、BadBox、Vo1d、投放器、活跃 C2 套接字以及 Play Protect 状态)。--auto-pipeline):部署设备端 TV 应用(com.scanner.tv),启动本地 VPN 回环 20-60 秒以检查实时 DNS/IP 流量,寻找未知或休眠的僵尸网络,拉取报告、评估规则,并自动干净地卸载该应用。# 1. Intensive Dynamic Audit (Installs APK, runs 20s VPN sentinel for unknown threats, and cleans up)
python tools/audit_security.py <TV_IP> --auto-pipeline
# 2. Fast 6-Layer ADB Read-Only Scan (Known threats triage - Standard or Token-Saving Pure JSON)
python tools/audit_security.py <TV_IP> --quick-scan
python tools/audit_security.py <TV_IP> --quick-scan --json
# 3. Discover and Audit all Android TVs across the Home Subnet
python tools/audit_security.py --scan-subnet 192.168.1.0/24
# 4. Multi-Layer Deep Remediation with Preview Plan (--dry-run)
python tools/audit_security.py <TV_IP> --remediate --dry-run
python tools/audit_security.py <TV_IP> --remediate
# 4.1 Non-Interactive Remediation for AI Agents (requires explicit --yes)
python tools/audit_security.py <TV_IP> --remediate --yes
# 4.2 Remediation with Post-Reboot Persistence Check & Cloudflare DoT
python tools/audit_security.py <TV_IP> --remediate --yes --verify-reboot --enable-dot
# 5. Restore Previous State (Rollback from snapshot)
python tools/audit_security.py <TV_IP> --restore --backup backups/<device_id>/backup_<timestamp>.json
# 6. Export C2 Domain Blocklists (for Pi-hole, AdGuard, dnsmasq, /etc/hosts)
python tools/export_blocklist.py --format all
# 7. Validate Canonical IoC Database Schema
python tools/validate_iocs.py
帮助我们追踪哪些 Android TV 和 Google TV 型号出厂时带有 dropper 或干净的固件!
每当执行审计时(通过 --quick-scan 或 --auto-pipeline),该套件会自动生成一份匿名化报告,路径为:
community_audit_submission.json
[Device Audit] <Brand> <Model>(例如 [Device Audit] Strong 4K Google TV Stick)community_audit_submission.json 的内容。community_audit_submission.json 文件直接发送至 YouTube 频道公布的邮箱:[email protected](主题:TV Audit Report: <Brand> <Model>)。您的报告将经过审核并合并到官方的已测试设备注册表(DEVICES.md)中!