Sunshine 游戏串流服务器完整教程：5 步免费装好，把第一帧串到电视上
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
主机压在书房桌下，屏幕却在客厅——搬不动、拉 HDMI 又碍事。Sunshine 是一个免费、自托管的游戏串流服务器：它跑在你自己的主机上做画面采集和硬件编码，Moonlight 客户端装在电视、平板或另一台电脑上负责解码，全程走你家的局域网，画面不出门、不收订阅费。这份教程带你 5 步走通：装服务端、完成 Moonlight 配对、加应用、调一个参数，最后把常见故障一次查清。
先把主机变成串流服务器
服务端装在"有显卡、跑得动游戏"的那台主机上。
- Windows：到项目 Release 页下载 Sunshine-Windows-AMD64-installer.msi，双击安装，按需勾选组件；安装器会写好防火墙规则，并把它注册成开机自启的服务。
- Linux：按发行版选 deb（Debian/Ubuntu）、copr（Fedora）或 pacman（Arch）包安装。装完执行下面命令把服务跑起来：
systemctl –user start app-dev.lizardbyte.app.Sunshine
- macOS（实验性，暂不支持手柄）：把 DMG 里的 Sunshine.app 拖进 Applications，首次启动会给屏幕录制和麦克风授权。
装好之后服务端就在后台守着，随时可以串。
配对：让 Moonlight 认出主机
浏览器打开 https://localhost:47990，这是 Sunshine 自带的 Web 管理界面。它用自签名证书，浏览器提示"不安全"时点继续访问即可。第一次进入要设管理员用户名和密码——后面配对全靠这套凭据，记好。
在电视或平板上打开 Moonlight，它会自动扫到局域网里的这台主机。首次连接时 Moonlight 弹出一个四位 PIN 码，回 Web 界面顶部导航的 PIN 页输入 PIN、给设备起个名字，看到成功提示就算配对通了。
加应用，串出第一帧
配对完，Moonlight 里已经能看到主机和自带的 Desktop 应用——它不启动任何程序，直接把整个桌面串出来，点进去就是第一帧画面。
想串游戏就再建一条：填应用名、路径、工作目录和启动参数，路径支持 $(HOME) 这种写法自动替换成你的用户目录。两个细节别踩：
- 会自己拉起子进程、主进程立刻退出的程序（比如直接跑 steam），要用 detached 方式启动，否则串流瞬间断。
- 用 Flatpak 装的 Sunshine，应用命令前要加 flatpak-spawn –host，否则在沙箱里找不到宿主程序。
同一时间只有一条串流，新串流会终止上一个正在跑的应用。
只碰这一处参数就够
配置页顶部有搜索框，几百个设置项输关键词直达，不用一层层翻。新手基本只需认识两个：
- max_bitrate（单位 Kbps）：默认 0，表示完全听 Moonlight 端的码率请求；想让主机端给带宽封顶时，才设成比如 5000。
- encoder：默认自动挑第一个可用编码器。NVIDIA 是 nvenc、Intel 是 quicksync、AMD 是 amdvce，还有 vaapi、vulkan 和 software（CPU 软编码兜底）。拿不准就留空，锁定某条通路是排障手段，不是日常操作。
串流卡顿排查：连不上与掉帧
- Web 界面打不开：多半是防火墙拦了 47990 端口，Windows 先确认 MSI 安装时防火墙规则已写入。
- 客户端发现不了主机：确认两台设备在同一局域网、服务还在跑。Linux 用 systemctl –user status app-dev.lizardbyte.app.Sunshine 看状态。
- 卡顿、掉帧：先查网络而不是 Sunshine。官方推荐用 iPerf3 做 60 秒 UDP 反向测试，主机端起服务：
iperf3 -s
客户端侧测速，看丢包和抖动，理想值是丢包低于 5%、抖动低于 1ms：
iperf3 -c {主机IP} -t 60 -u -R -b 50M
- 忘了 Web 界面密码：不用重装，sunshine –creds {新用户名} {新密码} 直接重置凭据。
再不行就翻 Web 界面 Troubleshooting 页内置的日志和告警，逐条对照提示信息定位问题；更多情形见 docs/troubleshooting.md，每个参数的完整说明在 docs/configuration.md。
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
