企业官网建设流程全解析

Sunshine游戏串流教程：从安装配对到电视开播

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

周五晚上躺在沙发里，平板一拿，就想玩 PC 里那款 3A 大作——Sunshine 游戏串流就是干这个的：主机端负责抓屏、编码、回传输入，Moonlight 客户端负责在电视上解码播放。零订阅费，装完到出画面大约 10 分钟。

串流链路分工：主机编码，客户端播放

游戏始终跑在你自己的显卡上，画面不出家门。主机端的 Sunshine 干三件事：抓取屏幕、调用显卡硬件编码器（NVENC、QuickSync、VAAPI 分别是各家显卡的硬件编码器）把画面压成视频流、把客户端的键盘鼠标手柄操作模拟回 PC；Moonlight 客户端只做一件事——收流、解码、上屏。

分工清楚了，动手前先用 30 秒核对一下条件，能避开大部分安装坑。

装之前 30 秒确认三样东西

• 系统版本：Windows 11+、Ubuntu 22.04+ / Debian 13+ / Fedora 43+、macOS 14.2+、FreeBSD 15.1+。⚠️ macOS 版目前是实验性的，且暂不支持手柄，要用手柄就先选 Windows 或 Linux 主机。
• 最低硬件：AMD Ryzen 3 或 Intel Core i3 级别 CPU、4GB 内存起，显卡带硬件编码即可；三样编码都没有时，吃 CPU 的软件编码也能跑。
• 网络：主机和客户端都能走 5GHz（802.11ac）WiFi 就够用；想上 4K 建议双方都插 CAT5e 及以上网线，4K/HDR 的硬件门槛见 README.md 的硬件表，不展开。

确认完，按系统挑最短路径把软件装上去。

各平台最短安装路径

• Windows：从发布页下载Sunshine-Windows-AMD64-installer.msi，双击安装，装完默认以后台服务运行。
• Linux：发行版专属包优先（Ubuntu/Debian 用.deb，Fedora 用.rpm或 Copr 源），没有包再用 Flatpak；Docker 镜像官方注明不推荐大多数用户使用。

# 没有发行版包时用 Flatpak flatpak install --user flathub dev.lizardbyte.app.Sunshine # 启动用户级服务；想开机自启改为 --now enable systemctl --user start app-dev.lizardbyte.app.Sunshine

• macOS：下载对应架构的.dmg，把Sunshine.app拖进"应用程序"即可，或走 Homebrew：

# macOS 用 Homebrew 安装 brew tap LizardByte/homebrew && brew install sunshine

装完在浏览器打开https://localhost:47990。浏览器提示"此网站不安全"是自签名证书的正常表现，点"继续访问"，看到欢迎页就说明服务活着。

页面通了，剩下唯一的事就是把客户端接进来。

首次把 Moonlight 接进来（PIN 配对四步）

1. 登录https://localhost:47990。首次进入会要求创建管理界面的用户名和密码，务必记牢——改配置、查日志、看 PIN 都要用它。
2. 在目标设备（手机、平板、电视、电脑）上装好 Moonlight 客户端，添加这台主机。
3. 客户端弹出 PIN 输入框时，回到网页导航栏的PIN页，把屏幕上显示的码填进去，回车，再给设备起个名字。✅ 看到成功提示即配对完成。
4. 在客户端里点选任意应用，开始串流。

成功三标志：目标屏幕 5 秒内出主机画面、按键有响应、手柄有响应，三条齐了就算跑通。

串通了别急着收工，下面三件小事立刻能出价值。

跑通后立刻能做的 3 件事

电视上看整块桌面

1. 什么都不配也行——自带Desktop应用（整块桌面原样串流）和Steam入口（启动即进大屏游戏模式）；
2. 在客户端列表里选Desktop，点开始；
3. 电视上出现桌面后，按Ctrl+Alt+Shift+N可隐藏或显示鼠标光标（所有快捷键都以Ctrl+Alt+Shift开头）。

体验提示：跑 3A 大作建议走 Steam 入口进大屏模式，手柄会被模拟成主机上配置的游戏手柄类型，输入几乎无感延迟。

给任意游戏开直达入口

1. Web 管理界面进Applications页，点Add New；
2. 填应用名、启动命令（cmd）和工作目录（cwd）；命令支持环境变量，$(HOME)会自动替换成家目录，Flatpak 用户记得在命令前加flatpak-spawn --host；
3. 保存，客户端刷新即可看到新入口。

体验提示：串流中按Ctrl+Alt+Shift+F1到F12能切到不同显示器继续玩；被串流的应用退出时，串流自动结束。

出门在外也能连回家

1. Web 配置页搜索栏输入upnp（UPnP 是让路由器自动开启端口转发的协议），把默认disabled改成enabled，让路由器自动映射串流端口（基础端口默认47989，网页管理走47990）；
2. 在客户端里手动添加主机的公网 IP；
3. 远程串流对上行带宽很敏感，先把分辨率和码率调低再试。

体验提示：Web 管理页访问范围由origin_web_ui_allowed控制，默认lan表示仅局域网设备可打开；想从外网管理要另行做路由器端口转发，并且务必配强密码、保持软件更新。

跑起来之后，剩下的事只有一个：出问题怎么定位。

卡顿掉帧排查表与日志定位

日志三条路：

• 网页端：Logs标签页直接看运行日志，Troubleshooting页逐条列出警告与错误，编码器、GPU、网络一眼可见；
• 本地文件：Linux 在~/.config/sunshine/sunshine.log，Windows 在%LocalAppData%\Sunshine\sunshine.log，路径可用log_path改，保留最近 5 份；
• 查参数：终端跑sunshine --help，全部启动参数一目了然。

完成清单：从零串通逐项打勾

• 按对应系统装好 Sunshine
• 启动服务（Linux 用systemctl --user start app-dev.lizardbyte.app.Sunshine）
• 访问https://localhost:47990，记下首次创建的管理用户名密码
• 客户端添加主机并完成 PIN 配对
• 用内置 Desktop 应用串一次桌面，确认画面与输入正常
• 在 Applications 页加至少一个自定义游戏入口
• 照症状对照表处理一次卡顿或输入问题
• （进阶）把upnp改为enabled，解锁出门串流

延伸阅读：

• docs/getting_started.md：各发行版安装方式与首次启动细节
• docs/configuration.md：每个配置项的含义、默认值与可选值
• docs/performance_tuning.md：码率、分辨率、编码器选择，专治卡顿
• docs/troubleshooting.md：按平台细分的疑难问题手册
• docs/building.md：想从源码编译 Sunshine 的开发者入口

下次出门前只需两个动作：把主机开机，Moonlight 一点——电视里那款 3A 大作一直亮着等你，账单上的订阅费还是 0 元。

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