vdi-cloud/docs/sunshine-vm-setup-for-colleague.md

Sunshine 显卡环境配置指引（转给操作 VM 的同事）

背景

我们在 VM 100（win10-test，192.168.1.70）里装了 Sunshine 用于 Moonlight 串流验证。当前卡在：VM 没有可用 GPU，Windows 只有「Microsoft 基本显示适配器」，分辨率 1024×768、刷新率 1Hz，Sunshine 无法按 30/60fps 捕获编码。

不需要动 Proxmox，只需要在 Windows 里完成两件事：装虚拟显示器驱动 + 确认 Sunshine 配置。

第 1 步：安装虚拟显示器驱动（IddSampleDriver）

让 Windows 出现一个虚拟显卡，可自定义分辨率和刷新率：

1. 下载虚拟显示驱动包（ParrotGeek 的 IddSampleDriver，或等效的「Virtual Display Driver」）。 常用地址：https://github.com/itsmikethetech/Virtual-Display-Driver/releases （如果 GitHub 打不开，用镜像：把链接前面加 https://gh-proxy.com/ ）
2. 解压后右键 IddSampleDriver.inf →「安装」。
3. 重启 Windows。
4. 装好后设备管理器会出现「IddSampleDriver Device」，显示设置里会多出一个虚拟显示器。
5. 把虚拟显示器设置为：
   • 分辨率：1920×1080（先用 1080p，稳定后再试 2K）
   • 刷新率：60Hz（关键！当前 1Hz 是主要问题）
   • 如果看到多显示器，把虚拟屏设为「扩展这些显示器」， Sunshine 默认抓主屏；也可以只保留虚拟屏。

第 2 步：确认 NVIDIA 独显是否可用（如果宿主已直通/有驱动）

打开 PowerShell 执行：

nvidia-smi

• 如果能输出显卡信息（GTX 965M）：很好，说明 VM 内能用 NVIDIA。
  • 请安装 GeForce 驱动（如未装），然后告知我们，我们把 Sunshine 切到 NVENC 硬编码。
• 如果提示找不到命令或没有 NVIDIA 设备：跳过此步，走纯软件编码 + 虚拟显示器路线（也够验证流畅度）。

第 3 步：检查 Sunshine 服务状态

Sunshine 已装在 C:\Program Files\Sunshine\，服务名 SunshineService。

PowerShell 执行：

Get-Service SunshineService
Restart-Service SunshineService

重启服务后再看日志确认识别到新显示器：

Get-Content "C:\Program Files\Sunshine\config\sunshine.log" -Tail 60

需要看到的关键行（类似）：

Desktop resolution [1920x1080]
Display refresh rate [60 Hz]

第 4 步：告知我们结果

只需回三条信息：

1. 虚拟显示器是否装好，分辨率/刷新率是多少；
2. nvidia-smi 是否有输出；
3. sunshine.log 最后几十行里的 Desktop resolution / Display refresh rate 数值。

我们这边会立刻重新发起 Moonlight 串流测试并采集性能数据。

备注

• Web UI（可选）：https://192.168.1.70:47990 账号 admin / 密码 vdi12345
• 装驱动需要重启 VM，重启后 SunshineService 会自启，无需其他操作。
• Sunshine 的串流端口 47984/47989/47990/48010 已确认开放，防火墙无需改动。