Mac Virtual Display
Mac Virtual Display Guide

详细设置指南

从安装应用到配对、120Hz 串流、输入和合盖使用,按顺序完成整个远程工作流。

打开目录
01

了解连接结构

Mac Virtual Display 只是远程连接的一部分,每个应用负责不同的工作。

Mac Virtual Display

在 Mac 上创建与客户端设备匹配的虚拟显示器。

Sunshine

捕获并串流 Mac 的托管显示器。

Artemis 或 Moonlight

显示画面并传递输入。Galaxy 使用 Artemis,iPad 使用 Moonlight。

Tailscale

在外出时提供到 Mac 的私有连接;仅在局域网使用时可选。

Galaxy 或 iPad → Artemis 或 Moonlight → Tailscale → Sunshine → Mac Virtual Display

连接客户端前先打开虚拟显示器。Sunshine integration 会自动选择新建的显示器。

02

安装所需应用

在 Mac 和客户端设备上安装应用。需要外网访问时同时安装 Tailscale。

Mac

安装 Mac Virtual Display、Sunshine,以及按需安装 Tailscale。

Galaxy 或 Android

普通未 root 的设备使用稳定版 nonRoot game APK。

局域网或外网

同一局域网内 Tailscale 可选;外网工作流需要在两台设备上安装。

Mac Virtual Display 需要 macOS 14 或更高版本以及 Apple 芯片 Mac。APK 仅从上方官方 GitHub 链接下载。
03

选择并打开虚拟显示器

Mac Virtual Display 在菜单栏运行。选择与远程设备完全匹配的配置。

选择与你的设备匹配的配置。点击图片可放大。

  1. 打开当前配置区域。
  2. 选择匹配设备的配置。
  3. 使用 Sunshine 时开启 Sunshine integration
  4. 串流前点击 Turn On

每个配置已包含原生分辨率、2× HiDPI 工作区和 120Hz。关闭托管显示器后会恢复原来的显示布局。

04

Sunshine 权限与初始设置

  1. 安装并打开 Sunshine。
  2. 允许 macOS 屏幕录制和远程输入权限。
  3. 在 Mac 上打开 https://localhost:47990
  4. 创建 Web UI 用户名和密码。
  5. 完成客户端配对前保持 Sunshine 运行。
本地页面可能显示证书警告。请确认地址正好是 localhost:47990

更改权限后仍无画面或输入时,请完全退出并重新打开 Sunshine。

05

准备外网访问

同一局域网内 Tailscale 可选。外出时建议使用 Tailscale,而不是直接向互联网开放 Sunshine 端口。

  1. 在 Mac 和客户端安装 Tailscale。
  2. 两台设备登录同一账户。
  3. 确认两台设备均为 Connected。
  4. 查看 Mac 的 100.x.x.x Tailscale IPv4 地址。
  5. 在 Artemis 或 Moonlight 中只输入该 IP,不添加 https:// 或端口。

Mac Virtual Display 只显示 Tailscale 状态,不控制账户或 VPN。

尽可能使用网线连接主机 Mac。自动发现失败时也可以直接输入 Tailscale IP。
06

设置 Artemis 或 Moonlight

Galaxy Z Fold 或 Galaxy Tab

使用 Artemis。以下是在 Galaxy Z Fold8 上实际使用的设置。

Artemis 设置
Video resolutionCustom 2448 × 1848
Frame rate120 FPS
Video bitrate65 Mbps
Video codecPrefer HEVC
Video frame pacingBalanced
Video scale modeFit
Full screenOn
HDROff
AudioStereo
Play audio on PCOff
Use Virtual DisplayOff
Resolution Scale Factor100%
Auto Invert ResolutionOff

关闭 Use Virtual Display,因为 Mac Virtual Display 已在 macOS 中创建显示器。其他 Galaxy 设备应让 Custom 分辨率与所选配置显示的原生分辨率一致。

2448 × 184865 Mbps 是 Fold8 的实测值,并非所有设备的保证推荐值。不稳定时先降低码率。

iPad

使用 Moonlight,并在连接前选择对应的 iPad 配置。

  • iPad Pro 11-inch:2420 × 1668,120Hz
  • iPad Pro 13-inch:2752 × 2064,120Hz
07

PIN 配对与首次连接

每台客户端通常只需首次配对一次。

  1. 确认虚拟显示器已打开且 Sunshine 正在运行。
  2. Galaxy 打开 Artemis,iPad 打开 Moonlight。
  3. 找不到 Mac 时选择 Add PC manually
  4. 外网输入 Tailscale IP,局域网输入 Mac 本地 IP。
  5. 选择 Mac 并查看四位 PIN。
  6. 在 Mac 上登录 Sunshine Web UI。
  7. PIN 页面输入代码和设备名称。
  8. 返回客户端并打开 Desktop
打开虚拟显示器 → 确认 Sunshine → 在 Artemis 或 Moonlight 打开 Desktop
08

触控与键盘输入

Galaxy 上使用 Artemis 的触控板模式更适合操作 macOS。

  • 单指移动:移动指针
  • 轻点:点击
  • 双指移动:滚动
  • 双指轻点:右键
  • 三指轻点:显示或隐藏软键盘

输入组合文字

  1. 保持 Galaxy 软键盘为英文布局。
  2. 在 Mac 上切换输入法。
  3. 让 Mac 输入法组合文字。

完全无法输入时,请检查 Sunshine 的远程输入或辅助功能权限。

09

合盖与外出使用

  1. 将 MacBook 连接电源和有线网络。
  2. 物理显示器可用时选择设备配置。
  3. 开启 Sunshine integration 并点击 Turn On
  4. 确认客户端可以连接。
  5. 然后再关闭物理显示器或进入已测试的合盖状态。
不要远程关闭唯一的虚拟显示器。请先恢复物理显示器或打开 MacBook,再点击 Turn Off。

长期无头运行会因 Mac 型号和 macOS 版本而异,离家前请测试完整状态。

10

故障排除

看不到 Mac

确认 Sunshine 和 Tailscale,使用 Add PC manually 并只输入 Mac IP。

串流了错误的显示器

断开客户端,开启 Sunshine integration 后重新开关配置,再连接。

仍显示 60FPS

检查 Artemis 的 120FPS、Galaxy 刷新率、性能设置和 Game Booster 限制。

键盘无法输入

打开英文软键盘,在 Mac 端切换输入法,并检查 Sunshine 输入权限。

画面不稳定

使用网线连接 Mac,检查客户端网络,并优先降低码率。

返回 Mac Virtual Display

使用 Mac Virtual Display、Sunshine、Artemis 或 Moonlight 以及 Tailscale 配置 120Hz Mac 远程访问。