DuoDesk
简体中文

支持

常见问题都在这里。没找到答案的话，写信给我们。

连接

连不上 Mac 怎么办？

先看 iPhone 上的 Mac 列表里，这台 Mac 显示「在线」还是「离线」。

显示离线：Mac 上的 DuoDesk Host 没在运行、Mac 睡着了，或者 Mac 没联网。

  • 确认 Mac 菜单栏里有 DuoDesk 图标。没有的话，从「应用程序」里打开 DuoDesk Host。
  • 按下载页「让 Mac 随时连得上」里的建议，别让 Mac 睡着。
  • 开着 FileVault 的 Mac 重启后，要先有人在 Mac 前登录一次。

显示在线但连不上：

  • 把 iPhone 上的 DuoDesk 和 Mac 上的 DuoDesk Host 都更新到最新版，再试一次。
  • 手机提示「Mac 在等屏幕录制的确认」：macOS 正在等人确认屏幕录制权限，需要有人在 Mac 上点「允许」。
  • 手机提示 Mac 不认这部手机：这部手机可能在 Mac 上被移除了，按下面「重新配对」的步骤再配一次。

还是不行的话，点 Mac 上 DuoDesk 菜单里的「连接记录…」，把最后几十行和问题一起发给我们。

支持哪些网络？手机和 Mac 要在同一个 Wi-Fi 吗？

不用在同一个网络。只要两边都能上网就行：家里或办公室的 Wi-Fi、蜂窝网络、酒店和咖啡馆的网络都可以。也不需要 VPN 或 Tailscale。

DuoDesk 先尝试让两台设备点对点直连（同一个局域网里直接连，不同网络就打洞）。直连不通时，比如有些公司或共享办公的 Wi-Fi 不让设备互相访问，会自动改走 Cloudflare 的中转。无论走哪条路，画面和输入都是端到端加密的。

DuoDesk 的连接基于 UDP。如果所在网络屏蔽了 UDP（少数公司和公共网络会这样），可能连不上，可以换成蜂窝网络试试。

用着用着断了怎么办？

一般不用管。网络切换（比如从 Wi-Fi 换到蜂窝网络）或短暂断网时，App 会自动重连，几秒内画面就回来，期间不会发送你的操作。

切到别的 App 再回来也会自动重连；离开超过 5 分钟要重新过 Face ID。

权限

DuoDesk Host 为什么需要「屏幕录制」和「辅助功能」？

屏幕录制用来采集 Mac 的画面，发到你的 iPhone 上。辅助功能用来把手机上的点按、滚动和键盘输入交给 Mac 执行。

两项权限只在配对过的 iPhone 连着时使用，画面不会录下来或保存。

菜单里显示「未授权」，或者权限突然没了
  1. 打开系统设置 › 隐私与安全性，分别进入「录屏与系统录音」和「辅助功能」。
  2. 确认 DuoDesk Host 是打开的。已经打开还是不行的话，先关掉再打开；还不行就选中它、点「−」删除，再回到 DuoDesk 菜单点「授权」重新添加。
  3. 改过屏幕录制权限后，需要退出并重新打开 DuoDesk Host。
为什么每个月又问一次屏幕录制？

这是 macOS 的规定，大约每 30 天会让你再确认一次。弹出时如果手机上还能看到画面，直接在手机上点「允许」即可；如果画面已经被拦住，手机会提示「Mac 在等屏幕录制的确认」，需要有人在 Mac 上点。

配对

怎么重新配对，或者添加另一部手机？

在 Mac 的 DuoDesk 菜单里点「配对新手机…」，在 iPhone 上的 DuoDesk 首页点「扫码添加 Mac」扫描二维码。换了新手机、重装了 App，或者手机在 Mac 上被移除了，都这样重新配一次。

二维码 5 分钟内有效、只能用一次。提示「配对码已过期或已经用过」时，在 Mac 上重新点「配对新手机…」再扫。

怎么移除一部手机或一台 Mac？
  • 在 Mac 上移除手机：DuoDesk 菜单里能看到已配对的手机，点「移除」后它就连不上了，想再用必须重新扫码。
  • 在 iPhone 上删除 Mac：在 Mac 列表里向左滑动这台 Mac，点删除。
提示「这个二维码不支持远程连接」

Mac 上的 DuoDesk Host 版本太旧。请从下载页下载最新版，替换后在菜单里重新点「配对新手机…」。

待机副屏（实时活动）

实时活动没有出现
  1. 在 iPhone 上的 DuoDesk 设置里，确认「待机时显示 Claude / Codex 状态」是打开的（默认打开）。它下面每台已配对的 Mac 还各有一个开关，这台 Mac 的也要打开。
  2. 在 iPhone 的「设置 › DuoDesk」里允许「实时活动」。
  3. 用 DuoDesk 连一次这台 Mac，Mac 才知道该推给哪部手机。
  4. 实时活动只在 Mac 上的 Claude Code 或 Codex 开始干活时出现，全部空闲 2 小时后自动消失。

Mac 菜单栏里的「待机副屏」一栏会显示推送状态和连过的手机数，可以用来判断问题出在哪一边。

怎么让它铺满屏幕？

给 iPhone 充电、锁屏，然后横放，进入待机模式（StandBy）。iPhone Duo 合上和展开时都可以用。

用量显示「—」或者不显示
  • Claude：需要这台 Mac 上的 Claude Code 用订阅账号登录。在终端运行 claude，输入 /login。
  • Codex：需要在这台 Mac 上登录 ChatGPT 桌面版或 Codex 命令行。
  • 你的套餐没有的用量窗口（比如某些套餐只有每周限额）不会显示。

DuoDesk Pro 订阅

DuoDesk 怎么收费？

iPhone 上的 DuoDesk 免费下载，Mac 上的 DuoDesk Host 也免费。连接 Mac 需要 DuoDesk Pro，这是 App Store 的自动续期订阅：每月 US$2.99 或每年 US$19.99，两档都先有 7 天免费试用（每个 Apple 账户只能用一次）。

在其他国家或地区，App Store 会在订阅前显示当地货币的对应价格。

不订阅能用哪些功能？

可以下载 App、配对 Mac、修改设置，只有连接时才需要 DuoDesk Pro：没订阅时点一台 Mac，DuoDesk 会显示订阅选项，订阅成功后接着连接。一份订阅可以连接你配对的所有 Mac。

怎么取消订阅？

在 iPhone 上打开「设置」›［你的姓名］›「订阅」，选择 DuoDesk Pro。也可以从 App Store 的账户设置进去，或者在 DuoDesk 的设置里点「管理订阅」。

要在免费试用或当前周期结束前至少 24 小时取消，否则会自动续订。DuoDesk Pro 可以一直用到这个周期结束。

付款和退款都由 Apple 处理。要申请退款，请到 reportaproblem.apple.com。

已经订阅了，DuoDesk 却不认

确认这台 iPhone 的 App Store 登录的是订阅时用的 Apple 账户，然后在 DuoDesk 设置的 DuoDesk Pro 下点「恢复购买」。换了新 iPhone 或重装 App 之后也这样做。

如果提示这个 Apple 账户没有 DuoDesk Pro 订阅，到「设置」›［你的姓名］›「订阅」里看看订阅是否有效。

其他

需要注册账号吗？

不需要 DuoDesk 账号。一台 Mac 和配对过的手机就是全部关系，没有注册和登录。DuoDesk Pro 在 App Store 用你的 Apple 账户购买。

我的画面会经过你们的服务器吗？

画面、输入和剪贴板只在你的 iPhone 和 Mac 之间端到端加密传输。会合服务只帮两台设备找到对方；直连不通时 Cloudflare 中转的也只是加密后的数据，谁都解不开。详见工作原理和隐私政策。

联系我们

请写明 iPhone 型号、iOS 和 macOS 版本，以及出了什么问题。能附上 Mac 上「连接记录…」的最后几十行更好；记录里有配对手机的名称和连接时间，发送前可以先看一下。