Woodox 使用文档

连接手机

第一次连接建议让电脑和手机使用同一个 Wi-Fi。局域网成功后,再决定是否配置公网访问。

连接前检查

一、在电脑端打开配对页面

  1. 打开 Windows 上的 Woodox。
  2. 左侧进入 手机连接
  3. 页面分为 1 安装手机 App2 连接这台电脑
  4. 已经安装 APK 时,点击 我已安装,下一步

二、用手机扫码连接

  1. 打开 Android App

    在首页点击 扫码连接

  2. 允许相机权限

    把取景框对准电脑端“第 2 步:连接这台电脑”的二维码。

  3. 等待连接检查

    App 会自动识别服务地址和访问码,检查电脑是否可用,然后进入控制台。

  4. 保存连接

    连接成功后,这台电脑会出现在手机首页和连接历史中,下次可以直接重新连接。

不用相机:粘贴完整连接链接

  1. 在电脑端展开 复制链接与其他连接方式(高级)
  2. 复制 App 深链或电脑端提供的完整连接链接。
  3. 在手机首页点击 粘贴连接链接,或长按连接链接输入框粘贴。
  4. 点击连接并等待检查完成。

不要把链接拆成地址、访问码等字段手动填写;完整链接可以减少输错。

局域网地址应该是什么样

手机能访问的局域网地址通常类似:

http://192.168.1.20:8787
http://10.0.0.15:8787

不要使用 172.x.x.x 的 WSL 内部地址。这个地址通常只在电脑内部可见,手机无法访问。最稳妥的方法是直接扫描电脑端生成的二维码。

公网连接:为什么显示等待电脑确认

手机第一次通过公网地址连接时,不会立即获得控制权限。按下面操作:

  1. 在手机发起连接

    手机显示“等待电脑确认”或“正在等待电脑端允许”。

  2. 回到 Windows 客户端

    左侧进入 设备管理,查看 等待确认

  3. 核对设备

    确认设备名称、标识和来源是自己的手机,再点击 允许。不认识的设备点击拒绝。

  4. 返回手机重试

    控制台可能自动恢复;如果没有,回到 App 首页再次点击连接。

已经允许的手机会出现在 已允许列表中;不再使用时可以点击 撤销

连接信息的安全区别

内容可以做什么应该怎么分享
APK 下载链接/二维码只下载安装包可以发给目标安装用户
完整连接链接/配对二维码请求连接并控制 Agent 会话只给受信任的手机用户
支持包/诊断文本用于排查,正常情况下已脱敏仍应只发给维护者