PocketRocket Host 设置

所有设置,逐一详解。

PocketRocket Host 中每个开关的作用、默认设置,以及什么情况下值得更改。

在哪里找到

点按菜单栏中的火箭,然后选取“Settings…”。窗口的布局和“系统设置”一样:左侧是栏目,右侧是选项。

首次启动时

macOS 会请求几项权限:通知、本地网络、辅助功能,以及录屏与系统录音;安装麦克风时还需要管理员密码。在 MacBook 上,它还会询问一次,是否允许一个用于合盖状态的小型辅助程序。如果跳过了其中任何一项,之后可以在“Privacy”“Virtual Devices”和“General”中授权。

Share Screen…
用 6 位数代码让不使用你 Apple 账户的人访问这台 Mac,可以只连接一次,也可以长期访问。“Online Key Sharing”开启期间,还会有“Copy Link”。
Settings…
打开下文介绍的设置窗口。
Quit
退出 PocketRocket Host。如果打开了“Keep running”,菜单中会显示“Restart”而不是“Quit”,因为 macOS 会再次启动它——要退出,请在“Settings”中关闭“Keep running”。

当你与别人共享屏幕时,菜单顶部会显示对方是谁。如果缺少辅助功能权限,那里的警告会带你前往“系统设置”中的相应位置。屏幕缩放不再出现在这个菜单中:请在你的设备上、会话栏里更改。

General

主机是否自动启动,会话期间这台 Mac 的显示器和窗口会怎样,以及会话结束后会保留什么。

PocketRocket Host 设置:General
Start at login默认 关

登录这台 Mac 时启动 PocketRocket Host,这样无需手动打开 app 就能连接。

何时更改 对于你想在外出时访问的任何 Mac,请打开此项。

Keep running默认 关

如果主机崩溃,或有人在这台 Mac 上退出了它,macOS 会在几秒内重新启动它。需要先打开“Start at login”才能使用。

何时更改 无人值守的 Mac 请打开此项。如果你希望能彻底退出主机,请关闭此项。

Restore window layout after the session默认 开

连接期间,这台 Mac 的显示器会关闭,macOS 会把所有窗口集中到一台显示器上。主机会记下窗口原来的位置,并在显示器恢复后放回去:在 macOS 允许的情况下,回到同一台显示器、同样的位置、大小和分栏布局(例如边栏宽度)。桌面以连接结束时的状态为准:如果你在连接期间在调度中心添加、移除或重新排列桌面,或在桌面之间移动窗口,断开连接后,每个窗口都会回到与连接结束时编号相同的桌面,新添加的桌面也会保留。macOS 不允许 App 更改桌面的顺序,因此主机移动的是窗口而不是桌面——墙纸会留在各自的桌面上。需要辅助功能权限。

何时更改 如果已有其他 app 在恢复你的布局,请关闭它;Spencer 或 spacekeeper 运行时,主机无论如何都会交给它们处理。

Recreate missing desktops (Mission Control animation)默认 关

如果窗口原来所在的桌面在会话期间消失了,主机会在把窗口移回去之前重新创建它。这会在这台 Mac 上短暂打开调度中心。

何时更改 如果你使用多个桌面,并希望每个窗口回到自己原来的桌面,请打开此项。

Keep a closed MacBook awake during a connection默认 开

接通电源且有设备连接时,合上的 MacBook 不会进入睡眠,因此主机可以关闭每一台显示器(包括外接显示器),会话仅在虚拟显示器上运行。一个小型辅助程序只会在连接期间更改这项系统设置,并在连接结束后、拔掉电源适配器时以及重新启动后恢复原状。如果你原本就已关闭睡眠,主机不会去动它。

何时更改 仅在 MacBook 上显示。macOS 会请你在“系统设置”>“通用”>“登录项与扩展”中允许该辅助程序一次。

Keep the virtual display after disconnecting默认 开

会话结束后,这台 Mac 的显示器保持熄屏,虚拟显示器也会一直保留,直到有人在这台 Mac 前移动鼠标或按下按键:没有时间限制,所以重新连接是瞬间的事,窗口也留在原来的位置。

何时更改 如果希望会话一结束屏幕就恢复,请关闭此项。仅在连接了显示器的 Mac 上显示。

如果你在“系统设置”>“通用”>“登录项与扩展”中关闭了 PocketRocket Host,这里会显示一条橙色提示,告诉你在哪里重新打开它。在台式 Mac 上,主机不会更改睡眠设置:要让它保持可连接,请在“系统设置”中让它不进入睡眠。

Virtual Devices

会话期间这台 Mac 的声音,以及 Mac 上的 app 可以使用的你设备的麦克风和摄像头。

PocketRocket Host 设置:Virtual Devices
Mute this Mac’s sound during a connection默认 开

连接期间,Mac 本机的扬声器或耳机保持静音,声音仍会传到你的设备。连接结束后恢复原来的音量;如果期间有人在 Mac 上更改了音量,则保留其设置。

何时更改 如果 Mac 旁边的人也需要听到声音,请关闭此项。

PocketRocket Microphone默认 首次启动时安装

一个虚拟麦克风,让 Mac 上的 app 在会话期间听到你的 iPhone、iPad、Apple Vision Pro 或 Mac 的麦克风。安装时需要管理员密码。状态会显示“Installed”“Update required”或“Not installed”。

何时更改 如果你关闭了密码提示,随时可以在这里点按“Install…”。

PocketRocket Camera默认 在“系统设置”中批准一次

一个虚拟摄像头,把你设备的摄像头提供给 Mac 上的 app,例如 FaceTime 通话或 Zoom。它是一个系统扩展:状态会显示“Active”“Waiting for approval”或“Inactive”。

何时更改 点按“Enable…”,并在 macOS 询问时允许该扩展。

摄像头和麦克风

Privacy

需要你在 macOS 中授予的权限。每一行都会显示 PocketRocket Host 是否已获得该权限;如果没有,会打开“系统设置”中的相应位置。

PocketRocket Host 设置:Privacy
Screen & System Audio Recording默认 首次启动时请求

捕获屏幕和系统声音,发送到你的设备。没有此权限就没有画面。

Accessibility默认 首次启动时请求

让你设备的鼠标和键盘可以控制 Mac。没有此权限,你只能看,不能点按或输入。

Input Monitoring默认 需要时请求

察觉有人在使用 Mac 本机的键盘或鼠标,以便 Mac 前的人收回控制权。

Notifications默认 首次启动时请求

让 PocketRocket 在失去某项权限或某台设备时提醒你。

“Granted”表示一切就绪。如果某项权限显示“Missing”,请点按“Open System Settings”;如果显示“Not determined”,请点按“Request Access”,macOS 会向你询问。本地网络访问权限由 macOS 在首次需要时授予,无法在这里检查。

Network

主机可以使用多少带宽,以及你的设备可以通过哪些路径连接到这台 Mac。

PocketRocket Host 设置:Network
Bandwidth limit默认 不限(∞)

限制主机发送到你设备的所有数据(画面、声音、摄像头和纠错数据),范围为 1 到 50 Mbps。主机会调整帧速率和压缩,最后才调整分辨率,以保持在上限之内。更改会立即生效。

何时更改 在按流量计费或共用的连接上(例如手机热点),请设置上限。

Allow NAT (direct from internet)默认 开

让你的设备可以直接从互联网连接。需要时,主机会请求路由器开放端口(NAT-PMP 或 UPnP)。

Allow LAN (local network)默认 开

让同一网络中的设备直接连接,并通过 Bonjour 找到这台 Mac。

Allow VPN (tunnel address)默认 开

让设备通过你使用的 VPN(例如 WireGuard 或 Tailscale)连接。

Allow relay默认 开

当其他方式都行不通时,例如处于运营商级 NAT (CGNAT) 之后,双方都会向外连接到 PocketRocket 中继(只转发数据的服务器),中继只转发加密字节。关闭后,流量不再经过中继,但仍会通过中继找到这台 Mac。

何时更改 除非有特别的理由,否则请保持所有路径开启。例如,如果你想让连接只在自己的网络内进行,可以关闭中继。

如果 macOS 或防火墙阻止主机访问你的本地网络,这里会出现警告,说明无法为 NAT 打开端口,并提供前往“系统设置”>“隐私与安全性”>“本地网络”的链接。在你允许之前,设备会通过中继连接。

路径的工作原理

Paired Devices

你通过“Share Screen…”或“Online Key Sharing”授予永久访问权限的人和设备。一次性连接不会出现在这里。

PocketRocket Host 设置:Paired Devices
每个条目默认 配对设备前为空

显示设备(或一个 iCloud 账户,涵盖登录该账户的所有设备),以及它的设备密钥、配对时间和上次连接时间。

Remove

立即收回访问权限。如果该设备正在连接,会话会结束;下次它联系这台 Mac 时,它的卡片就会消失。

Allow connections without approval默认 关

关:来自这台设备的每次连接,都要等你在这台 Mac 上点按“Allow”(在面板或通知中)才会继续。60 秒内无人回应?连接将被拒绝。开:设备无需询问即可连接。用密钥配对的设备在此没有开关——由“Online Key Sharing”部分决定。

何时更改 只对你完全信任的设备(例如你伴侣的 Mac)才开启此项。

Online Key Sharing默认 关

经由中继为你提供一个私密链接,链接指向的页面始终显示这台 Mac 的当前代码——与“Share Screen…”中的代码是两个不同的代码。“Copy Link”用于复制链接,“Recent page views”显示页面何时被打开,“New Link…”会立即停用旧链接和当前代码。Mac 不显示完整链接,也不显示页面上的代码。

何时更改 适合经常连接的人,或你负责照看的 Mac——每次都要念出代码太麻烦时。

Allow permanent access默认 关

关:链接中的每个代码只允许一次连接,由你在这台 Mac 上批准;连接结束后,设备不会被记住。开:用链接中的代码配对的设备会被记住,像其他设备一样出现在列表中,并可再次连接。移除其中一台时会提供“Remove and Create New Link”,因为仍持有链接的人可以获得新代码。

何时更改 适合经常连接、且你想把其设备保留在列表中的人。

Allow connections without approval默认 关

仅在开启“Allow permanent access”时有效。关:来自用密钥配对的设备的每次连接,都要等你在这台 Mac 上批准。开:“Online Key Sharing”开启期间,这些设备无需询问即可连接——任何拿到链接的人都可以配对设备并控制这台 Mac,所以开启前,以及在允许此项的情况下开启“Online Key Sharing”时,Mac 都会向你发出警告。

何时更改 只有对你远程照看的 Mac 才可以开启它,并请保管好链接。

这些设置可以在 Mac 前更改,也可以从你自己的设备远程更改。有访客连接时,只有坐在 Mac 前的人才能移除设备或更改批准开关,而“Online Key Sharing”只能关闭或改得更严格。

用代码共享屏幕

Events

你自己的 zsh 脚本:一个在设备连接时运行,一个在会话结束时运行。例如,开启专注模式、暂停备份,或记下是谁连接的。

PocketRocket Host 设置:Events
Before connecting默认 关

当设备连接到一台空闲的 Mac 时运行:在连接被接受之后、显示器切换之前。切换网络、恢复连接或由另一台设备接管,都不会再次运行它。

Time limit默认 5 秒

主机在连接前等待脚本的时长:1 到 30 秒。超时后,它会停止脚本并照常连接。

After disconnecting默认 关

当最后一台设备离开、这台 Mac 的显示器恢复后运行。主机不会等待它;它最多可运行 60 秒。

Run Now

立即试运行脚本,并显示退出码、耗时和输出。

脚本以你的用户身份通过 /bin/zsh 运行,位于主机的状态文件夹中,并带有这些变量:

  • PR_EVENT
  • PR_CLIENT_NAME
  • PR_CLIENT_KIND
  • PR_PATH
  • PR_REASON
  • PR_STATE_DIR

脚本只能在这里,也就是 PocketRocket Host 的设置中更改,不能从你设备上的 PocketRocket App 更改。请避免使用 AppleScript:macOS 会在这台 Mac 的屏幕上请求权限,而远程会话期间没有人能点按它。

Compatibility

一些管理显示器或窗口的 app,会在会话期间重新点亮这台 Mac 的屏幕,或移动窗口。主机可以在会话期间退出它们,并在之后重新打开。

PocketRocket Host 设置:Compatibility
为找到的每个 app 提供一个开关默认 关

开启后,主机会在设备连接之前(早于你自己的“Before connecting”脚本)退出该 app,并在断开连接后于后台重新打开它,但仅限它原本正在运行时。这一过程不会显示在“Events”中。

何时更改 如果某个 app 在你的会话期间总是唤醒屏幕或移动窗口,请打开此项。

Recommended

标出已知会在连接期间重新点亮屏幕或移动窗口的 app,例如 BetterDisplay、Lunar 或 Stay。

DisplayLink Manager默认 关

驱动通过 DisplayLink 连接的显示器。它关闭期间,这些显示器会保持熄屏,断开连接后会恢复。

该面板只列出在这台 Mac 上找到的 app。主机认识的显示器类 app 有 BetterDisplay、BetterDummy、SwitchResX、Lunar、MonitorControl、DisplayBuddy、Resolutionator 和 DisplayLink Manager,窗口类 app 有 Stay、Spencer、spacekeeper、Amethyst、yabai、AeroSpace、Moom、Rectangle、Rectangle Pro、Magnet、BetterSnapTool、Spectacle、Divvy、Loop 和 Swish。

Shortcuts

会话期间在你设备的键盘上按下的组合键。主机会从你的设备发来的按键中识别它,你的设备上无需任何设置。

PocketRocket Host 设置:Shortcuts
Open diagnostics默认 ⌃⌥⌘D

在 Mac 上打开一个窗口,显示视频流持续更新的统计数据。

何时更改 在我们的支持团队需要时很有用。

要更改快捷键,请点按对应的栏位,然后按下至少包含一个修饰键的新组合。按 Esc 键取消。屏幕缩放在 Mac 上不再有快捷键:请在你的设备上、会话栏里更改。

Advanced

连接变差时,主机如何在清晰与流畅之间取舍。

PocketRocket Host 设置:Advanced
Sharpness vs fluidity默认 至少 30 fps

连接不佳时主机可降到的帧速率下限,范围为 15 到 60 fps。在下限之上,帧速率会逐步下降,且只降到必要的程度;到了下限,主机会加大压缩,然后才降低分辨率。

何时更改 做文字和设计工作时移向“Sharper”,看视频和玩游戏时移向“Smoother”。

Smoothness buffer默认 至多 200 毫秒

为了恢复丢失的数据包,画面可以暂停的时长上限,范围为 25 到 1000 毫秒。连接良好时不会增加延迟。这也是主机所能接受的延迟上限:在达到之前,主机会先降低帧速率。

何时更改 在良好的网络上想要尽可能低的延迟,设为 25 毫秒;在会丢包的连接上想流畅看视频,设为 300–500 毫秒。

画面如何自适应

Updates

已安装的版本,以及更新程序正在做什么。

PocketRocket Host 设置:Updates
Installed version and Status默认 启动时及每 24 小时检查

PocketRocket Host 会在后台下载更新,并且只在没有人连接时安装。更新经过签名和 Apple 公证,安装后主机会自动重新启动。

何时更改 如果状态显示 app 正从磁盘映像或临时位置运行,请将它移到“应用程序”文件夹,否则无法更新。

Check Now

立即检查更新。如果已经下载了更新,则安装并重新启动主机。

Diagnostics

为我们的支持团队准备的工具:视频流的实时图表、最新的日志行,以及这台 Mac 能否通过 LAN、VPN、NAT 和中继连接的实时情况。日常使用中不需要它。