Sunshine 串流主机搭建清单:从零装到电视出画
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一套自托管游戏串流服务器,装在自己 PC 上,Moonlight 客户端就能把画面和声音实时投到电视、平板或手机。按这份清单走,你能完成首次串流,还能处理常见的卡点。
开工前确认这四项
| 项目 | 要求 | 不满足怎么办 |
|---|---|---|
| 主机显卡 | 带硬件编码(NVIDIA/AMD/Intel 核显)优先 | 改用软件编码,分辨率限 720p |
| 主机网络 | 局域网可达,有线千兆优先 | 改插网线,或至少保证 WiFi 稳定 |
| 接收端设备 | 已装 Moonlight 客户端 | 先给电视/平板/手机装对应版本 |
| 系统权限 | Windows 服务安装、Linux 屏幕录制权限 | 按下面各平台提示授予 |
确认完毕就可以动手了。各平台路径不同,但终点都一样:托盘图标亮起来。
安装 Sunshine,看托盘图标亮没亮
Windows
到发布页下载最新 MSI,双击一路下一步。装完看任务栏托盘,出现 Sunshine 图标,说明服务已经在后台跑起来了。
Linux
Debian/Ubuntu 装官方.deb,Arch 用 AUR 的sunshine,Fedora 走 copr 源;图省事直接 Flatpak:
flatpak install --user flathub dev.lizardbyte.app.Sunshine执行后出现下载和安装进度条,跑完接着让它开机自启:
systemctl --user --now enable app-dev.lizardbyte.app.Sunshine执行后没有任何报错输出就是正常,然后看系统托盘里有没有出现 Sunshine 图标。
macOS
下载对应架构的 DMG,拖进"应用程序",首次启动允许屏幕录制和麦克风权限。这个版本还是实验性质,手柄暂不支持。托盘里看到图标就算装好了。
装好之后先别碰编码器,用最小配置把第一次串流通了再说。
一条线走完:建账户、加应用、配对设备
- 浏览器打开
https://localhost:47990,自签名证书警告直接继续访问。首次进入要设管理员用户名和密码,当场抄进备忘录,之后再也看不到它。
这是首次打开管理页时的欢迎页,用户名和密码就设在这一屏。
- 进"Applications"标签加两条:桌面模式不填任何命令,整个桌面直接串出去;Steam 大屏在可执行项填
steam://open/bigpicture。
这张图展示的是"应用"标签页,就是管理哪些程序能被串流出来的地方。
- 电视或平板上打开 Moonlight,它会自动发现局域网里的这台主机,弹出配对提示。
- 回到 Web 页,点导航栏的 "PIN",输入客户端上显示的 PIN,给设备起个名字确认。
- 看到成功提示后,回 Moonlight 点你刚加的应用连接。
画面出来、手柄一按有反应,第一次串流就成了。比如周末午后主机 PC 留在厨房运转,你窝在阳台的沙发用大屏电视开玩,全程走自家局域网,没有第三方服务器,也没有订阅费。
编码器选错,画质和延迟都会吃亏,下一步对号入座。
按显卡选编码器,把延迟压下去
| 显卡 | 推荐编码器 | 一句话理由 |
|---|---|---|
| NVIDIA | NVENC | 最稳,H.264/H.265 全支持 |
| AMD | AMF | 平衡模式是画质与性能的折中点 |
| Intel 核显 | QuickSync | 核显也能硬编,轻度 3A 够用 |
| 无硬件编码 | 软件编码 | 纯 CPU 编码,建议 720p |
网络侧记住三条:
- 🔌 主机端能插有线千兆就插有线
- 接收端固定 5GHz 并靠近路由
- 1080p 60 帧卡顿就先降分辨率,别硬拉码率
编码质量、音频延迟、UPnP 自动转发等完整参数在配置参考里。编码器定好,就该聊聊出问题怎么办。
卡住了?三步定位
- 现象归类:管理页打不开、配对成功却没画面、画面卡顿丢包,三种症状对应端口拦截、视频流未通、带宽不足三层原因,先分清再动手,别乱试。
- 日志定位:Web 页 Troubleshooting 标签能直接看到报错;也可以翻本地
sunshine.log,Windows 在 Sunshine 安装目录的config文件夹下,Linux/macOS 在~/.config/sunshine/。
这个日志页里红色标出的错误行,就是编码器故障时最先要看的地方。
- 配置回退:编码器报错就先更新显卡驱动再重启 Sunshine;端口不通就放行
47990(TCP,管理页)和47998(UDP,视频流);密码忘了就执行:
sunshine --creds <new-username> <new-password>执行后终端输出凭据已重置的提示,重启 Sunshine 再用新账户登录。
| 现象 | 原因 | 处置 |
|---|---|---|
| 管理页打不开 | 47990 被防火墙拦截 | 放行 Sunshine,开放 47990 |
| 配对成功但黑屏 | 47998 UDP 未通 | 放行视频端口,检查路由 |
| 卡顿丢包 | 带宽不足或信号弱 | 改有线、切 5GHz、降分辨率 |
| 提示编码器找不到 | 驱动过旧 | 更新显卡驱动,重启 Sunshine |
Linux 沙盒权限、KMS 抓取这类平台级问题,故障排查手册里都写得到位。
下一步:对比真实延迟
到这里,你已经有了一台随时能把 PC 投上大屏的串流主机。接下来建议打开 Moonlight 的性能浮层,跑一次 NVENC 和软件编码的实测帧率与延迟对比,用数据决定值不值得把码率再往上提。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考