Woodox 使用文档

通过公网中转服务连接手机

当前版本通过 WSS 密文中转建立 Noise 端到端加密会话。先让电脑端后台和中转连接在线,再用 Android App 扫码;新手机必须在电脑端批准。

连接前检查

一、在电脑端打开手机连接

  1. 打开 Windows 上的 Woodox。
  2. 确认顶部没有“后台离线”或“中转未连接”提示。
  3. 左侧进入 “手机连接”。
  4. 页面分为 “1 安装 Android App”和“2 连接这台电脑”。
  5. 已经安装 APK 时,切换到第二步查看当前连接二维码。

二、用 Android App 扫码

  1. 打开 Woodox

    在手机首页点击 “扫码连接”。

  2. 允许相机权限

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

  3. 建立安全会话

    App 会连接 WSS 中转、执行 Noise 握手,并核对电脑身份公钥、协议版本和设备审批状态。

  4. 看到等待提示后回到电脑

    新设备的正常结果是“等待电脑确认”,不是网络故障。

三、在电脑端批准新设备

  1. 打开设备管理

    Windows 客户端会显示待审批提示;也可以从左侧进入 “设备管理”。

  2. 核对设备

    检查手机名称、设备标识和最近请求时间。只允许自己刚刚使用的设备。

  3. 点击允许

    不认识的设备选择拒绝。允许后,手机会定期检查状态并自动继续;没有恢复时手动点一次重新检查。

  4. 确认进入会话

    手机顶部显示在线,并能看到电脑端当前会话与版本信息,说明绑定完成。

不用相机:粘贴完整连接信息

  1. 在电脑端 “手机连接”展开复制入口。
  2. 复制 App 深链或完整连接链接。
  3. 在 Android 首页选择 “粘贴连接链接”并粘贴完整内容。
  4. 发起连接,然后按上一节在电脑端批准新设备。

不要把地址、token 和保护码拆开手填。使用完整内容可以减少遗漏,但它也应按敏感凭据保管。

设备状态与操作

状态 / 操作结果适用场景
已允许手机可携带有效凭据访问电脑端 Woodox。自己的常用设备
撤销立即阻止该设备继续访问,但电脑保留记录用于识别。手机丢失、转让或暂不再用
恢复重新允许一条仍保留的已撤销记录。确认设备仍可信
永久删除只能删除已撤销记录;下次连接会作为新设备重新审批。清理不再需要的历史记录
重置全部连接轮换访问凭据,旧二维码和旧链接失效;可同时清空设备授权。怀疑完整连接信息泄露

连接信息的分享范围

内容能力处理方式
官网下载链接访问公开下载页可以公开
APK 下载二维码下载安装包只确认来源与 SHA256
连接二维码 / 完整链接向指定电脑发起访问并携带连接凭据仅在受控场景交给自己的手机
一次性中转接入密钥登记一台电脑的中转身份仅交给指定用户,使用后不要复用
支持包提供脱敏诊断信息发送前人工检查,只交给维护者

继续阅读共享或自建公网中转服务接入 →