Sunshine 入门实战：10分钟把PC游戏投到大屏-平芜编程栈

Sunshine 入门实战：10分钟把PC游戏投到大屏

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

电视大屏摆在那，游戏却全装在 PC 上。Sunshine 就是解决这件事的自托管游戏串流服务器：装在你的游戏 PC 上，配一个 Moonlight 客户端，就能通过局域网把整个桌面或任意一款游戏实时投到电视、平板和手机上。视频全程由显卡硬件编码器压缩，数据不出局域网，没有月费，画质上限由你自己的硬件决定。

第一步：按你的系统装对安装包

不需要从源码编译，去官方发布页拿对应平台的安装包就行。

Windows：选 AMD64 的 MSI 双击安装，向导过程中会列出若干可选项，逐个看清楚，只勾你实际用到的功能。装好后 Sunshine 以系统服务常驻后台，任务栏托盘有图标，默认随系统启动。

Linux：Debian/Ubuntu 装 deb 包，终端执行sudo dpkg -i ./sunshine-*.deb，或者直接双击文件安装；Fedora、OpenSUSE 用 rpm。你的发行版没有对应原生包时，Flatpak 是通用兜底方案。

macOS：下载 DMG，把Sunshine.app拖进应用程序文件夹，或者 Homebrew 一行brew install sunshine。官方标注这个版本是实验性质，手柄暂时不可用，先有预期。

第二步：启动服务，登进控制面板

Windows 和 macOS 装完即自动运行，这步主要是 Linux 用户的事。终端执行：

systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

这条命令同时完成"现在启动"和"开机自启"两件事，一次到位。

接着浏览器访问https://localhost:47990。首次访问会停在创建账户页，你填的用户名和密码就是 Web 控制面板的登录凭证——之后系统不会再显示它们，建议当场记下来。地址栏提示"不安全"是因为用了自签名证书，直接点继续访问即可。

顺手做一件事：点导航栏的 Theme 切换成深色主题，夜间长时间串流对眼睛友好很多。

另外记一下配置目录的位置：Linux/macOS 在~/.config/sunshine，Windows 在%ProgramFiles%\Sunshine\config。后面查日志会用到。

第三步：把电视或手机第一次接进 Sunshine

在电视、手机或平板上装一个 Moonlight 客户端（应用名就叫 Moonlight）。拿不准自己该下哪个版本时，先看 Sunshine 面板的 Featured Apps 标签页——那里汇集了 PC、Android、嵌入式各端客户端的链接，对照确认装对了。

配对流程本身很快：

客户端一般会自动发现局域网里的 Sunshine，点添加即可；发现不到就手动填主机 IP。
客户端弹出 6 位 PIN 时，回到 Sunshine 网页，点导航栏的 PIN，输入同一串数字，顺手给设备起个名字，确认。
配对完成后，客户端的应用列表里会出现 Sunshine 自带的 Desktop 条目——选中它，整个桌面就投过来了。

串流过程中所有快捷键共享Ctrl+Alt+Shift前缀，其中F1到F12用于切换串流目标显示器，用得上。

🎮 把你常玩的游戏加进串流列表

Applications 标签页管理着 Moonlight 客户端上看到的全部条目，每一条记录对应一个串流入口，配好一次以后随时可点。

桌面串流：预置的 Desktop 条目不需要任何命令，选中即投整个桌面，远程办公够用。万一手滑删掉，新建一个名为 Desktop、图标用desktop.png的应用就能恢复。
Steam 大屏：新建应用，命令填steam://open/bigpicture（Linux 下写成setsid steam steam://open/bigpicture），类型选 Detached。原因是 Steam 主进程会自更新并退出原进程，不勾 Detached 的话串流会立刻断。
自定义游戏：填启动命令（可执行文件加参数）、工作目录、显示名称和图标。命令支持环境变量替换，$(HOME)会替换成用户主目录。Steam、Epic 等场景仓库里都有现成写法，参考应用配置示例。

选对显卡对应的硬件编码器

编码器跟着显卡厂商走，选错了延迟和画质都上不去：

NVIDIA：用 NVENC，延迟与画质最均衡，多数人的默认选择。
AMD：Windows 上选 AMF，Linux 上选 VAAPI，平衡模式下表现稳定。
Intel：核显用 QuickSync，速度足够应付。
老卡或无硬编能力：退回软件编码，吃 CPU，建议先把分辨率降下来再用。

网络调优按这个顺序来

先看最低门槛：主机和客户端的官方最低要求都是 5GHz 802.11ac。典型家庭拓扑里，串流主机尽量走有线，无线客户端也尽量上 5GHz。要强调的是，串流挑的不是峰值带宽而是稳定性——延迟抖动小、丢包接近零，比跑分高更重要。

效果不理想时别乱动参数，按顺序来：

先打开 Troubleshooting 页逐条读警告，编码器报错通常意味着该更新显卡驱动了。
卡顿、掉帧：到 Configuration 页用顶部搜索栏直接搜bitrate，把码率和分辨率各降一档。
延迟偏高：NVIDIA 卡到驱动里开 Fast Sync，AMD 卡开 Enhanced Sync，各省出一帧左右。
频繁掉线：优先改有线；无线环境先测信号强度，必要时在路由器把 QoS 向串流流量倾斜。

全部配置项的说明见配置项文档。

最常翻车的几个位置先排一遍

排查材料集中在两处：Web 面板的 Troubleshooting 标签页（日志可在线逐条展开），以及配置目录下的sunshine.log文件。

忘了 Web 面板密码时，终端执行sunshine --creds 新用户名新密码即可重置。

高频现象和对应处理：

打不开 47990 网页：大概率是防火墙拦截，放行 47990 端口或添加例外规则。
Moonlight 配对不成：查 PIN 是否没及时输入，在网页 PIN 入口填入 6 位数字并给设备命名。
客户端手柄无响应：Windows 装虚拟手柄驱动，Troubleshooting 页可以直接安装 ViGEmBus；Linux 则把运行 Sunshine 的用户加入input组。
串流中频繁掉帧：网络稳定性问题，改有线，或降分辨率与码率。
编码器报错：显卡驱动过旧，更新驱动后重启 Sunshine。

更细的分类问题按顺序查入门指南和故障排查专题，基本都能对上号。