
Sunshine 自托管游戏串流主机完全指南从安装到远程的五步链路【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想把电脑上的游戏和桌面串到手机、电视上Sunshine 加 Moonlight 是标准开源组合Sunshine 跑在主机端负责捕捉与编码Moonlight 跑在接收端负责解码播放。这篇指南给出全流程需要的最小数字集——47990 管理页、47984-47990/tcp 与 47998-48000/udp 两段端口、四位 PIN、30Mbps 起步比特率外加硬件编码器对照表和公网远程三件套。主机没有硬件编码时 CPU 占用会明显升高功能不受影响。 部署形态选型原生安装还是容器现成主机上跑串流选原生安装不想动主机环境选 Docker。两条路都先解决服务常驻问题后面才谈得上配置。在 Linux 上安装 Sunshine 并启用用户服务Debian/Ubuntu 一条命令装完sudo apt install sunshine包安装顺手处理依赖和服务。装完启用用户级服务systemctl --user --now enable app-dev.lizardbyte.app.Sunshine原因服务不常驻47990 管理页就不存在配置和配对全无从谈起开机自启后重启主机也不用手动拉服务。各平台安装包与服务差异见 官方安装文档依赖清单见构建文档。Docker 部署的端口映射清单Docker 方式要同时映射 TCP 段 47984-47990 和 UDP 段 47998-48000并把配置目录挂载到容器内 /config。DOCKER_README.md 里有可直接改值使用的 run 示例UDP 后缀漏写就串不起流专治这类问题。✅ 配对成功的判断标准47990 管理页与四位 PIN判定标准就两条浏览器能打开https://localhost:47990并建好管理员账户Moonlight 端填入与主机页面一致的四位 PIN。两条都满足链路就算通了。创建管理员账户首次进入 47990 设置用户名与密码浏览器弹出的自签证书警告直接忽略。这组凭证是后续一切配置与配对的入口丢了只能重置配置找回先记到密码管理器里。获取四位 PIN 完成 Moonlight 配对在接收端手机、平板、电视或另一台电脑装 Moonlight 客户端发现不到主机就手动输入主机 IP。发起配对后主机 Web 页面会显示一个四位 PIN把它填进 Moonlight 即完成。PIN 是双方信任的握手没通过握手的客户端连会话都进不了。添加第一个可串流应用进入 Applications 页点 Add New填应用名称、可执行文件路径和启动参数。默认配置已自带 Desktop 条目先用桌面把链路验证一遍。原因桌面能串通问题就能被归类为链路故障或游戏配置错误两类不会互相污染。 编码器对照按显卡型号选硬件编码编码器决定串流延迟下限先按显卡查表再回 Web 界面确认当前跑的是 GPU 编码而不是软件编码。想看编码器为什么没启用直接翻 src/video.cpp 里的编码管线。硬件编码器速查表显卡WindowsLinuxmacOSNVIDIANVENCNVENCCUDA软件编码AMDAMFVAAPI / Vulkan Video软件编码IntelQuickSyncVAAPIVideo Toolbox无硬件编码可用时会自动退回软件编码CPU 占用明显更高画面延迟跟着上去。降低串流延迟的分辨率与比特率参数分辨率和帧率跟随接收端屏幕实际规格不必硬上 4K射击、竞速保帧率剧情向保分辨率有线局域网从 30Mbps 起步无线和远程场景各降一档预设在低延迟与高质量里二选一别混用。编码速度决定延迟底线带宽决定画质上限这两组参数分开调。配置页条目多用顶部搜索栏按关键词直达每项的完整说明含比特率、预设、upnp 开关查配置参考。 公网三件套UPnP、TLS 与 DDNS走出局域网只需要三件事放行端口、加密链路、固定域名。缺一件就出现连不上或明文裸奔。UPnP 自动放行串流端口在 Network 页打开 upnp 开关Sunshine 会请求路由器自动开放所需串流端口实现见 src/upnp.cpp。端口没转发成功就从这份代码入手排查。路由器不支持 UPnP 就登录路由器后台手动放行 47984-47990TCP与 47998-48000UDP两段。画面流和控制流走的是不同端口段漏一段就会出现能连上但画面不动。公网链路开启 TLS 与 DDNS 域名TLS 打开后视频与输入都走加密通道。原因不加密时公网上的视频流和按键输入都能被截获。家用宽带 IP 漂移频繁给路由器绑一个 DDNS 域名Moonlight 里填域名即可IP 变了客户端不用动。 故障速查按固定顺序排查排错有固定顺序跳着查只会浪费时间。客户端找不到主机的排查顺序服务在运行 → 两端同一局域网 → 防火墙放行 47984-47990 → 手动输入主机 IP。原因前三项由便宜到昂贵每排除一层就把怀疑面砍掉一半最后手动填 IP 能绕过广播发现的失败场景。逐项清单见官方排错页。卡顿、马赛克的排查顺序换网络有线优先→ 降一档比特率 → 更新显卡驱动。原因多数马赛克是比特率超出带宽承受值先动最便宜的变量驱动更新放最后因为编码器对驱动版本敏感属于兜底手段。没声音与输入延迟高的处理没声音先排除主机上独占音频的程序再切换音频输出设备。输入延迟高关闭键盘、鼠标、手柄的省电模式关掉接收端吃带宽的后台应用。多个客户端画质不一致属正常行为主机按最高规格送画面各客户端在自己端独立调整压缩参数。编码器加载失败、网络断流这类提示直接写在 Logs 页下一步挑一款常玩的游戏从 DDNS 域名在 Moonlight 里发起串流把公网链路完整走一遍。再遇报错先翻 Logs 页最近几条——编码器与网络类故障通常写得非常直白看完日志再回到上面的顺序定位。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考