Sunshine 游戏串流从装好到出第一帧画面的完整操作手册【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine主机塞在书房桌下电视挂在客厅中间隔着两堵墙。搬机器太沉拉 HDMI 线太长再买一套硬件更贵。Sunshine 是个开源的自托管串流服务器画面在主机上采集、硬件编码走局域网送到装了 Moonlight 客户端的任意设备。免费没有订阅数据不出家门——硬件串流变成了局域网里的事。先确认你能跑四个条件打个勾动手装之前花一分钟过一遍这张表。哪条打不了勾后面会卡在哪一行写得清清楚楚。你的机器能不能跑跑不了会卡在哪主机系统Windows / Linux / FreeBSD 正式支持macOS 是实验版能跑macOS 上手柄模拟目前不可用只适合当备用画面源显卡N 卡走 NVENCIntel 走 QuickSyncAMD 走 AMF没有独显走 CPU 软编能跑老集显可能一个硬件编码通路都没有只能吃 CPU 软编4K 基本别想网络两台设备在同一网段路由器正常能跑不在同网段时 Moonlight 永远发现不了主机配对无从谈起解码端能装 Moonlight 的设备手机、盒子、电视、笔记本都行能跑客户端装不上 Moonlight服务端装得再好也没人收画面这四条里第三条是铁律局域网游戏串流的地基就是同一张网。别的都可以将就这一条不行。跟着走别跳步先装服务端。Windows 去项目 Release 页拿 MSI 安装包双击勾选组件按提示走防火墙规则安装器会顺手写好。装完它自己就是个开机自启的后台服务你不用做任何事。Linux 按发行版装 deb、rpm 或 pacman 包装完在终端敲这一条把服务拉起来systemctl --user start app-dev.lizardbyte.app.Sunshine看到命令正常返回、没报错说明服务已经在跑了想让它开机自启再加一次 enable 参数。macOS 把 DMG 里的应用拖进 Applications第一次启动会弹屏幕录制和麦克风授权都点上。再做账号。浏览器访问https://localhost:47990。地址栏冒出连接不安全的红色警告——这是自签名证书的正常反应忽略它。页面让你设置管理员用户名和密码记牢它后面配对全靠这套凭据。然后配对。在客户端设备打开 Moonlight。如果列表里自动出现主机直接下一步没出现就手动添加填主机的局域网 IP。首次连接时 Moonlight 会弹出一个四位 PIN 码。这时候回到 Web UI点顶部导航栏的 PIN 入口输入这四个数字回车顺手给设备起个名字。看到成功提示配对完成。局域网配对怎么走 PIN 那一步记住一个对应关系Moonlight 弹出四位数字 客户端已经找到 Sunshine剩下就是把数字抄回 Web UI。这一步通了选列表里自带的 Desktop 应用点开始电视上就该出主机桌面了。它真正值钱的地方编码器降级链。别的串流方案让你先研究我的卡支持什么编码Sunshine 直接按顺序试NVENC、QuickSync、AMF、VAAPI、Vulkan Video、VideoToolbox全都不行才落到 CPU 软编第一个能用的自动生效。换台机器、换个系统encoder参数留着不填就行。手动指定编码器是排障手段不是日常操作——这条认知能帮你省掉一半的配置纠结。Web UI 的全局参数搜索。配置页有几百个设置项但没有菜单迷宫。顶部搜索框直接敲参数名敲bitrate码率相关的全部浮出来敲encoder编码器选项就在眼前。改完即时生效不用找配置文件、不用重启。日常只碰三个参数就够max_bitrate单位 Kbps默认0意思是码率完全听 Moonlight 的请求。码率封顶设多少合适看你的瓶颈——想让主机端主动压住带宽比如 2.5G 网卡配 WiFi 客户端这种两头速度不匹配设5000这类数字试起瓶颈在客户端网卡封顶没意义。encoder留空自动选只有排障或明确知道哪条通路最稳时才手填nvenc、amdvce、vaapi这些。upnp默认disabled。想从公网远程串回来时把它设为enabled让 47990 等端口自动打洞代价是延迟上去、安全性交给路由器本地使用别开。你的场景长什么样书房主机 客厅电视一台永远在书房的 3A 主机。游戏主机常年吃灰在书房但你想在沙发上进游戏。装好 Sunshine 后Moonlight 列表里挑一个游戏应用点开画面就在电视上。主机端零操作游戏退出来串流自动结束桌面应用则可以直接把主机当影音节点——片源、网页、桌面软件都能串进客厅。体感上5GHz WiFi 客户端下 1080p60 基本无感延迟串电影这种静态内容时带宽占用甚至不到一根烟的功耗。游戏夜笔记本当遥控器主机当显卡。你的轻薄本核显跑不动 3A但书房那台主机闲着。两台设备同一 WiFi笔记本上装 Moonlight 配对一次游戏夜直接串书房主机。笔记本只负责解码显示功耗低、不发热主机跑满帧率。用完退出串流下一位家庭成员用自己的设备各自配对各记各的设备名——注意同一时间只有一条串流谁在串谁用。卡住了按这个顺序试按网络 → 服务 → 端口 → 日志的顺序往下走别跳级。先怀疑网络。客户端发现不了主机十有八九两台设备不在同一网段或主机侧服务根本没跑。确认两边 IP 同一网段跨网段就先解决路由器隔离AP 隔离、访客网络都算。再看服务。Linux 上用systemctl --user status app-dev.lizardbyte.app.Sunshine看状态显示 running 才算活着没跑就重新 start 一次。Windows 看系统托盘里有没有 Sunshine 图标。然后查端口。Moonlight 连不上 Sunshine 怎么办分两种情况如果 Web UI 都打不开是 47990 被拦——Windows 先确认安装时防火墙规则写进去了还不行就临时关防火墙验证一次通了再回头加放行规则如果 Web UI 能打开但客户端连不上放行 47984–47998 这一段串流端口不止 47990 一个。最后翻日志。还是不行先看 Web UI 的 Troubleshooting 页每条告警都点了问题的方向需要细看就打开日志文件——Windows 在Program Files\Sunshine\config\sunshine.logLinux / macOS / FreeBSD 在~/.config/sunshine/sunshine.logDocker 部署则用 docker logs 看容器输出。还有一招兜底串流卡顿先测网络而不是怪 Sunshine。主机起一个 iPerf3 服务端客户端跑 UDP 反向测试 60 秒理想值是丢包低于 5%、抖动低于 1ms。丢包高降一档网卡速率或把主机换有线通常立竿见影。另外忘记密码不用重装用sunshine --creds加上新用户名密码即可重置。现在就去做一件事打开手边第二台设备装好 Moonlight把 PIN 配对走完选 Desktop 串一帧画面出来。就这一步今天就能做到。想再往下看两处就够全部参数在 docs/configuration.md疑难杂症的入口在 docs/troubleshooting.md。主机让它接着跑画面先串起来线再慢慢收。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
