GET YOUR MACS CONNECTED
第一次连接,从这里开始。
在 Mac mini 准备好被控端,再用 MacBook 配对。
适用于 TailDesk 0.2.1 开发预览版 · macOS 14 及以上
01 · 两台 Mac,各装一个应用
MacBook 安装控制端(Controller),Mac mini 安装被控端(Host)。安装包同时包含 Apple 芯片与 Intel 架构,M4 也适用。两端都已内置 Tailcat,无需另装 Homebrew 或注册 Tailscale 账号。
- 如果用过旧版 TailDesk,先关闭旧版的后台运行,再退出旧版应用。
- 解压 ZIP,将对应的 TailDesk Controller.app 或 TailDesk Host.app 拖到“应用程序”。
- 从“应用程序”打开。后续请保持应用在这个位置。
首次打开被 macOS 拦截?
当前版本尚未使用 Developer ID 签名及 Apple 公证。确认下载自本站后,在弹窗点“完成”,进入“系统设置 → 隐私与安全性 → 安全性”,找到对应应用,点击“仍要打开”,按提示确认。两个应用需分别操作。Apple 官方说明 ↗
从 0.2.0 更新会保留配对和身份,无需再次激活。当前远程会话正常时,可以稍后再更新。
需要校验下载文件时,可查看 SHA-256 校验值。
02 · 在 Mac mini 开启系统服务
打开被控端,点击“打开系统共享设置”,或进入“系统设置 → 通用 → 共享”。
- 开启“屏幕共享”,并允许你自己的 Mac mini 账户访问。若已使用“远程管理”,请按现有用途选择,不要重复开启两种管理方式。
- 需要终端连接时,开启“远程登录”,允许同一个账户。
- 保持 Mac mini 接通电源、用户已登录,并在系统能耗设置中防止整机自动睡眠。
记住被控端显示的“远程登录账户”。后续登录远程桌面时,使用的是 Mac mini 的账户和密码,不是 MacBook 的密码或配对码。
03 · 激活一次,再用六位码配对
- 在 Mac mini:将维护者单独提供的一次性激活码粘贴到被控端,点击“开启被控服务”。激活后显示六位配对码。
- 在 MacBook:打开控制端,输入这六位配对码,点击“配对”。
- 回到 Mac mini:确认请求中的设备名称是自己的 MacBook,点击“允许配对”。首次配对时保持被控端窗口打开。
- 控制端出现你的 Mac mini,即可开始连接。
六位配对码 5 分钟有效、只能使用一次。过期后,在被控端点击“生成配对码”。新增控制设备也需要新码和被控端确认。
激活码与配对码是两回事。
激活码用于首次登记被控端,由维护者私下提供,使用一次即失效;配对码由已激活的被控端生成,用于允许 MacBook 连接。本站公开下载应用,但不开放任意设备注册,也不发布激活码。
04 · 从 MacBook 回到 Mac mini
- 连接桌面:在控制端点“连接桌面”,使用系统“屏幕共享”窗口,输入 Mac mini 的账户和密码。请选择标准屏幕共享模式。
- 打开终端:点“打开终端”,在 Terminal 中登录 Mac mini。首次 SSH 连接会要求核对并确认主机指纹。
- 结束会话:点“断开连接”,关闭本次隧道和远程会话。
之后不需要重复输入配对码。打开控制端,选择“连接桌面”即可发起连接。配对负责设备授权和隧道,macOS 的系统共享开关与账户验证仍然需要。
本版使用系统应用打开桌面与终端,不在网页内显示远程桌面,暂不支持 Apple 高性能屏幕共享模式。
日常使用,保留你需要的控制
- 临时停止:被控端点“暂停远程访问”;需要时点“恢复远程访问”。
- 撤销某台设备:在被控端找到对应设备,点击“取消授权”。该设备再次连接需重新配对。
- 后台运行:首次连接成功后,可开启“登录后自动运行”。当前用户登录后会启动后台共享,退出被控端应用仍可运行。
- 更换被控设备:控制端目前一次保存一台 Mac mini,可用“重新配对”更换;旧设备的授权在原被控端取消。
锁屏后后台进程可继续运行。整机睡眠、注销、关机、重启尚未登录时,不保证能连接;本版不支持 FileVault 开机解锁与登录前无人值守。设置后台运行后移动了应用位置,请关闭再开启该设置。
遇到问题,按现象排查
- 无法连接服务器:在出问题的 Mac 浏览器中打开 服务连通性检查 ↗,正常会显示包含
TailDesk Private的文字。无法打开时,先检查这台 Mac 的网络与 DNS,或联系维护者。 - 激活码已使用:已激活的原设备保留本机数据后重试。新设备或数据丢失后重新登记,需要向维护者索取新激活码。
- 配对码错误、过期:在 Mac mini 重新生成配对码,并在五分钟内完成操作。
- 一直等待确认:回到 Mac mini 打开被控端,检查请求并点击“允许配对”。
- 已配对,但桌面连不上:检查 Mac mini 未睡眠、被控服务未暂停、“屏幕共享”已开启且允许当前账户访问。
- 终端连不上:检查“远程登录”已开启,使用被控端显示的短用户名。
0.2.1 新增服务检测:“隧道就绪”表示转发入口已建立;“屏幕共享已响应(RFB…)”表示收到远端服务标识,仍需在系统窗口完成登录。被控端也可点击“检查屏幕共享”检测本机服务。
服务已响应,系统窗口仍报错:保持 TailDesk 连接,退出再打开系统“屏幕共享”。在控制端展开“桌面连接排查”,复制当前地址,手动新建连接,选择标准模式,用 Mac mini 的账户密码登录。端口变化后须使用新地址,无需重新配对。
当前只转发 TCP;高性能模式还需要 UDP 5900–5902,暂不支持。Apple 官方说明 ↗
客户端不使用公共中继列表。可直连时尝试直连,否则通过本站的个人服务器中继;传输使用 Tailcat 加密隧道。
当前是开发预览版。
已验证应用启动、公网配对、加密传输和权限边界;用户已反馈不同局域网的两台 Mac 可以进入桌面;仍未覆盖全部桌面场景、Intel 实机及所有旧系统。请先在自己的设备上完成一次连接检查。