Sunshine 游戏串流：10 分钟安装、首次配对与串流上电视完整指南
Sunshine 游戏串流10 分钟安装、首次配对与串流上电视完整指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine3A 大作正跑在书房 PC 上你想在卧室电视里玩它。Sunshine 是一款免费开源的自托管游戏串流服务器配合 Moonlight 客户端把主机画面实时推到电视、手机或平板。这篇教程全程约 10 分钟读完并完成操作后你将得到三个结果在主机上装好 Sunshine完成 Sunshine 与 Moonlight 的首次配对把桌面成功串流到大屏一分钟搞懂分工Sunshine 到底干什么Sunshine 是串流链路的服务端它在主机上抓取屏幕调用显卡硬件编码NVENC、QuickSync、AMF、VAAPI 都支持把画面压成视频流再把客户端的键盘、鼠标、手柄操作回传给主机。播放端全部交给 Moonlight 客户端。和另外两种在别人屏幕上玩游戏的方式比云游戏订阅游戏跑在厂商机房付订阅费厂商闭源串流绑定厂商自家生态Sunshine 自托管免费开源数据不出家门分工搞清之后先花一分钟核对硬件能避开绝大多数安装问题。动手前自测三个问题核对环境第一问系统够不够新Windows 11、Ubuntu 22.04 / Debian 13 / Fedora 43、macOS 14.2、FreeBSD 15.1。⚠️ macOS 版目前是实验性的且暂不支持手柄要用手柄请先选 Windows 或 Linux 主机。第二问显卡能不能硬件编码NVIDIA 显卡、Intel 核显、AMD VCE 1.0 任一即达标。三者都没有时退回软件编码也能跑只是 CPU 会更吃力。第三问网络是否达标主机和客户端都在 5GHz WiFi 是推荐配置想上 4K双方都走 CAT5e 及以上网线。不达标就先把分辨率和码率降下来。三问都过了马上把它装上。安装按系统各一行命令Windows从发布页下载Sunshine-Windows-AMD64-installer.msi双击安装装完默认以服务运行。Linux发行版有.deb/.rpm包就优先用它没有再用 Flatpakflatpak install --user flathub dev.lizardbyte.app.Sunshine flatpak run --commandadditional-install.sh dev.lizardbyte.app.SunshinemacOS.dmg拖进应用程序即可也可以用 Homebrewbrew tap LizardByte/homebrew brew install sunshine装完做两件事启动服务Linux 用户服务命令如下加--now enable可让开机自启。systemctl --user start app-dev.lizardbyte.app.Sunshine打开 Web 管理页浏览器访问https://localhost:47990证书警告是自签名证书的正常表现点继续访问即可。看到欢迎页说明服务活着。界面能打开了剩下唯一的事就是把 Moonlight 接进来。首次配对四步接上 Moonlight登录https://localhost:47990首次进入创建管理用户名和密码务必记牢——这是日后改配置、查 PIN 的钥匙。在目标设备电视/平板/手机/电脑装好 Moonlight 客户端并添加这台主机客户端下载入口就在欢迎页的 Featured Apps 页。Moonlight 弹出 PIN 输入框时到 Web 导航栏的PIN页把客户端显示的码填进去回车再给设备起个名字。在 Moonlight 里选一个内置的 Desktop 应用开始串流。成功判定目标屏幕 5 秒内出现主机画面按键和手柄都有响应。跑通之后顺手做三个小任务立刻把 Sunshine 用出价值。跑通之后还能顺手做这三件事首次成功把整块桌面串到大屏不用配置任何东西——Sunshine 自带Desktop应用整块桌面直接串流。在 Moonlight 里选中它开始大屏出现主机桌面后按CtrlAltShiftN可隐藏或显示鼠标光标。体验提示串流中想切到另一块显示器按CtrlAltShiftF1到F12被串流的应用退出时串流会自动结束。自定义入口给每个游戏一点直达进 Web 的Applications页点Add New填应用名、程序路径cmd与工作目录cwd保存后 Moonlight 刷新即可看到。命令支持环境变量$(HOME)会自动替换成家目录Flatpak 用户记得在命令前加flatpak-spawn --host。体验提示跑 3A 大作优先用 Steam 入口启动即进大屏模式手柄会被模拟成主机上的游戏手柄输入几乎无感延迟。出门在外连回家在 Web 配置搜索栏输入upnp把默认disabled改成enabled路由器就会自动转发串流端口基础端口47989Web 管理走47990。然后在 Moonlight 里手动添加这台主机的公网 IP。体验提示远程串流对上行带宽很敏感先把分辨率和码率调低再试。Web 管理页默认只允许局域网访问origin_web_ui_allowed默认lan想从外网管理还需路由器端口转发并务必配强密码。跑起来之后就只剩出问题怎么办这一件事了。出问题怎么办症状 → 解法速查症状常见原因解法Moonlight 发现不了主机不同网段或防火墙拦截确认同一局域网并放行端口或手动填 IP 添加Web 页面打不开用了 http 或端口被占用https://localhost:47990访问检查防火墙规则日志报编码器错误显卡驱动旧、缺少编码支持更新显卡驱动对照 README 的 GPU 兼容表核对画面卡顿、掉帧带宽不足或码率过高先降分辨率和码率再谈画质键盘鼠标手柄没反应输入权限或驱动缺失Linux 把用户加入input组后重登Windows 装 Virtual HID Driver 后重启忘记 Web 管理密码凭据丢失终端执行sunshine --creds 新用户名 新密码重置日志定位有三条路网页端Logs标签页直接看运行日志Troubleshooting页逐条列出警告与错误编码器、GPU、网络情况一眼可见。本地文件Linux 在~/.config/sunshine/sunshine.logWindows 在%LocalAppData%\Sunshine\sunshine.log路径可用log_path修改。命令行sunshine --help列出全部启动参数配合上面两条日志路径即可定位问题。完成那台 3A 现在正躺在电视里书房的 PC 里那台 3A现在正跑在卧室的电视上——10 分钟、0 元、画面一步不出家门。下次出门前记得主机开机、Moonlight 点一下客厅就是你的游戏房。按对应系统安装 Sunshine启动服务Linux 用systemctl --user start app-dev.lizardbyte.app.Sunshine访问https://localhost:47990并记下创建的管理用户名密码在 Moonlight 中添加主机并完成 PIN 配对用内置 Desktop 应用串流一次桌面确认画面与输入在 Applications 页添加至少一个自定义游戏入口按症状对照表处理一次卡顿或输入问题进阶把upnp改为enabled解锁远程串流延伸阅读仓库内文档docs/getting_started.md各发行版安装方式与首次启动的完整细节docs/configuration.md每个配置项的含义、默认值与可选值改配置前先查这里docs/performance_tuning.md码率、分辨率、编码器选择专治卡顿docs/troubleshooting.md按平台细分的疑难问题手册docs/building.md想从源码编译 Sunshine 的开发者入口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考