5 步把 PC 游戏投到客厅电视：Sunshine 免费自建游戏串流服务器完整指南-创锋一号

5 步把 PC 游戏投到客厅电视：Sunshine 免费自建游戏串流服务器完整指南

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

周末窝在沙发里，却想把书房主机上的 3A 大作投到客厅电视上继续推图。这种"人在客厅、游戏在书房"的需求，靠一款免费开源的自建游戏串流服务器就能解决——Sunshine 装在有游戏的电脑上，画面经局域网实时推给手机、平板或电视端设备，全程不花一分钱，也不用注册任何云服务。

Sunshine 是 LizardByte 开源项目，定位是 Moonlight 客户端的专属服务端。主机上的 Sunshine 负责采集画面、用显卡硬件编码后推送，客户端再把键鼠与手柄输入回传过来。类比一下，它就是把一场"实时视频直播"和"双向遥控器"合并到一条局域网链路里。

角色	组件	职责
主机端	Sunshine	采集屏幕与音频、硬件编码、推流
客户端	Moonlight	解码播放、回传键鼠与手柄输入
管理入口	Web 界面（`47990`端口）	配置应用、编码器与网络
编码引擎	NVENC / AMF / VA-API 等	按显卡品牌加速画面压缩

动手前 5 分钟自检

安装前先花 5 分钟确认环境，避免装到一半卡在依赖上。

检查项	最低要求	一句话说明
操作系统	Windows 10/11、主流 Linux 发行版、macOS（实验性）	三端都有官方安装方式
硬件	带硬件编码器的独立显卡	N 卡 / A 卡 / Intel 核显均可，软编可跑但吃 CPU
网络	局域网；外网串流建议网线	路由器支持 UPnP 时外网配置最省事
依赖工具	Linux 源码构建需`git`与基础编译工具链	Windows 与 macOS 无需关心
账号注册	无需注册任何服务	管理凭据只在首次打开 Web 界面时本地创建

确认无误就开始动手。

分平台安装：Windows、Linux、macOS

Windows 版下载装好

在项目的 Releases 发布页下载最新版.msi安装程序（按架构选 AMD64 或 ARM64）；
双击运行，按向导一路确认——Sunshine 会自动注册为系统服务并常驻托盘，无需手动启动；
留意安装选项，勾选完整的虚拟输入驱动项以获得完整的手柄与鼠标支持。

Linux 用一条构建脚本搞定

# 克隆 Sunshine 源码仓库 git clone https://gitcode.com/GitHub_Trending/su/Sunshine # 进入目录并运行官方构建脚本，自动装依赖并完成安装 cd Sunshine && ./scripts/linux_build.sh

构建脚本会自动处理各发行版的依赖清单，首次执行耗时较长属正常现象。完成后用下面这条命令开启开机自启：

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

macOS 一行 brew 命令

# 通过 Homebrew 安装 Sunshine brew install sunshine

首次启动会弹出系统权限请求，授予屏幕录制与麦克风访问即可正常采集画面。

三个平台装完后，打开浏览器访问https://localhost:47990，看到欢迎页就说明服务已就绪。

首次配置与跑通串流

创建 Web 管理账号

首次访问https://localhost:47990会看到欢迎页：填写 Username、Password 并确认密码，点击 Login。这组凭据是日后管理串流服务器的唯一入口，建议记到密码管理器里；浏览器提示"不安全"是因为界面使用自签证书，属正常现象。

UPnP 一键打通外网串流

进入 Configuration 页面 → 顶部搜索框输入upnp→ 在 Network 选项卡把upnp设为enabled→ 点击底部 Save。开启后 Sunshine 会通知路由器自动映射所需端口。若路由器不支持 UPnP，则手动转发 UDP47998–48000即可。

添加游戏与应用

进入 Applications 选项卡 → 点击 "Add New" → 填写应用名称与可执行文件完整路径 → 点 Save。页面默认自带Desktop与Steam Big Picture两个预设，想"把整个桌面搬过去"直接选它即可。注意：应用列表要重启 Sunshine 后客户端才会刷新，改完记得重启一次。

Moonlight 配对与首次跑通

客户端可在 Web 界面 Featured Apps 选项卡获取，覆盖桌面、安卓与嵌入式 Linux 各平台。打开 Moonlight 后它会自动发现局域网内的 Sunshine 主机；首次连接时到 Web 界面顶部导航的PIN选项卡查看 4 位配对码，输入后给设备起个名字，客户端随即列出可串流的应用。

点选任意应用开始串流，画面出现且按键有响应即代表链路跑通。一次配对长期有效，之后打开客户端就能直接进游戏。

踩坑速查

问题现象	可能原因	快速解决
客户端搜不到主机	两台设备不在同一网段，或防火墙拦截	确认同网段，放行`47990`与 UDP`47998`–`48000`
画面卡顿或发虚	码率超过带宽上限，或无线信号弱	换有线；降码率/分辨率再逐步上调
串流黑屏或起不来	显卡驱动与编码器不匹配	更新驱动，在 Configuration 页更换编码方案
键鼠或手柄无响应	Linux 用户未入`input`组；Windows 缺虚拟输入驱动	加入`input`组注销重登，或安装 Virtual HID 驱动后重启

Web 界面的Troubleshooting选项卡可直接查看完整日志与诊断提示，配合 LizardByte 社区（Discord）能快速定位疑难问题。

进阶与资源

官方配置项逐项说明见 docs/configuration.md，每个开关的作用与默认值都有对照表；
安装与各平台注意事项以 docs/getting_started.md 为准，编码器选择可按显卡品牌在 Configuration 页搜索encoder定位；
Linux 各发行版的依赖清单可参考 scripts/linux_build.sh，核心配置逻辑在源码 src/config.cpp 中实现；
遇到疑难杂症，LizardByte 社区（Discord）是响应最快的渠道，带上 Troubleshooting 页的日志截图提问效率最高。

整套流程走完后，主机的游戏随时能投到家里任意一块屏幕上，剩下的就是挑个周末开玩。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析