Nvidia 显卡上 Sunshine 使用 KMS 捕获出现黑屏时如何设置 nvidia_drm.modeset1【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine在 Linux 主机上使用 Nvidia 显卡运行 Sunshine、并通过 KMS 捕获方式向 Moonlight 客户端推流时如果流画面是黑屏官方 Troubleshooting 文档指出了一种常见原因Nvidia 的内核模块需要设置modeset1参数做法是把nvidia_drm.modeset1加入内核命令行。本文适用的前提主机系统是 Linux显卡为 NvidiaSunshine 使用 KMS 捕获capture kmsSunshine 通过发行版的原生包格式安装——原因见下文第一步Flatpak 与 AppImage 都不支持 KMS 捕获。先确认当前配置满足 KMS 捕获的生效条件修改内核参数之前先排除其他会让 KMS 捕获失效的情况否则加了参数也不会解决黑屏。Sunshine 必须是原生包安装。Troubleshooting 文档的 KMS Streaming fails 一节明确说明KMS 屏幕捕获需要更高权限而 Flatpak 和 AppImage 包不允许这些权限所以只要发行版提供原生包就必须用原生包格式.deb、.rpm、Arch 包等安装 Sunshine。Getting Started 在 AppImage 和 Flatpak 两个安装小节里也分别给出了 AppImage does not support KMS capture 和 Flatpak does not support KMS capture 的警告。如果你目前用的是这两种方式换成原生包后再谈 KMS 捕获。确认捕获方式确实是 KMS。configuration.md 中capture配置项用于强制指定屏幕捕获方法示例为capture kms该文档同时给出了 KMS 选项的两条限制仅适用于 Linux且要求 Sunshine 拥有cap_sys_admin能力。若你已在配置中固定为 KMS且确认是原生包安装仍然流出来的是黑屏再进行下一步。设置内核参数 nvidia_drm.modeset1Troubleshooting 文档的 KMS streaming fails on Nvidia GPUs 一节的原文表述是如果 KMS 屏幕捕获导致流出来的是黑屏可能需要为 Nvidia 内核模块设置参数modeset1这可以通过把下面这条指令加入内核命令行完成nvidia_drm.modeset1文档同时说明具体如何修改内核命令行需要查阅你所在发行版的文档大多数发行版使用 grub 来加载内核并设置其命令行。因此实际操作是编辑 grub 的启动配置把上面这行追加到内核启动参数中——不同发行版编辑 grub 的具体步骤不同此处以发行版自身文档为准。注意这是内核级参数内核命令行只在内核加载时生效所以改完配置后需要重启系统。验证结果文档给出的现象就是判断标准本身修改前 KMS 捕获流出的是黑屏。重启完成后再次启动 Sunshine 并让客户端重新连接如果流画面不再是黑屏、能正常看到主机桌面说明参数已生效。文档中 may need to 的措辞也提示若黑屏依旧应回到第一步检查安装方式与捕获配置而不是重复修改内核参数。边界与替代路径KMS 捕获即将被替代。Troubleshooting 文档明确写道 KMS 捕获将逐步让位于 XDG Portal 捕获后者对所有包格式都可用。如果你的发行版已提供 Portal 捕获这是更通用的路径黑屏问题也就绕开了。KDE Plasma 6.5 上的另一类 KMS 问题。该版本中 KWin 的 overlay 支持会干扰 KMS 捕获表现为窗口闪烁或消失可用环境变量临时关闭export KWIN_USE_OVERLAYS0文档提醒这会降低 KWin 的渲染效率并建议优先考虑 XDG Portal 捕获。这与黑屏是不同的现象排查时不要混淆。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考