Sunshine虚拟显示器完全指南无需额外硬件快速创建多显示器串流环境【免费下载链接】foundation-sunshineSunshine fork: an enhanced sunshine, a self-hosted game streaming host for Moonlight with HDR10/HDR Vivid, virtual displays, advanced audio, optimized encoders, and a modern control panel.项目地址: https://gitcode.com/gh_mirrors/sunshine5/foundation-sunshineSunshine 是一款自托管游戏串流主机Moonlight 服务端其中的**虚拟显示器VDDVirtual Display Device**功能让你无需任何物理显示器和线缆就能为一台无头PC 创建虚拟屏幕并串流出多显示器环境。无论是把闲置主机变成 7×24 游戏服务器还是把游戏画面串流到手机、电视上虚拟显示器都是 Sunshine 最实用的进阶能力之一。本指南将带你从零开始完成安装、配置与排障。虚拟显示器能帮你做什么️传统串流要求 PC 后面插着显示器画面才会刷新。而 Sunshine 通过ZakoVDD 虚拟显卡驱动在软件层面造出一块显示器带来三大收益无头运行机箱放储藏室不用接显示器开机即可被 Moonlight 客户端连接串流自定义多显示器虚拟屏幕的分辨率、刷新率由你说了算支持 Auto 自动匹配客户端轻松模拟第二块显示器的串流场景HDR10 / HDR Vivid 全链路虚拟显示器同样支持 HDR 色彩输出串流画面色彩表现更完整独立音频控制无头显示器场景下可单独关闭音频输出避免串流到没接耳机的屏幕上发出提示音。相关实现集中在 src/display_device/ 模块中其中 src/display_device/session.cpp 负责虚拟显示器的创建、模式切换与故障提示Windows 侧的渲染由 src/platform/windows/display_vdd.cpp 完成。快速开始3 步启用虚拟显示器第 1 步安装 ZakoVDD 驱动虚拟显示器依赖 ZakoVDD 显卡驱动Sunshine 安装包已自带驱动文件与脚本打开 Sunshine 桌面端控制面板进入VDD 设置页安装向导 Setup Wizard 也会默认推荐选择 VDD点击安装Install系统会执行随包发布的install-vdd.bat脚本完成驱动安装/修复安装完成后驱动会自动校验页面从状态面板恢复为正常的编辑器界面。一键安装脚本源码位于 src_assets/windows/misc/vdd/install-vdd.bat。第 2 步选择显示器模式在 Web 配置界面默认地址https://localhost:47990的显示器相关选项中将显示源设为VDD虚拟显示器分辨率与刷新率可以选AutoSunshine 会在串流启动时自动匹配客户端设备支持的模式。配置项说明参考官方文档 docs/configuration.md。第 3 步启动串流用 Moonlight 客户端连接后Sunshine 会先做一次无副作用的快速探测不创建屏幕、只检查驱动与控制通道确认驱动健康后才创建虚拟显示器并开始输出画面。状态诊断看懂驱动状态速查表 Sunshine 对虚拟显示器驱动有一套统一的状态词汇表定义见 docs/vdd-prerequisite-closure.md桌面面板与浏览器页面看到的都是同一套状态状态含义建议操作ready驱动已安装且健康直接使用degraded驱动存在但未发布控制接口执行修复not_installed驱动未安装点击安装并继续unhealthy驱动不健康修复或重启reboot_required需要重启系统重启后重试同时Sunshine 还暴露了GET /api/vdd/status接口供独立浏览器用户查看准确状态。启动串流时如果驱动缺失会返回两个明确的错误码而不是笼统的串流失败VDD_DRIVER_NOT_INSTALLED虚拟显示器驱动未安装 → 打开 VDD 设置页安装VDD_DRIVER_UNAVAILABLE驱动已装但不可用 → 执行修复或按提示重启 Windows。这一整套先探测、再引导安装/修复的闭环设计让新手再也不会遇到点了没反应的死胡同。控制通道协议细节可参考 src/display_device/vdd_control_ioctl.h。进阶多显示器与无头场景技巧 把串流机当纯游戏服务器选择 VDD 后将系统音频输出指向虚拟声卡配置项virtual_sink既保留串流音频又避免本机喇叭/显示器发声第二显示器串流无头显示器作为第二屏幕时可关闭该显示器音频让声音走主屏设备分辨率与帧率游戏支持的高刷模式如果虚拟显示器没发布对应模式把分辨率和 FPS 都设为Auto最省心HDR 小毛病使用 VDD 串流时如果 HDR 色彩显示异常可在配置中开启关闭再打开 HDR的自动修复选项具体见 docs/configuration.md 中 VDD HDR 相关说明。相关模块与文档清单 模块 / 文档说明src/display_device/虚拟显示器核心逻辑会话、配置解析、驱动工具src/platform/windows/display_vdd.cppWindows 下 VDD 渲染实现src/platform/windows/display_vdd_vram.cppVDD 显存路径实现docs/vdd-prerequisite-closure.md驱动前置条件与状态契约设计docs/windows_vdd_sealed_frame_channel.mdVDD 帧通道设计说明docs/configuration.md全部配置项含虚拟声卡、编码器想要深入源码可克隆仓库git clone https://gitcode.com/gh_mirrors/sunshine5/Sunshine总结Sunshine 虚拟显示器让游戏串流主机真正脱离了显示器的束缚装一个驱动、选一个 Auto闲置主机秒变 7×24 在线的游戏服务器多显示器、无头运行、HDR 串流统统拿下。按照本指南的三步流程操作再配合状态速查表排障你基本不会在配置过程中卡住。快去试试把你的 PC 变成随时可用的串流中枢吧【免费下载链接】foundation-sunshineSunshine fork: an enhanced sunshine, a self-hosted game streaming host for Moonlight with HDR10/HDR Vivid, virtual displays, advanced audio, optimized encoders, and a modern control panel.项目地址: https://gitcode.com/gh_mirrors/sunshine5/foundation-sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
