把书房搬进卧室Sunshine 游戏串流服务器搭建实录与避坑心得【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine有没有那么一刻你明明坐在书房的电竞椅上心里却惦记着客厅沙发上的大屏Sunshine 游戏串流就是为这种时刻准备的——它是一款完全开源、可自托管的游戏串流服务器专为 Moonlight 客户端而生能在 Windows、Linux、macOS、FreeBSD 上运行覆盖 NVIDIA、AMD、Intel 三大显卡阵营的硬件编码实在没有显卡加速时还有软件编码兜底。这篇文章按我实际踩过的顺序把从装到玩的每一步、每个坑都摊开讲希望你走得更顺。 开工之前三分钟确认你的电脑够不够格串流服务器本质上像一个游戏外卖店电脑负责把画面烤熟编码网络负责配送传输客户端负责摆盘解码。所以先别急着装确认三件事。第一显卡能不能编码。主流方案是 NVIDIA 的 NVENC、AMD 的 AMF 和 Intel 的硬件编码。你可以在项目的功能兼容说明里对照自家显卡如果机器很老编码全部落空Sunshine 还能退回 CPU 软编码只是延迟和占用会明显变差。第二系统认不认你。官方二进制覆盖四大平台但细节有差异。比如手柄模拟就不是全平台一碗水端平DualSense 目前只在 Linux 上模拟成功Xbox 360 手柄模拟则只有 Windows 可用——想用手柄串流装之前最好先扫一眼 README 里的兼容矩阵。第三网络是不是短板。流媒体讲究的不是带宽上限而是稳定性延迟低、抖动小、几乎零丢包。千兆有线是最稳的退而求其次也要 5GHz WiFi。一句话结论带 NVENC/AMF 级显卡、系统是 Win 或主流 Linux、网络走有线的机器闭眼入。 按系统挑安装路径三种姿势总有一种省心Sunshine 的安装方式很多选对了能省下大把调参时间。Windows 用户优先下载官方 MSI 安装器一路下一步即可它会顺带把防火墙规则和服务注册好。想手动折腾的话仓库的 src_assets/windows/misc/ 下也提供了防火墙与服务安装脚本add-firewall-rule.bat、install-service.bat适合爱干净的玩家。Linux 用户按这个优先级选——发行版自带包 Flatpak AppImage。Flatpak 的安装命令很简短flatpak install --system flathub dev.lizardbyte.app.Sunshine装完建议用 systemd 用户服务托管开机自启不操心systemctl --user --now enable app-dev.lizardbyte.app.SunshinemacOS 用户下载 DMG 拖入 Applications或用 Homebrew 安装。首次启动记得在弹出的系统弹窗里授予屏幕录制和麦克风权限否则串流出去的画面和声音都是黑的。想从源码构建的朋友可以克隆仓库后参考 docs/building.md 的依赖说明git clone https://gitcode.com/GitHub_Trending/su/Sunshine至于 Docker 镜像虽然官方有提供但文档里明确标注不推荐大多数用户使用——容器里跑串流服务器显卡直通和输入设备这两关会让人头疼除非你已经熟悉 GPU 容器化否则先走原生安装。 第一次打开控制台账号、主题和那排吓人的警告装好后打开浏览器访问https://localhost:47990把 localhost 换成内网 IP 也行。第一眼大概率是浏览器的证书不受信任警告——不用慌这是自签名 SSL 证书点继续访问即可。首次进入会要求你创建用户名和密码务必记牢。之后可以在导航栏的菜单里切换界面主题Windows 玩家这里还有一个隐藏步骤想让虚拟手柄生效需要先安装 ViGEmBus 驱动。它不用单独去官网找直接在 Web 界面的 Troubleshooting 标签页里点一下就能装前提是 Sunshine 以管理员或服务方式运行 把第一个游戏搬上串流应用管理其实很简单Sunshine 把串流什么抽象成了一个个应用Application。官方出厂预置了桌面串流和 Steam 大屏模式两个入口你可以在此基础上添加任意游戏或启动器。添加应用只需要填三样东西显示名称、启动命令、工作目录。比如加一个 Steam 游戏命令写C:\Program Files (x86)\Steam\steam.exe -applaunch 570之类即可。所有应用列表会持久化到apps.json想批量导入可以手动编辑这个文件。小提示每个应用还支持独立的前置命令global_prep_cmd适合启动游戏前先开加速器、先切音频设备这类需求串流整机时尤其好用。⚙ 画质与延迟的平衡术按这个顺序调参数默认设置下多数人就能流畅跑起来但想让画面更锐、延迟更低建议按下面的顺序微调。控制台右上角的搜索框能帮你秒定位任意配置项配置项作用我的经验取值max_bitrate码率上限画质与带宽的权衡1080p 起步 20000–30000 Kbps4K 再翻倍hevc_mode/av1_mode换更高效的编码省带宽客户端支持就开 HEVC新显卡可试 AV1fec_percentage前向纠错冗余抗丢包默认即可丢包严重再上调packetsize单包大小1024–1400弱网别贪大nvenc_presetNVIDIA 编码预设延迟优先往 p1 方向选性能敏感场景选低值另外Linux 用户如果用的是 Flatpak 或 AppImage 这类沙箱安装高负载时可能遇到编码器掉帧——日志里会出现CAP_SYS_NICE相关警告。官方排查文档给出的建议是KDE 桌面优先kwin或portal采集 Vulkan 编码GNOME 等桌面优先portal采集 Vulkan 编码详见 docs/troubleshooting.md 的推荐配置表。 客户端配对全流程从发现主机到输入 PIN服务端就绪后轮到客户端登场。Moonlight 有 PC、Android、iOS、嵌入式等多个版本官方在控制台的 Featured Apps 页面里整理了各平台客户端入口和配套工具不用到处找配对流程只有三步在 Moonlight 里手动添加主机填入 Sunshine 所在电脑的内网 IP自动发现失败时多半是广播被防火墙拦了Moonlight 会弹出一串 PIN 码回到 Sunshine 控制台在导航栏的 PIN 页面输入这串码并给设备起个名字回车看到成功提示即可。配对成功后串流过程中还有几个快捷键值得记CtrlAltShiftN可隐藏/显示鼠标指针CtrlAltShiftQ可退出串流和 Moonlight 的约定保持一致。 卡顿、掉帧、连不上四步排查法串流出问题九成出在网络。我的排查顺序固定是下面四步。第一步查端口与防火墙。Sunshine 的 Web 界面默认走 47990串流与配对数据分布在 47984–48010 之间。设备互访失败先把这些端口在主机和路由器上放行。第二步用 iperf3 给网络体检。光看网速没用串流要的是低抖动、低丢包。在主机上起服务端iperf3 -s在客户端发起 60 秒 UDP 反向测试iperf3 -c 主机IP -t 60 -u -R -b 50M看输出里的 jitter 和 packet loss丢包率应低于 5%抖动最好压到 1ms 以内。指标难看说明问题出在网络而非 Sunshine 本身。第三步警惕主机网卡太快。有个反直觉的坑主机网卡速率远超客户端时比如 2.5G 对 1GSunshine 每 16ms 突发一次的数据会在中间设备上积压溢出表现为大面积丢包。临时解法是手动把主机网卡降到和客户端同速长期方案是配置流量整形只限制串流端口47998 的 UDP具体命令在 docs/troubleshooting.md 里有完整示例。第四步翻日志。控制台的 Troubleshooting 标签页能直接按级别浏览日志每个警告/错误都能点开看详情另外两个高频小坑提前排掉忘记 Web 密码了用sunshine --creds 新用户名 新密码一行重置鼠标操作怪异在主机上插一只物理鼠标往往就好了——这些都是官方文档里明确记载的解法。✅ 收尾一张行动清单与三份必读文档最后把全文收敛成五步行动清单照着做就能从零跑到玩上对照显卡与系统确认硬件编码可用按平台选最省心的安装方式跑起来并访问 47990 端口创建账号、装好虚拟手柄驱动用 PIN 完成首次配对从桌面应用开始试串流稳定后再按参数表逐项微调出现异常时按端口 → iperf3 → 网卡速率 → 日志的顺序排查。想深入的话这三份文档是官方维护的一手资料docs/getting_started.md 覆盖各平台安装与初始设置docs/configuration.md 是全部配置项的权威字典docs/troubleshooting.md 则收录了社区踩过的各类坑。想看实现细节编码相关源码在 src/nvenc/各平台采集与输入实现在 src/platform/。把游戏从书房搬到卧室其实只差一个 Sunshine 的距离。选对安装姿势、按顺序调好参数、记住四步排查法剩下的就是躺平享受了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考