24小时无人直播 · 完整上线对照清单

已选定的服务器与端口规划 规划已落实

这台机器是什么

防火墙当前已放行：22, 80, 443, 2222, 8000, 8020。8000 虽在防火墙里，但进程只听 127.0.0.1，外网进 ERIS 走的是 443。8020 是本项目调试直连，DNS/HTTPS 稳定后可再关掉公网 8020。

本项目的端口与入口（已按此表落地）

外网浏览器（推荐）
  https://live.hugme2.com/dashboard     ─┐
  https://live.hugme2.com/phone         ─┼─ nginx:443 新 server（已配证书）──→ 8020  本程序（已在跑）
  https://live.hugme2.com/setup         ─┘
  （公网打开域名前，先确认 live 的 A 记录已保存）

调试直连（可选）
  http://67.216.204.137:8020/dashboard  ──→ 0.0.0.0:8020（需临时放行防火墙）

已有、不要动：
  https://hugme2.com/                   ──→ 127.0.0.1:8000   ERIS API
  https://hugme2.com/admin              ──→ :3000
  https://hugme2.com/news/              ──→ 127.0.0.1:8765
  https://hugme2.com/tiktok-monitor/    ──→ 127.0.0.1:8766   旧监控看板

手机 WDA：
  服务器 ──HTTP──→  手机 100.x.x.x:8100   （Tailscale）
            或 ──→  家宽公网:18101        （端口映射到手机 8100）

阶段 0 · 先看懂现在怎么跑 已完成

完整跑起来之后，日常只有两样东西在工作：

iPhone（TikTok + WebDriverAgent 端口 8100）
        ↑
        │  Wi-Fi / VPN / 端口映射，HTTP
        │
直播服务器（本程序，AlmaLinux 上听 127.0.0.1:8020）
  · 公网看板：https://live.hugme2.com/dashboard
  · 手机接入：https://live.hugme2.com/phone

中间不再放一台 Windows/Mac 中控机，也不用 USB / iproxy 日常控机。

阶段 1 · 备齐硬件（先买最小套）

最小可跑（必须先齐，否则不要往下做）

要做 24 小时无人值守，再加这些

阶段 2 · 备齐软件、账号、资料

软件

账号与资料（提前登记到一张纸/表格里）

阶段 3 · 打通「服务器 → 手机 8100」（最容易卡死）

成功标准只有一句：在服务器上访问 http://手机地址:8100/status 能返回 JSON，而不是超时。

从下面三种方案里选一种，不要混用。

方案 A：服务器和手机在同一个 Wi-Fi（最快，适合先跑通）

1. 手机和服务器都连同一个路由器（不要一个连 Wi-Fi、一个连访客网络）。
2. 手机：设置 → WLAN → 点当前 Wi-Fi 右边的 ⓘ → 记下「IP 地址」，例如 192.168.1.101。
3. 在路由器里把该手机改成「静态 IP / DHCP 绑定」，避免第二天 IP 变了。
4. 电脑/服务器浏览器或命令行访问：http://192.168.1.101:8100/status（WDA 装好后才有数据，现在先把 IP 记下来）。
5. configs/devices.yaml 的 wda_host 就填这个局域网 IP。

方案 B：服务器在云上，手机在家里 —— 用 Tailscale（正式推荐）

1. 去 https://tailscale.com 注册，在服务器安装 Tailscale 并登录。
2. 在每台 iPhone 安装 Tailscale，用同一个账号登录，打开 VPN。
3. 在 Tailscale 管理后台看到手机的 100.x.x.x 地址。
4. wda_host 填这个 100.x.x.x，端口仍是 8100。
5. 手机 Tailscale 保持连接，不要省电杀掉后台。

方案 C：云服务器 + 路由器端口映射（不装 VPN 时）

1. 登录家里路由器「虚拟服务器 / 端口转发 / NAT」。
2. 外网端口例如 18101 → 内网 192.168.1.101:8100（第二台用 18102 → 第二台 8100，以此类推）。
3. 手机必须是固定内网 IP。
4. wda_host 填云服务器能访问的公网 IP，wda_port 填 18101 这种外网端口。
5. 在云服务器安全组放行这些端口；家里如果是运营商大内网（没有公网 IP），方案 C 会失败，改用方案 B。

阶段 4 · 把本程序在服务器上跑起来 已完成

4.1 本机 Windows 只用来对照界面（可选）

你电脑上可以继续用 8000 看界面。正式 24 小时跑在 AlmaLinux 上，端口必须是 8020，见「实机与端口规划」。

1. 打开 PowerShell，进入工程目录：

   cd C:\Users\13267\Desktop\产品\24newtiktok\code\project

2. 用记事本或编辑器打开 .env，确认至少这些值：

   HOST=0.0.0.0
   PORT=8000
   API_KEY=dev-local-key
   PUBLIC_URL=http://127.0.0.1:8000
   ENABLE_VIRTUAL_AGENT=true

   若你要从手机浏览器打开看板，把 PUBLIC_URL 改成 http://这台电脑的局域网IP:8000。
3. Windows 防火墙放行 8000：Win + S 搜「允许应用通过防火墙」→ 高级设置 → 入站规则 → 新建 → 端口 → TCP 8000 → 允许。
4. 启动服务（本机已有便携 Python，不必再装）：

   .\.python\tools\python.exe run.py

   看到类似 Uvicorn running on http://0.0.0.0:8000 才算启动成功。窗口不要关。
5. 电脑浏览器打开：

   http://127.0.0.1:8000/health
   http://127.0.0.1:8000/dashboard
   http://127.0.0.1:8000/phone
   http://127.0.0.1:8000/setup

   /health 应返回 {"status":"ok",...}。看板右上角密钥填 dev-local-key，点保存。

4.2 部署到已选定的 AlmaLinux（67.216.204.137）已完成

这些步骤已在 2026-08-14 执行完毕。下面仅作对照，不要重复部署。

1. SSH（端口 2222）：

   ssh -i "C:\Users\13267\.ssh\eris_67.216.204.137" -o IdentitiesOnly=yes -p 2222 root@67.216.204.137

2. 代码放到 /opt/24newtiktok（不要覆盖 /opt/eris、/opt/eris-TIKTOK、/root/tiktok-monitor）。Windows 便携目录 .python 不要上传。
3. 用系统自带的 Python 3.12 建独立虚拟环境：

   /usr/bin/python3.12 -m venv /opt/24newtiktok/.venv
   source /opt/24newtiktok/.venv/bin/activate
   pip install -r /opt/24newtiktok/requirements.txt

4. .env 已写成（不要抄 Windows 的 8000；不要再改成 dev-local-key）：

   HOST=0.0.0.0
   PORT=8020
   PUBLIC_URL=https://live.hugme2.com
   API_KEY=（已换成独立长密钥，只存在服务器 .env）
   ENABLE_VIRTUAL_AGENT=false

   当前是调试直连：HOST=0.0.0.0 且防火墙放行 8020。DNS 稳定后可改 HOST=127.0.0.1 并关掉公网 8020。
5. systemd 新建 /etc/systemd/system/tiktok-live.service（名字不能叫 tiktok-monitor）：

   [Unit]
   Description=24h tiktok live controller
   After=network.target
   
   [Service]
   WorkingDirectory=/opt/24newtiktok
   ExecStart=/opt/24newtiktok/.venv/bin/python run.py
   Restart=always
   
   [Install]
   WantedBy=multi-user.target

6. DNS：给 live.hugme2.com 加 A 记录指向 67.216.204.137。然后新增 nginx 配置文件（例如 /etc/nginx/conf.d/tiktok-live.conf），不要改 eris.conf 里现成的 location /：

   server {
       listen 80;
       server_name live.hugme2.com;
       location / { return 301 https://$host$request_uri; }
   }
   server {
       listen 443 ssl;
       server_name live.hugme2.com;
       ssl_certificate     /etc/letsencrypt/live/live.hugme2.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/live.hugme2.com/privkey.pem;
       location / {
           proxy_pass http://127.0.0.1:8020;
           proxy_http_version 1.1;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto https;
           proxy_read_timeout 300s;
       }
   }

   证书已用 certbot 签好 live.hugme2.com。配置文件已是 /etc/nginx/conf.d/tiktok-live.conf。不要改 eris.conf。
7. 验证（已通过）：

   http://67.216.204.137:8020/health
   http://67.216.204.137:8020/dashboard
   http://67.216.204.137:8020/phone
   http://67.216.204.137:8020/setup
   
   # DNS 保存并生效后再用：
   https://live.hugme2.com/health
   https://live.hugme2.com/dashboard
   https://live.hugme2.com/phone
   https://live.hugme2.com/setup

   同时确认这些旧地址仍然正常：https://hugme2.com/、/admin、/news/、/tiktok-monitor/。

阶段 5 · 用 udidregistrations.com 把 WDA 装进 iPhone 下一步

5.1 打开订单，确认你买到的是哪一档

用下单邮箱打开确认信，或到网站查订单。对照下表，Bronze 不够装 WDA。

邮件/订单页里常见这些文件（官网写 .p12 默认密码是 123456）：

• xxxx.p12 — 签名证书
• Profile.mobileprovision 或类似名字 — 描述文件（必须包含这台手机的 UDID）
• 有的卖家还会另附一份已经签好的 WDA.ipa 或一个 Safari 安装链接 —— 有这个就更省事

5.2 准备一份 WDA 安装包（.ipa）

证书只能「盖章」，不能凭空变出 WDA。按你手里有什么选一条：

1. 订单里已经有 WDA.ipa 或「Install」链接：跳到 5.3，直接装。这是最常见、也最省事的情况。
2. 只有证书，没有 IPA：向给你这个网站链接的人再要一份 WebDriverAgentRunner-Runner.ipa（未签名或已签名均可）。我们服务器要的是能在手机上监听 8100 的 WDA，不是随便一个 App。
3. 不要去装该网站宣传的越狱工具。本项目只需要 WDA，越狱既不需要，也更容易把手机搞挂。

5.3 把 WDA 装到这台已经登记过 UDID 的 iPhone 上

只做下面三条路里的一条。UDID 必须是这台手机的，换机要重新买/走换机政策。

路 A：已经有「安装链接」（最快）

1. 用 iPhone 自带 Safari（不要用微信内置浏览器）打开安装链接。
2. 点 Install / 安装，等到主屏幕出现 WDA 图标（名字可能是 WebDriverAgent、WebDriverAgentRunner-Runner、或卖家改过的名字）。

路 B：Platinum，用官网推荐的在线签名（不用 Mac）

1. 打开官网说明：sign-apps。
2. 打开 IPA Signer，填入这台手机的 UDID，上传 WDA.ipa，点 Sign App。
3. 签完后点 Install App；若是在电脑上操作，下载签好的 IPA，再发到 Diawi 生成链接，用手机 Safari 打开安装。

路 C：Silver / Gold，用 Mac 的 iOS App Signer（官网标准流程）

1. 订单页点 Certificate & Provisioning Files，下载 .p12 和 .mobileprovision。
2. 双击 .p12 导入钥匙串，密码按官网默认 123456（若邮件写了别的密码，用邮件的）。
3. 下载并打开 iOS App Signer（Mac）。Input File 选 WDA.ipa。
4. Signing Certificate 选刚导入的那张；Provisioning Profile 选「Choose Custom File」指向你的 .mobileprovision。
5. 点 Start，得到签好的 IPA。
6. 安装任选其一：把 IPA 丢到 Diawi，手机 Safari 打开链接安装；或用数据线 + Mac 上的 Apple Configurator，选设备 → Add → Apps → 选 IPA。

5.4 信任证书并启动 WDA（装上不等于在跑）

1. iPhone：设置 → 通用 → VPN 与设备管理（有的系统叫「描述文件与设备管理」）→ 点刚装上的企业/开发者证书 → 信任。
2. 若提示「未受信任的企业级开发者」，必须联网完成信任，否则一点图标就闪退。
3. iOS 16 及以上若打不开：设置 → 隐私与安全性 → 打开「开发者模式」，重启后再确认一次。
4. 回到桌面，点开 WDA 图标。有的版本会停在一个空白页或显示 IP，这是正常的，不要划掉。
5. 设置 → 显示与亮度 → 自动锁定 → 永不。关掉低电量模式。插上充电。
6. 记下手机 IP（设置 → WLAN → ⓘ），用电脑浏览器或命令访问：

   http://手机IP:8100/status

   成功会看到一段 JSON（里面常有 ready 或 sessionId）。这就是服务器以后要打的地址。
7. 把桌面上这个 App 的名字/包名记下来，填进 configs/devices.yaml 的 wda_bundle_id。若不知道包名，先保持默认 com.facebook.WebDriverAgentRunner.xctrunner；探活只靠 IP:8100，包名主要给以后重启 App 用。

备选：如果你其实有自己的付费 Apple 开发者账号和 Mac，也可以不用这个网站，改用 Xcode 打开官方 WebDriverAgent.xcodeproj，选 WebDriverAgentRunner → Product → Test。对已经买了 udidregistrations 的人来说，不必再走这条。

阶段 6 · 准备 TikTok 与手机系统

1. 安装 TikTok（或抖音），用目标账号登录。
2. 完全用手指走一遍开播：打开 App → 点直播 → 点开始直播 → 确认推流成功 → 再手动关播。这一步失败，自动化一定失败。
3. 把开播路径上每一个按钮的屏幕文字记下来（中文或英文以你的界面为准），例如「直播」「Go LIVE」「开始直播」「结束」「结束直播」。
4. 授权：相机、麦克风、本地网络（iOS 会问，WDA/TikTok 都可能要）。
5. 通知不要把直播相关权限关死。勿给 TikTok 开「低电量限制后台」之类会杀进程的设置。
6. 关掉会打断直播的：屏幕使用时间严格限制、突然的系统更新（设置里推迟）、自动亮度可关以免画面乱跳。
7. 手机固定在支架上，镜头对好，开始充电。

阶段 7 · 让服务器接入这台手机

1. 打开 code\project\configs\devices.yaml，按实机修改（不要留示例 IP 192.168.1.101 除非真的是它）：

   devices:
     - id: iphone-01
       alias: "账号A"
       account_id: "acct_001"
       model: "iPhone 13"
       wda_host: "这里填服务器能访问到的手机地址"
       wda_port: 8100
       wda_bundle_id: "你在 Xcode 里实际签出来的 xctrunner 包名"
       app_bundle_id: "com.zhiliaoapp.musically"
       enabled: true

   方案 B 时 wda_host 填 Tailscale 的 100.x.x.x；方案 C 时端口改成外网映射端口。
2. 可选：用手机 Safari 打开 https://live.hugme2.com/phone，填同样的设备 ID、WDA 地址、密钥，点「接入服务器」。yaml 和网页两种方式填一种即可，yaml 适合固定机位。
3. 改完 yaml 后必须重启 run.py（关掉旧窗口再启动一次）。网页 /phone 接入则不必重启。
4. 在服务器上做探活（Windows）：

   cd C:\Users\13267\Desktop\产品\24newtiktok\code\project
   .\.python\tools\python.exe scripts\smoke_test_wda.py --device-id iphone-01

   成功会打印 alive 一类状态，并在 data\screenshots\iphone-01\ 落下 PNG 截图。打开那张图，确认就是这台手机当前画面。
5. 打开看板 https://live.hugme2.com/dashboard，设备应显示在线（服务器每约 10 秒自己探活，不需要电脑 Agent 心跳）。

阶段 8 · 校准开播 / 关播按钮

程序不会「看懂」你的直播间，它只按控件名字点。文件在：

• 开播：code\project\configs\playbooks\start_live.yaml
• 关播：code\project\configs\playbooks\stop_live.yaml

当前默认开播会依次尝试这些字：直播 / LIVE / Go LIVE / 开始直播 / 进入直播，然后 开始直播 / Go LIVE / Start live / 开播。

1. 看阶段 7 的截图，或看手机屏幕，核对按钮实际文字是否在上面的列表里。
2. 若你的界面是别的语言或改版按钮（例如只有「视频」旁边一个直播图标、文字是 「Go LIVE」），把那几个字原样加进对应 names: 列表，放在最前面。
3. 关播同理，必须包含你结束直播时弹出的确认按钮文案。
4. 改完 yaml 不必编译，但正在跑的一次任务不会自动重读中间状态；下一次开播/关播任务会用新文件。
5. 若控件没有文字、只有图标：需要改用坐标点击。在 playbook 里加：

   - action: tap_xy
     x: 390
     y: 2400

   坐标是屏幕像素，必须按你的机型试。先用截图估位置，失败就微调。不同分辨率不要共用一套坐标。

阶段 9 · 单机完整跑通（到这里才算「能跑」）

1. 手机亮屏、WDA 仍在、TikTok 已登录、不要停在别的 App 强制更新页。
2. 看板确认设备在线。默认注册后会有 00:00–24:00 节目单，auto_live=true 时服务器会自动下发开播。
3. 若没有自动开播，用看板所在电脑执行（把密钥换成你的）：

   curl -X POST https://live.hugme2.com/tasks -H "X-API-Key: 你的密钥" -H "Content-Type: application/json" -d "{\"task_id\":\"manual-start-1\",\"device_id\":\"iphone-01\",\"task_type\":\"start_live\",\"payload\":{\"content_id\":\"opening\"},\"priority\":\"high\"}"

   Windows PowerShell 更稳妥的方式是用看板观察：节目单会自己 enqueue；也可在手机接入后再等一个监控周期（约 10 秒）。
4. 盯着手机：应看到自动打开 TikTok → 点到直播 → 进入直播。失败时看板「服务器事件记录」会有 Wi-Fi 开播控制失败 或 未找到任一控件。
5. 失败就回到阶段 8 改文案，或确认 WDA /status 是否还通。
6. 成功开播后，再下发关播（或把节目单结束时间改到当前时间之前），确认能结束直播。
7. 看 data\screenshots\iphone-01\ 是否持续有新图；看看板人数/状态（人数依赖后续截图识别，第一次以「真的在播」为准）。
8. 人为点出一个警告弹窗（不要真去违规，可用测试文案出现在控件树时再验证），确认看板会弹出警告并写入记录。

阶段 10 · 做成 24 小时无人值守

1. 供电：手机 24 小时插电。充电器接触良好。有条件上 UPS 给路由供电。
2. 散热：手机不要叠在一起、不要捂在盒子里。发烫就加小风扇，否则会自动降低亮度甚至关机。
3. 锁屏：自动锁定=永不。WDA 在锁屏后通常点不了 TikTok。
4. WDA 保活：不要划掉 WDA Runner。系统更新、内存紧张、证书过期都会让它死。付费开发者证书按年续签；免费的 7 天必挂。
5. 节目单：默认就是全天。需要分段时，用接口或改存储里的 playlist（设备注册后自动 00:00–24:00，约 45 分钟切一次内容，由 CONTENT_SWITCH_MINUTES 控制）。
6. 网络：手机 Wi-Fi 不要休眠。路由器关闭「无线定时关闭」。方案 B 时 Tailscale 禁止被 iOS 杀后台（可考虑锁定/屏幕常亮）。
7. 服务器进程：Windows 上不要关那个 run.py 窗口，电脑不能休眠（电源选项：从不休眠）。Linux 用阶段 4.2 的 systemd。
8. 先灰度：1 台机连续跑 24 小时，把掉线原因记下来（WDA 死、Wi-Fi 掉、TikTok 弹窗、发热关机），再扩第二台。

.env 里和无人值守相关的项：

HEARTBEAT_TIMEOUT_SECONDS=30
MONITOR_INTERVAL_SECONDS=10
MAX_RECOVERY_ATTEMPTS=3
CONTENT_SWITCH_MINUTES=45
VIEWER_DROP_PERCENT=70
ALERT_WEBHOOK_URL=   # 填企业微信/钉钉/自定义 webhook，空则只记到看板

阶段 11 · 多机扩容

1. 第二台 iPhone 重复阶段 5～9（每台都要单独签一次 WDA，或同一开发者账号装到多台设备）。
2. 在 devices.yaml 增加第二段，id 换成 iphone-02，wda_host 必须不同。 同一 IP 同一端口会被程序拒绝。
3. 方案 C 时：每台手机映射不同的公网端口。
4. 每台一个 TikTok 账号，不要多台挤同一个号。
5. 重启服务或分别在 /phone 接入。
6. 看板应出现两行设备，各自在线、各自节目单。

阶段 12 · 告警与日常运维

1. 看板每天至少看两次：在线数、是否在播、未确认警告。
2. 日志文件：code\project\logs\controller.log；事件也在看板下方。
3. 截图：code\project\data\screenshots\设备ID\。
4. 警告关键词在 configs\rules.yaml 的 dialog_keywords。你的 TikTok 语言不是中/英时，把界面里的词加进去。
5. 把 .env 的 ALERT_WEBHOOK_URL 配到你现有的通知地址（若有），这样不用一直盯网页。
6. 证书：udidregistrations 订单到期前续费；被吊销就到订单页下新证书，重新签装 WDA，再在手机上点开。
7. TikTok 大版本更新后，按钮文案可能变，回到阶段 8 校准。
8. 不要运行 scripts\wda_agent.py（已停用）。不要再插 USB 当日常方案。

附录 · 常见失败对照