Sunshine 游戏串流服务器新手实操指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在客厅电视上玩 PC 游戏又不想把主机从书房搬过去Sunshine 是一款自托管的游戏串流服务器装在游戏电脑上用显卡硬件编码把画面低延迟地推给 Moonlight 客户端手机、平板、智能电视上都能接着玩。Sunshine 是什么定位与能力边界Sunshine 是专为 Moonlight 客户端设计的自托管串流主机解决的核心问题是把一台游戏 PC 的桌面或游戏画面连同键盘、鼠标、手柄输入低延迟地搬到另一台设备上。它自带 Web 管理界面负责配置和客户端配对。简单说主机端装 Sunshine客户端设备装 Moonlight两者通过局域网或打洞后的公网通信。适合想低成本搭建家庭云游戏的玩家也适合需要远程操控自己电脑的场景。明确不适合的情况纯离线、无稳定局域网的环境串流本质是实时推流网络是命脉多人同时观看同一路串流Sunshine 面向一对一串流不是直播推流macOS 主机官方标记为实验性且手柄暂不支持需要极低延迟竞技网游的玩家串流延迟通常高于本地运行具体看 性能调优指南 了解可优化空间游戏串流硬件门槛最低与推荐配置Sunshine 支持 Windows、Linux、macOS 和 FreeBSD各平台的具体功能差异见 官方上手文档。硬件方面最低线不高但要舒服地串 1080p建议往推荐配置靠。组件最低配置显卡带硬件编码器的显卡NVENC / AMF / QuickSync / VAAPI 之一CPU双核以上、能开硬件加速内存4 GB网络5GHz WiFi 或有线均可客户端与主机同局域网5GHz 网段优先组件推荐配置4K 串流显卡近两代中端以上独显RTX 2000 系 / RX 5000 系或更新CPU4 核以上内存8 GB 以上网络主机与客户端均走有线以太网存储游戏与系统放 SSD跑通 Sunshine 最小可用版本各平台都走包管理器或安装包装完打开浏览器访问https://localhost:47990即可。浏览器会提示证书不安全这是自签名证书的正常现象点继续访问就行。首次进入没有默认账号界面会让你自己设置用户名和密码——记得当场记下来忘了也能用sunshine --creds重置见下文故障表。Windows一条 winget 命令winget install LizardByte.Sunshine安装器默认会装成系统服务开机自启。装完直接开浏览器访问https://localhost:47990设置好账号就进入了串流服务器的管理页面。Linux发行版包管理器安装以 Debian/Ubuntu 为例官方仓库提供 deb、rpm、AppImage、Flatpak 等按需选择sudo apt install sunshine装完执行systemctl --user start app-dev.lizardbyte.app.Sunshine启动服务然后打开https://localhost:47990完成首次设置。macOSHomebrew 或 DMGbrew tap LizardByte/homebrew brew install sunshine或直接从发布页下载 DMG 拖入应用程序。首次启动会请求屏幕录制和麦克风权限都要同意之后访问https://localhost:47990设置账号。注意 macOS 版本仍是实验状态。核心使用路径从添加应用到开始串流装好之后整个使用路径就是三件事往服务器里加应用、把客户端设备配对进来、点一下开始串流。在 Web 界面添加游戏或应用进入 Web 界面的应用管理页Desktop 这一项默认就有代表串流整个桌面。有 Steam 的话直接添加 Steam游戏库会自动出现支持大封面展示。独立游戏或模拟器手动填名称、可执行文件路径和启动参数即可。应用列表存在配置目录的apps.json里改 Web 界面即改文件无需手动编辑。Moonlight 客户端配对在客户端设备上安装对应平台的 MoonlightWindows、Android、iOS、Linux、电视盒子都有客户端。在 Moonlight 里找到 Sunshine 主机同局域网一般自动发现发起配对请求。回到 Sunshine 的 Web UI点导航栏的 PIN输入屏幕上显示的 PIN 码并给设备起个名字。看到成功提示后配对完成之后连接不再需要 PIN。开始串流在 Moonlight 的应用列表里选中刚添加的游戏或 Desktop。确认分辨率、帧率、码率设置首次用默认值即可点开始。画面推送到客户端后键盘、鼠标、手柄输入会实时转发回主机。串流结束直接断开即可已启动的独立游戏进程会随串流关闭而结束。串流效果调优编码器、网络与分辨率取舍影响体验的变量就三个编码器、网络、分辨率与帧率。默认值覆盖大多数场景出问题再针对性改不要一上来全翻一遍。编码器选择对比默认行为Sunshine 自动选择当前显卡对应的硬件编码器。一般不用动出现花屏、编码器报错、或显卡较老时才需要手动指定。编码器对应硬件延迟备注NVENCNVIDIA低综合最稳AMF / VAAPI (AMD)AMD低Linux 上 AMD 用 VAAPIQuickSync / VAAPI (Intel)Intel 核显中核显机器够用软件编码 (libx264)无硬件编码器时高CPU 占用大仅当兜底网络模式与带宽默认走局域网 UDP无需任何配置。串流对网络的要求不是带宽大而是稳定、低抖动。何时改客户端只能走 WiFi 且隔墙或想从外网回连家里时。改成什么客户端尽量 5GHz 或有线外网连接开启 UPnP 让 Sunshine 自动映射端口配置项在 Web UI 的 Network 分区完整选项见 官方配置文档。判断标准用 iperf3 测一下端到端链路丢包低于 5%、抖动低于 1ms 才算合格方法见 故障排查文档。分辨率与帧率匹配默认由客户端按设备能力协商大多数情况保持默认即可。场景建议值说明日常游戏1080p / 60fps带宽与画质平衡点高刷显示器串流1440p 或 1080p / 高帧率帧率优先于分辨率弱网环境720p / 60fps 并降码率先保流畅再谈画质改法在 Moonlight 客户端的串流设置里调主机端 Web UI 可设max_bitrate上限。两端分辨率不一致时画面会拉伸尽量对齐。卡住了怎么办Sunshine 高频故障速查绝大多数问题集中在下面五种现象按现象→原因→动作对照处理现象常见原因处理动作打不开 Web UI47990 无响应服务没起来 / 防火墙拦了确认 Sunshine 进程在跑放行 47990 端口忘记密码进不去凭据遗忘运行sunshine --creds 新用户 新密码重置黑屏无画面Linux 采集源选错KMS/X11/Wayland在 Web UI 检查采集后端与输出设备设置手柄无响应Linux 缺 input 组权限 / Windows 缺虚拟 HID 驱动Linux 把用户加入input组Windows 装好 Virtual HID Driver卡顿、丢帧buffer overrun链路不稳、带宽不足换有线/5GHz降分辨率或码率Web UI 里的 Troubleshooting 页签自带日志检查入口逐条过一遍 warning 和 error 通常就能定位到具体配置项日志文件默认叫sunshine.log位置可用配置项log_path查看日志级别用min_log_level调整两项都在 官方配置文档 里有完整说明。安全与日常维护要点 管理端设强密码Web UI 用自签名证书加账密保护密码是唯一实质防线别用弱口令。端口最小化只放行实际用的端口47990 管理、串流基础端口 47989 起的一段不用外网就别开 UPnP 和端口转发。定期更新跟版本走编码器和采集后端的修复大多藏在版本更新里。网络隔离有访客网络就把它隔离开串流流量只留在内网段。进阶方向HDR、多显示器与自定义帧率基础链路跑通之后可以按需解锁这些能力配置细节都在 官方配置文档 里此处只列名字HDR 串流Windows 主机正式支持Linux 实验性支持需要主机开启 HDR 且客户端同步打开 HDR。多显示器多个输出设备可切换采集哪个屏幕快捷键CtrlAltShiftF1~F12串流中也能切。自定义分辨率与刷新率在 Desktop Duplication 相关配置里锁定特定模式避免串流时分辨率被应用改写。音频高级配置指定audio_sink采集特定设备或环绕声支持 Steam Streaming Speakers 方案。选定一台常开的游戏 PC装好 Sunshine 并打开https://localhost:47990设置好强密码在应用列表里加好 Desktop 和想串的游戏客户端设备装 Moonlight用 PIN 完成首次配对按编码器→网络→分辨率的顺序验证一遍默认设置卡顿再逐项调顺手把配置目录里的sunshine.conf和apps.json备份一份到这里串流链路就已经通了。先拿一个 3A 大作试一把客厅的电视大概率会让你改掉主机必须挨着人这个习惯。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考