配一台 M6 芯片的 Mac mini，国行起售价只要 6,299 元；但如果想在桌面上配齐苹果自家的 Studio Display 显示器，起售价却高达 11,999 元——比一台 11 英寸 iPad Pro（8,999 元起）甚至 13 英寸 iPad Pro（11,499 元起）还要贵。
对于希望桌面纯粹搭配 Apple 产品、日常本来就高频使用 iPad、同时看重性价比与便携性的人来说，直接拿手头的 iPad 充当 Mac mini 的主显示器，是一套非常实用的组合：在家插上电源就是完整的 macOS 桌面工作站，拔下或断开就能带着 iPad 出门。
不过，真正在桌面上撤掉传统显示器、把 Mac mini 当作“无头主机（Headless Mac mini）”运行时，你会立刻撞上一个交互死锁：怎么在看不见 Mac 屏幕的情况下，从 iPad 端主动把画面连起来？
本文梳理这套方案的底层机制、完整配置步骤，以及实际使用中最容易踩到的两个深坑：macOS Gatekeeper 隔离弹窗，与 SSH 后台触发时的 -501 虚拟显示器冲突。
一、先理清核心概念：Sidecar 不是第三方软件
很多人第一次在视频里看到 Sidecar 这个词，会以为它是一款需要额外购买的第三方投屏工具。实际上，Sidecar（中文名叫“随航”）是 macOS 和 iPadOS 系统原生内置的功能。
原生随航的优势在于画质清晰、延迟低、支持 Apple Pencil 压感与视网膜 HiDPI 缩放，且不需要额外付费。但苹果官方设计的连接逻辑是只能从 Mac 端主动发起——也就是必须先在 Mac 桌面上打开“控制中心”，点击“屏幕镜像”，再勾选你的 iPad。
当 Mac mini 处于无头模式（不接传统显示器，或者仅接在平时处于关闭/待机状态的电视上）时，你根本看不到 Mac 桌面，自然无法用鼠标去点那个按钮。
要打破这个死结，最稳健的思路是：在 iPad 上通过“快捷指令（Shortcuts）”建立 SSH 连接，远程调用 Mac mini 上的命令行工具 SidecarLauncher，让 Mac 主动把画面推给 iPad。
早期不少教程会用 AppleScript 模拟鼠标点击“系统设置”里的菜单，但只要 macOS 升级微调了界面层级，脚本就会失效。相比之下，开源工具 SidecarLauncher 直接调用 macOS 内部的 SidecarCore 私有框架，通过命令行即可按设备名触发随航连接，稳定得多。
二、前置准备：解决无头输出与基础环境
在撤掉显示器之前，请先给 Mac mini 接上显示器（或用另一台 Mac 开启“屏幕共享”连上去），完成以下一次性初始化配置。
1. 解决无显示器（Headless）的显卡输出问题
如果 Mac mini 检测到 HDMI 或雷电接口上没有任何显示设备，系统可能不会正常初始化 GPU 桌面，或者退化为奇葩的低分辨率比例，甚至导致随航直接崩溃。解决办法有两种：
硬件方案（最省心）：花十几块钱买一个 HDMI 虚拟显示器欺骗器（HDMI Dummy Plug） 插在 Mac mini 背部接口上，让系统始终认为连着一台物理显示器。
软件方案：在 Mac mini 上安装 BetterDisplay，创建一个虚拟屏幕（Virtual Screen），开启 HiDPI，并将其设置为“开机自启”及“主显示器”。
2. 配置 Mac mini 自动登录与 SSH 服务
为了让无头主机在重启或断电恢复后依然能被 iPad 唤醒，需要打通三项基础设置：
同一账号与网络：确保 Mac mini 和 iPad 登录同一个开启了双重认证的 Apple ID，同时打开两台设备的蓝牙、Wi-Fi 和“接力（Handoff）”。
开启自动登录：进入
系统设置→用户与群组，开启当前用户的“自动登录”。需要注意这里的安全性取舍：macOS 要求先关闭“文件保险箱（FileVault）”磁盘加密才能开启自动登录。如果不开启自动登录，Mac mini 重启后会停留在 FileVault 预启动锁屏界面，此时系统的 SSH 服务和用户态随航服务都尚未启动，iPad 将无法远程连入。放在家中的桌面主机通常可以接受这一取舍；若处于公共办公环境，则需权衡物理安全风险。开启 SSH 服务：进入
系统设置→通用→共享，打开 远程登录（Remote Login），记住页面上显示的用户名@主机名.local或局域网固定 IP。
三、安装 SidecarLauncher 与清除 Gatekeeper 拦截
打开 Mac mini 的终端，前往 GitHub 开源项目 Ocasio-J/SidecarLauncher 的 Releases 页面下载最新编译好的二进制文件。建议将其放到 /usr/local/bin/（或个人目录 ~/.local/bin/）下并赋予可执行权限：
chmod +x /usr/local/bin/SidecarLauncher踩坑一：弹出“无法打开 SidecarLauncher”怎么办？
由于 SidecarLauncher 是社区开源编译的二进制文件，没有附带付费 Apple Developer 账号的公证签名（Notarization），从浏览器下载后，macOS 的 Gatekeeper 机制会自动给文件打上 com.apple.quarantine（隔离）扩展属性。
首次在终端运行它时，系统往往会弹窗拦截，提示无法验证开发者。此时：
先在弹窗上点击“完成（Done）”，千万不要顺手点“移到废纸篓（Move to Trash）”。
既然终端已经打开，最快的方法不是去“系统设置 → 隐私与安全性”里翻找按钮，而是直接用一行命令剥离它的隔离扩展属性：
# 若放在 /usr/local/bin/ 下：
xattr -d com.apple.quarantine /usr/local/bin/SidecarLauncher
# 若放在 ~/.local/bin/ 下：
xattr -d com.apple.quarantine ~/.local/bin/SidecarLauncher清除隔离标记后，保持你的 iPad 处于解锁亮屏状态，在终端先查看系统识别到的 iPad 名称，再测试手动推流：
# 1. 列出附近可用的随航 iPad 设备名称
/usr/local/bin/SidecarLauncher devices
# 2. 触发随航连接（将引号内替换为上一步输出的完整设备名）
/usr/local/bin/SidecarLauncher connect "你的iPad名称"注意设备名称必须与 devices 输出完全一致（有时名称开头或特殊引号会带有空格，建议直接复制终端输出的字符串）。如果此时 iPad 瞬间变成 Mac 的扩展屏或镜像屏，说明核心调用链路已经跑通。
四、核心排障：为什么 VNC 能连上，SSH 却报错 -501？
很多人刚配好 SidecarLauncher 时测试一切正常，可一旦把显示器或电视关掉、隔几个小时用 SSH 连上去执行 SidecarLauncher connect，终端就会抛出一个令人困惑的错误：
SidecarErrorVirtualDisplayFailed (-501)更奇怪的是，如果你先用另一台电脑或 iPad 上的 VNC 客户端（屏幕共享）连一下 Mac mini，再跑同一条命令，它又立刻恢复正常了。
底层原因：SSH 不会唤醒处于休眠态的 WindowServer
这并不是 SidecarLauncher 坏了，而是 macOS 的显示服务（WindowServer）对 VNC 和 SSH 两种远程连接有着完全不同的电源唤醒策略：
为什么 VNC 可以成功：当你通过 VNC（屏幕共享）连接 Mac mini 时，macOS 会模拟真实用户的键鼠输入，自动将系统从“显示器休眠（
Display Asleep: Yes）”状态唤醒。此时WindowServer恢复活跃，能够正常清理旧的虚拟显示器，并创建新的随航虚拟屏幕。为什么纯 SSH 会报错
-501：哪怕你的 Mac mini 背部插着 HDMI 欺骗器或连着客厅电视（比如系统识别为Mi TV），在无人操作或电视关闭待机时，macOS 依然会让显示子系统进入休眠状态。通过 SSH 登录只会在后台启动命令行会话，不会唤醒显示器。在显示器休眠状态下：1. 上一次断开随航时，
WindowServer会把“销毁随航虚拟显示器”的热拔插操作挂起（系统日志会记录Deferred hotplugs cannot be processed in a non-wake state）。2. 当你在 SSH 会话里直接运行
SidecarLauncher connect时，旧的随航虚拟显示器还卡在系统里没有销毁，此时请求新建虚拟屏幕就会发生冲突，直接报错SidecarErrorVirtualDisplayFailed (-501)。
请对照下图左侧的蓝色主链路与右侧的橙色冲突分支：能否稳定连上随航，关键在于调用 SidecarLauncher 之前，是否先让 WindowServer 脱离 Display Asleep 状态并完成挂起的热拔插清理。
图1：SSH 直接调用随航会因显示器休眠触发 -501 冲突，先执行 caffeinate -u 唤醒 WindowServer 才能完成旧虚拟屏清理与重连
解决办法：用 caffeinate -u 先唤醒显示服务
知道了根因，修复就非常简单。通过 SSH 启动随航前，先用 macOS 自带的 caffeinate -u -t 5 声明一次用户活动（把显示器状态强制唤醒 5 秒），等待 1 秒让 WindowServer 把上次残留的虚拟屏幕清理干净，再执行随航连接命令：
caffeinate -u -t 5 & sleep 1 && /usr/local/bin/SidecarLauncher connect "你的iPad名称"如果你平时也会从其他设备通过 SSH 手动触发，可以在 Mac mini 的 ~/.zshrc 里加一个简短的别名（请将设备名称替换为你自己的 SidecarLauncher devices 输出，注意保留原有的引号与空格）：
alias ipad='caffeinate -u -t 5 & sleep 1 && /usr/local/bin/SidecarLauncher connect " Dave King’s iPad"'保存后执行 source ~/.zshrc，之后每次 SSH 进来只需输入 ipad 即可稳定推流。
五、在 iPad 上配置“一键启动”快捷指令
最后一步，就是把这条唤醒加推流的命令封装到 iPad 桌面上。打开 iPad 自带的 快捷指令（Shortcuts） App，新建一个快捷指令：
搜索并添加动作：通过 SSH 运行脚本（Run Script Over SSH）。
点击展开详情，填入 Mac mini 的连接信息： * 主机（Host）：填入 Mac mini 的局域网固定 IP，或填
你的Mac主机名.local。 * 端口（Port）：22。 * 用户（User）与认证：填入你的 Mac 用户名，认证方式可选择密码或预先配好的 SSH 密钥（推荐 SSH 密钥，免去改密码后失效的麻烦）。脚本（Script） 内容填入完整的唤醒与连接命令：
caffeinate -u -t 5 & sleep 1 && /usr/local/bin/SidecarLauncher connect "你的iPad名称"点击顶部的快捷指令名称，选择 添加到主屏幕（Add to Home Screen）。
配置完成后，日常使用流程就变成了：解锁亮屏 iPad → 点击主屏幕上的快捷指令图标 → 等待 2～3 秒，caffeinate 唤醒 Mac mini 显示服务并由 SidecarLauncher 将桌面直接切入 iPad。
六、替代方案对比
当然，原生随航并非没有边界：它强制要求两台设备登录同一个 Apple ID，iPad 锁屏断连后需要重新点一次快捷指令，且 SidecarLauncher 依赖苹果未公开的 SidecarCore 私有框架，遇到 macOS 跨大版本升级时可能需要等待开源社区跟进适配。
如果你不想受限于同一个 Apple ID，或者希望在开机 FileVault 锁屏界面就能直接看到画面输入密码，可以参考下表，从左到右对比原生随航方案与另外两款主流替代方案的成本与取舍：
图2：无头 Mac mini 连接 iPad 显示器的三种主流方案对比
结合上表，可以根据你手头的预算与使用习惯直接做选择：
追求零软件成本与原生体验：优先用本文的 原生随航 +
SidecarLauncher+ SSH 快捷指令，配合十几块钱的 HDMI 显卡欺骗器即可低成本跑通。跨 Apple ID 或偏好接收端直连 App：可以尝试 GPL-3.0 开源免费项目 OpenDisplay（Mac 端安装 Sender，iPad 端安装 Receiver），支持通过 USB 数据线（基于
usbmuxd低延迟边充边用）或局域网 Wi-Fi 直接在 iPad 端点击连接，但在无头模式下同样需要搭配 HDMI 欺骗器或 BetterDisplay。预算充足、不愿折腾命令行或需要保留 FileVault 锁屏加密：可以选择商用硬件方案 Luna Display（采集头官方售价 89.99 美元）。它的硬件本身就是一个物理显卡欺骗器，插上后在 iPad 打开 Luna App 就能直接进入系统，甚至支持在开机密码界面直接输入。