开始配对前,请确保满足以下条件
| 项目 | 要求 |
|---|---|
| 手机 | Android 手机,支持 USB 调试 |
| 数据线 | USB 数据线(建议原装线,确保支持数据传输) |
| 电脑 | 已安装 ADB(Android SDK Platform Tools) |
| 客户端 | Python 环境,需安装 uiautomator2 库 |
| 手机端 | 需将 UIAutomator2 安装到手机(见下方步骤) |
客户端基于 Python 开发,需先安装 Python 并配置环境
打开终端/命令提示符,执行以下命令确认安装成功:
python --version
pip --version若提示「不是内部或外部命令」,说明未加入 PATH,需重新安装并勾选 Add to PATH,或手动配置环境变量
部分机型路径:设置 → 系统 → 关于手机 → 版本号
客户端基于 Python + uiautomator2,需将 UIAutomator2 服务安装到手机中
在电脑上安装 uiautomator2 库:
pip install uiautomator2确保手机已通过 USB 连接且 adb devices 可识别,执行以下命令将 UIAutomator2 安装到手机:
python -m uiautomator2 init首次运行会在手机上安装 ATX 等组件,请保持手机解锁并允许安装
Windows:按 Win+R,输入 cmd 回车;或进入 platform-tools 文件夹,按住 Shift 右键选择「在此处打开 PowerShell」
输入以下命令,查看设备是否已连接:
adb devices成功时输出类似:
List of devices attached
XXXXXXXX device状态为 device 表示配对成功,可启动自动托管客户端
下载自动托管客户端,并在 Bot 中获取 API 凭证后输入密钥
从以下地址下载自动托管客户端:
客户端包含 Timex Engine 主程序、ui_config.json、ui_automator_setup.py 等。若需一键安装 UIAutomator2,可运行 python ui_automator_setup.py 选择「完整设置」
在客户端「认证配置」区输入 用户ID、API Key、API Secret,点击「启动监听」
若为 Python 源码版,在解压目录打开终端执行:python real_time_monitor_gui.py
请妥善保管 API Secret,不要泄露给他人
目标:自动托管客户端跑在带公网 IP 的云服务器上,安卓手机留在家里/公司路由器后面(只有内网 IP)。通过 FRP 建立反向隧道,把手机的无线 ADB 端口映射到 VPS,使云端程序能像「手机插在服务器上」一样用 adb 控制手机。
先澄清:是「服务器直接打手机公网/内网 IP」吗?
拓扑简图(文字)
[common]
bind_port = 7001
token = YOUR_STRONG_RANDOM_TOKEN手机用数据线连到已授权 USB 调试的电脑,执行:
adb tcpip 5555
adb connect 192.168.1.100:5555
adb devices
[common]
server_addr = YOUR_VPS_PUBLIC_IP
server_port = 7001
token = YOUR_SECRET_TOKEN
[adb_phone]
type = tcp
local_ip = 127.0.0.1
local_port = 5555
remote_port = 15555在 VPS 上安装 Android Platform Tools,确保命令行可执行 adb。确认 frpc 已在 frps 侧注册成功后,在 VPS 执行(15555 改为你的 remote_port):
adb connect 127.0.0.1:15555
adb devices
| 问题 | 解决方法 |
|---|---|
| adb 不是内部或外部命令 | ADB 未安装或未加入 PATH。请下载 Platform Tools 并配置环境变量,或在 platform-tools 目录下打开终端执行 |
| 设备显示 unauthorized | 手机未授权。请查看手机屏幕是否有「允许 USB 调试」弹窗,勾选始终允许后点击允许 |
| 设备列表为空 | 检查数据线是否支持数据传输、USB 模式是否选为文件传输、电脑是否安装手机驱动(Windows 可尝试安装手机厂商驱动) |
| 连接后自动断开 | 更换数据线或 USB 接口,关闭省电模式,部分机型需在开发者选项中开启「USB 调试(安全设置)」 |
| uiautomator2 init 失败 | 确保 adb devices 已识别设备,手机已解锁,允许安装未知来源应用。部分机型需关闭 MIUI 优化或类似限制 |
| FRP 显示在线但 VPS 上 adb connect 失败 | 查看 frpc / frps 日志是否报错;核对 remote_port 与安全组是否一致;在内网机器上先 adb connect 手机IP:5555 确认无线 ADB 仍有效;检查 VPS 上端口是否被其它进程占用。 |
| 隧道经常断或 frpc 被杀 | 为 Termux/frpc 关闭电池优化、允许后台;换 WiFi/流量后确认仍能访问 frps;重启后若无线 ADB 关闭,需再 USB 执行 adb tcpip 5555;必要时用脚本守护 frpc 自动拉起。 |
| 这样安全吗? | 取决于你的配置。请把 FRP 与防火墙当作生产环境对待:强随机口令、最小暴露面、优先加密与访客模式。不要将 token 或映射端口泄露给不可信第三方。 |
当你想把 AI 托管从一台手机切换到另一台手机时,请按下面步骤操作:
在 Telegram Bot 中打开「托管设备管理」,点击「🗑️ 删除设备」完成解绑。
断开旧手机连接,连接新手机,并按上文完成开发者选项、USB 调试和币安事件合约界面准备。
在新环境中启动客户端,输入 用户ID / API Key / API Secret,然后在 Bot 内重新开启 AI 智能托管,系统会自动绑定当前在线设备。
建议在手机「设置 → 显示」中关闭自动熄屏,或将熄屏时间设为「永不」