免费游戏串流服务器Sunshine完整指南：5分钟把游戏PC变成家庭云游戏平台
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
如果你只想让客厅电视、手机平板都能流畅玩上书房那台游戏 PC，Sunshine 游戏串流服务器就是答案。它是 Moonlight 客户端的自托管主机，把游戏画面经 AMD、Intel、NVIDIA 硬件编码后低延迟推送到任意设备，全程免费、数据留在自己手里。
为什么要把游戏串流到客厅和手机
高性能主机往往锁在书房，而你想窝在沙发、躺床上或出差路上继续玩。Sunshine 解决的正是这件事：它把本地主机变成一个串流服务端，你拿任何一台装了 Moonlight 的设备（手机、平板、电视盒子、另一台电脑）连过来，游戏画面、声音、手柄输入全部实时同步，游戏本体始终只装在主机上。
好处很直接——主机只配一次，所有设备共用同一个游戏库，无需在每台设备重复下载。
5分钟跑通安装与首次配对
- 装主机端：从官方发布页下载对应系统的安装包（Windows 用
.msi，Linux 用deb/rpm/flatpak，macOS 用.dmg），安装后它会以后台服务形式常驻。想自己从源码构建的话，克隆仓库再按构建文档走： - 打开 Web 管理页：浏览器访问
https://localhost:47990，第一次会让你设管理员账号和密码（记好，后面配对要用）。浏览器提示"不安全"是因为自签名证书，忽略即可。 - 添加应用：在 Applications 标签里加"桌面"或某个游戏（比如 Steam），给每个应用配启动命令。
- 客户端配对：在 Moonlight 里手动添加这台主机，它要 PIN 时，回 Web 页点导航栏的 PIN，输入并给设备起个名字。
- 开始串流：Moonlight 里选刚加的应用，画面就到客户端了。
Sunshine 首次启动的欢迎页，支持深色与浅色主题切换
想直接看完整步骤，可对照 docs/getting_started.md。
凭什么选它而不是别的串流方案
- 三大显卡硬件编码通吃：NVIDIA 走 NVENC、AMD 走 AMF/VAAPI、Intel 走 QuickSync/VAAPI，macOS 走 VideoToolbox，没有对应硬件时还有软件编码兜底。不管你的显卡是哪家的，都能用上它自己的硬件编码器，CPU 基本不参与压码。
- 自托管，数据不出家门：不依赖任何第三方云服务，画面流和账号都留在本地网络，隐私和连接稳定性都握在自己手里。
- 一次部署多端复用：客户端是生态成熟的 Moonlight，Windows、macOS、Linux、Android、iOS、TV 都有现成版本，同一套游戏库随处可进。
Sunshine 管理界面支持深色与浅色主题，可按喜好切换
三个高频场景，直接照着做
如果你正在把书房主机接到客厅电视：在 Applications 里放一个"桌面"应用，电视盒子装 Moonlight，用无线手柄连过来即可。想换串流哪块屏幕，串流中按Ctrl+Alt+Shift+F1~F12切换显示器。
如果你想在手机上远程玩家里的游戏：手机连 5GHz Wi-Fi，Moonlight 配对主机。想从外网回家串流，需要在路由器做端口转发，并在配置里启用 UPnP 自动转发，减少手动改端口的麻烦。
如果想在办公室 Mac 和家里 Windows 之间共享游戏库：两台设备都装 Moonlight，指向同一台主机即可，游戏只装一次，进度自然延续。
Sunshine 精选应用页，可找到适合各设备的 Moonlight 客户端
局域网码率、分辨率、帧率怎么设
码率是"清晰度 vs 网络压力"的平衡点，先给两组稳妥起点，再按自己网络微调：
- 局域网（同一路由器下）：1080p / 60fps，码率 20~50 Mbps，通常丝滑。
- 远程或弱网：降到 720p / 30fps，码率 5~15 Mbps，优先保证不卡。
- 主机端尽量插网线，客户端用 5GHz Wi-Fi；带宽给 Sunshine 单独设 QoS 优先级更稳。
不确定网络能不能扛住高码率，可以先用 iPerf3 测一下稳定性（关键不是带宽而是丢包和抖动，理想丢包 <5%、抖动 <1ms）：
iperf3 -s iperf3 -c {主机IP} -t 60 -u -R -b 50M码率上限对应配置项max_bitrate（单位 Kbps），更多编码参数见 docs/configuration.md 与 docs/performance_tuning.md。
Sunshine 配置搜索页，顶部搜索框能快速跳转到码率、分辨率等设置
四类常见故障，各给三步排查
连不上 / 频繁断连
- 检查主机防火墙是否放行了 Sunshine 相关端口。
- 确认客户端和主机在同一网段（局域网）。
- 打开 Web 页 Troubleshooting 标签看日志，逐条定位报错。
画面卡、延迟高
- 先降码率、降分辨率/帧率再逐步加回。
- 确认显卡驱动正常、当前用的是硬件编码而非软件编码。
- 看一眼主机 CPU/GPU 占用是否打满。
手柄不识别 / 游戏里没反应
- Windows 确认虚拟手柄驱动装好（ViGEmBus 或 Virtual HID），装完建议重启。
- Linux 把运行 Sunshine 的用户加进
input组并重启会话。 - 检查客户端手柄映射是否选对。
编码器报错 / 起不来
- 看日志里的具体错误，多半指向驱动或 GPU 不支持。
- 确认显卡型号与驱动版本满足要求。
- 换一个编码器（比如从 NVENC 切到 VAAPI 或软件编码）验证。
忘了 Web 页密码时，用下面命令重置：
sunshine --creds 新用户名 新密码Sunshine 故障排除日志页，可逐条浏览警告和错误，快速定位问题
完整排查清单见 docs/troubleshooting.md。
深入文档、源码与社区
- 配置全参数：docs/configuration.md，含
max_bitrate、dd_manual_resolution等每项说明。 - 性能调优：docs/performance_tuning.md，如 AMD 开 Enhanced Sync、NVIDIA 开 Fast Sync 可再降一帧延迟。
- 视频编码实现：src/video.cpp 与 src/nvenc/ 目录，串流网络在 src/rtsp.cpp、src/network.cpp，音频在 src/audio.cpp，各平台采集在 src/platform/。
- 构建与贡献：docs/building.md、docs/contributing.md，社区讨论可在官方 Discord 与文档站点进行。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
