☰
Sunshine 快速指南:6 步把游戏 PC 变成 Moonlight 串流主机
2026/10/2 1:37:18 网站建设 项目流程

Sunshine 快速指南:6 步把游戏 PC 变成 Moonlight 串流主机

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

把客厅电视接上 Moonlight,画面就从书房那台游戏 PC 过来了——这正是 Sunshine 做的事。它是一个自托管的游戏串流服务器,装进游戏机后,画面、声音和输入都能低延迟地送到客厅大屏、手机或平板。这篇指南带你走完从安装到第一次出画面的最短路径,全程只装一个软件、开一个浏览器。

按系统安装 Sunshine 并确认运行

动手前先花一分钟确认三件事:显卡(NVIDIA、AMD、Intel 的硬件编码都支持,都没有也能用 CPU 软件编码,只是画质帧率打折)、网络(主机和客户端在同一局域网,主机建议走有线)、内存 4GB 以上。端口方面,串流基础端口是47989,Web 管理页用47990,防火墙要放行这两个。

  • Windows:到最新版发布页下载Sunshine-Windows-AMD64-installer.msi,双击运行向导。可选项按需勾选、别全勾,防火墙弹窗选允许。
  • Ubuntu / Debian:下载匹配的.deb包后执行:
sudo apt install ./sunshine-ubuntu-24.04-amd64.deb # 包名替换成你下载的文件名
  • macOS:下载 DMG,把Sunshine.app拖进「应用程序」;或用 Homebrew:
brew tap LizardByte/homebrew && brew install sunshine # 官方标注实验性

⚠️ macOS 版是实验性支持,手柄暂不可用,先按官方入门文档确认限制。Arch、Alpine 等发行版走第三方包说明。

✅成功信号:Windows 系统托盘出现 Sunshine 图标;Linux 用下面的命令启动用户服务后,状态应显示active (running):

systemctl --user --now enable app-dev.lizardbyte.app.Sunshine # 开机自启并立即启动

这步没反应的话别急着重装——先systemctl --user status app-dev.lizardbyte.app.Sunshine看状态;想用 KMS 捕获时 AppImage 和 Flatpak 均不支持,优先用发行版专属 deb/rpm 包。

打开 Sunshine Web 管理页并创建账户

浏览器访问https://localhost:47990(在其他设备上,把localhost换成主机的局域网 IP)。浏览器提示"证书不受信任"——⚠️ 这是自签名证书的正常表现,点"继续访问"即可。

首次访问会让你设置用户名和密码。记牢它们,后面配对要用;忘了可以重置:

sunshine --creds 新用户名 新密码 # 忘记 Web 密码时重置凭据

✅成功信号:页面出现登录表单,登录后能进主界面。

打不开页面:多半是防火墙拦了 47990,放行后重试,同时确认服务在跑(回到上一步看状态)。

添加要串流的桌面和游戏应用

登录后进 Applications 页新建应用项。建一个名为 "Desktop" 的项就能串整个桌面;填游戏的可执行文件路径则只串那款游戏。保存后它会出现在应用列表里。

✅成功信号:列表里出现你刚建的应用卡片(如 Desktop)。

列表没刷新:应用列表只在 Moonlight 端重启客户端时才重新拉取,回到 Moonlight 里退出重进即可。

让 Moonlight 客户端找到这台主机

在打算串流的那台设备(电视、手机、平板)上打开 Moonlight。正常情况下它会自动发现局域网里的 Sunshine 主机。

发现不了:在 Moonlight 里手动添加主机,填入主机的局域网 IP;仍不行就检查防火墙是否放行了47989和47990,或给 Sunshine 加一条例外。

✅成功信号:Moonlight 的主机列表里出现了你这台 PC。

用 PIN 配对 Moonlight 设备并出画面

Moonlight 第一次连接会请求输入 PIN。此时回到 Web 页面确认已登录,打开顶栏的 PIN 输入框,填入 Moonlight 显示的 PIN,并给这台设备起个名字。看到成功提示后,回到 Moonlight 选择上一步添加的应用,点击串流。

PIN 一直失败:先确认 Web 页面处于登录状态再填 PIN,绝大多数情况卡在这里。手柄不响应或虚拟手柄报错,按排错文档对照平台检查驱动。

✅成功信号:客厅屏幕上出现桌面或游戏画面,声音也同步过来了——最难的都过去了。

处理卡帧、花屏和手柄不响应

出画面后,不同症状对不同的地方:

  • 卡帧、花屏:通常是带宽不足或信号衰减。把分辨率和码率各降一档换稳定帧率,或改有线、客户端走 5GHz WiFi;具体码率、分辨率参数在配置参数说明里逐项调。
  • 移动设备卡顿:手机、平板尽量用 5GHz 并靠近路由器,穿墙丢包会直接体现为卡顿。
  • 手柄或编码器检测不到:先更新显卡驱动到最新版;Windows 还需确认虚拟手柄驱动正常,见官方入门文档。

需要逐条看问题时,Web 页面的 Troubleshooting 标签页能翻看每条警告和错误,Linux 与 macOS 的日志目录在~/.config/sunshine/。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询