5 步搭好 Sunshine 游戏串流服务器：Moonlight 低延迟串流完整指南

5 步搭好 Sunshine 游戏串流服务器Moonlight 低延迟串流完整指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想象这样一个场景你窝在沙发上把客厅那台大屏电视接上设备拿起手柄就能在自家网络上把一台游戏主机或 PC 里的 3A 大作完整串出来——画面实时推送到屏幕输入延迟压到几乎无感。这不是云游戏机房而是你电脑本地跑的一个自托管服务。Sunshine 游戏串流服务器就是干这件事的它负责采集画面、用显卡硬件编码、再把音视频推给 Moonlight 客户端。项目速览它是什么、为谁服务一句话概括Sunshine 是一个开源、免费、自托管的游戏串流主机专门搭配 Moonlight 客户端使用让你把任何一台电脑变成局域网乃至外网里可串流的「游戏主机」。对普通用户来说它最大的价值是把「画质、延迟、成本」这三件事一次解决不用买盒子、不用订阅数据全留在本地。关键信息说明定位自托管游戏串流主机负责采集 / 硬件编码 / 推流支持平台Windows、Linux、macOS另支持 FreeBSD是否免费开源免费可商用配套客户端MoonlightPC / Android / iOS / 嵌入式默认端口Web 管理界面47990串流端口从47989起的一组端口部署位置你自己的电脑本地完全自主掌控上手前自检先确认环境没问题跑通串流前先花两分钟核对下面几点能省掉后面一半的排查时间。系统Windows、Linux 或 macOS 之一。macOS 属于实验性支持功能如游戏手柄不完整。显卡有独立显卡最好。NVIDIA 走 NVENC、AMD 走 AMF、Intel 核显走 QuickSync都能在 GPU 上完成编码几乎不占 CPU没有独显就退回到软件编码x264/x265会吃 CPU。网络串流主机和客户端尽量在同一局域网优先有线千兆有线体验最好。客户端版本在 Moonlight 的 PC、Android、iOS 或嵌入式设备上准备好对应客户端且版本足够新才能正常配对。权限Windows 会自动建服务开机自启Linux 上首次可能涉及采集权限如 KMS/NVENC 需要的驱动macOS 首次运行要给屏幕录制权限。主流程拆解从 0 到串通第 1 步安装并启动下载与你系统匹配的官方二进制包安装。Windows 是.msiLinux 按发行版选.deb/AppImage/flatpak等macOS 是.dmg。装完后 Sunshine 会在后台以服务形式常驻无需手动干预。装好即意味着端口已监听Web 管理界面在https://localhost:47990。第 2 步创建管理员账户打开浏览器访问https://localhost:47990可把localhost换成机器内网 IP。浏览器会提示「不安全」这是因为用的是自签名证书属正常现象继续访问即可。首次进入是欢迎页会要求你设置访问 Web 界面的用户名和密码。默认用户名是sunshine可改成更好记的。密码设强一点并且记下来——界面只会显示这一次忘了就得走命令行重置。第 3 步添加游戏或应用登录后进入「Applications」页系统默认已经放了Desktop整桌面和Steam Big PictureSteam 大画面模式两个入口能直接开串。点「Add New」添加你自己的游戏填名称、指向游戏主程序的可执行文件可选工作目录和启动参数再传一张图标。保存后新应用立刻出现在列表里。注意应用列表在客户端重启后才会刷新所以改完要在客户端侧重连一次。第 4 步用 Moonlight 配对连接在 Moonlight 客户端里找到你这台 Sunshine 主机局域网会自动发现找不到就手动填 IP。当它提示输入 PIN 时切回 Web 界面顶栏的「PIN」页查看当前 PIN 码填进客户端再给设备起个名字配对即完成。配对成功后客户端会列出你在 Sunshine 里配置的所有应用选一个即可开始串流。第 5 步核对配置并开始串通后回到「Configuration」页用顶部搜索框按名字定位参数下节会讲哪几个最影响体验。把分辨率、比特率、编码器调到合适再开一把游戏。关键配置详解只调这三项参数很多但真正决定「顺不顺」的就三项。下面按「默认值 → 建议值 → 原因」来讲其余保持默认即可。1. 编码器默认自动建议锁定硬件编码默认值自动检测并优先硬件编码。建议值有独显就显式固定为对应硬件编码器NVENC / AMF / QuickSync。原因硬件编码在 GPU 上完成几乎不吃 CPU延迟低、发热小适合持续高帧率串流软件编码 x264/x265 兼容性最好但吃 CPU只作为无独显时的兜底。2. 比特率按网络环境选别贪高默认值随客户端与网络协商。建议值千兆有线可拉到 20–50 Mbps5GHz 无线约 10–25 Mbps远程宽带降到 5–15 Mbps。原因比特率过高而带宽不够时画面会先「卡」后「糊」流畅度优先于极限画质。先按实测带宽留一点余量再逐步上调。3. 分辨率与帧率匹配显示端默认值跟随客户端请求。建议值1080p / 60fps 是多数环境的平衡点1440p 需要较好的局域网4K 建议只在千兆有线下尝试。原因分辨率直接决定每帧数据量越高越吃带宽和编码能力要和你实际的网络与显卡能力匹配而不是照抄上限。避坑与调优按「现象 → 排查 → 解法」走遇到卡顿时别乱试参数顺着这条链走现象画面卡顿、延迟高→ 先确认是否走硬件编码、比特率是否超出带宽 → 降到匹配网络的比特率、改用有线、关闭占用带宽的其他设备。现象客户端发现不了主机→ 确认同网段、服务在跑 → 检查防火墙是否放行47989起的一组串流端口与47990→ 仍不行就在 Moonlight 里手动填 IP 添加。现象配对一直不成功→ 确认读的是最新 PINPIN 会刷新→ 回 Web 界面「PIN」页核对再填 → 检查两端时间是否同步。现象Linux 下编码报错→ 打开「Troubleshooting」页看日志红色报错行通常直接指出原因例如编码器打不开、采集后端不匹配。日志页支持关键词检索能很快定位到出问题的编码器或采集后端。大多数「玄学卡顿」最后都能在这里找到明确报错。延伸探索进阶的下一步想继续深入从这几处入手均为仓库内相对路径入门流程与安装细节docs/getting_started.md全部配置项详解docs/configuration.md性能调优建议docs/performance_tuning.md常见疑难排查docs/troubleshooting.md服务端核心源码src/采集、编码、推流逻辑都在这里下一步建议先在你的真实网络环境下实测一轮比特率与延迟用「Troubleshooting」日志反复验证编码器确实跑在 GPU 上再考虑上 1440p / 高帧率——把地基打稳画质提升才有意义。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考