Sunshine：免费把 PC 游戏串流到电视的完整指南-迪斯科星球

Sunshine：免费把 PC 游戏串流到电视的完整指南

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

Sunshine 是一款免费开源的游戏串流服务器，负责在你自己的电脑上抓屏、硬件编码、回传手柄输入，播放交给 Moonlight 客户端完成。读完这篇，你能从零装好它、完成首次配对，并把桌面串到电视上。它和云游戏的核心区别：游戏数据全程不出你的局域网。

为什么选 Sunshine 做 Moonlight 主机

三种"玩别人屏幕"的方案并排放一起看：

维度	云游戏订阅服务	厂商闭源串流	Sunshine（开源自托管）
游戏运行位置	厂商机房	你的电脑	你的电脑
成本	订阅费	通常免费	0 元
数据去向	交给第三方	厂商生态	仅在你的局域网内
客户端	平台有限	自家生态	Moonlight：Windows / macOS / Linux / Android / iOS / tvOS
编码方式	服务端统一	厂商自研	复用 NVENC、QuickSync、VAAPI 等自家显卡硬件编码，也可软件编码

对新手意味着：不花订阅费、不绑厂商平台，延迟和画质自己说了算。

动手前核对：系统、硬件、网络

系统：Windows 11+、Ubuntu 22.04+ / Debian 13+ / Fedora 43+、macOS 14.2+（不够只能换主机系统；macOS 为实验性且暂不支持手柄）
硬件：Ryzen 3 或 i3 以上、内存 4GB、显卡支持硬件编码（不够会怎样：退回 CPU 软件编码，延迟升高）
网络：主机和客户端都走 5GHz WiFi（不够会怎样：4K 必卡，建议换 CAT5e 以上网线）

安装 Sunshine 并完成 Moonlight 首次 PIN 配对

按你的系统选一个代码块执行：

# Windows：从 Releases 发布页下载 Sunshine-Windows-AMD64-installer.msi，双击安装 # 安装后 Sunshine 默认以系统服务方式后台运行

# Linux：Flatpak 安装（发行版有专属包时优先用专属包） flatpak install --user flathub dev.lizardbyte.app.Sunshine flatpak run --command=additional-install.sh dev.lizardbyte.app.Sunshine # Linux：启动用户服务并设为登录自启 systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

# macOS：Homebrew 安装（官方标记为实验性，手柄暂不支持） brew tap LizardByte/homebrew brew install sunshine

# Docker：官方明确注明不推荐大多数用户使用 docker pull lizardbyte/sunshine

首次连接分 6 步：

浏览器打开https://localhost:47990。浏览器警告"不安全网站"是自签名证书所致，点继续即可
首次进入按页面提示创建 Web 登录用户名和密码，记牢，这是管理界面的钥匙
在目标设备（手机、平板、电视）安装 Moonlight 客户端
在 Moonlight 里添加这台主机
客户端请求 PIN 时，打开管理界面导航栏的 PIN 页，填入该码并给设备起个名字
在 Moonlight 里点选一个应用开始串流

怎么确认成功了：目标屏幕 5 秒内出现主机画面；按键和手柄都有响应；Moonlight 性能叠加层里码率稳定不掉零。三条齐了就算通了。

跑通之后：三个高频任务

把桌面串到大屏

目标：在 Moonlight 里一键看到主机桌面，不启动任何程序。

步骤：

Moonlight 应用列表选内置的Desktop应用，它不需要任何配置，直接开流
想隐藏或显示光标，按Ctrl+Alt+Shift+N

注意：所有快捷键都以Ctrl+Alt+Shift开头，F1到F12切换串流到不同显示器。

给每个游戏开专属入口

目标：以后在 Moonlight 里一点直达游戏，不用回桌面找图标。

步骤：

管理界面进"应用"（Applications）页，点Add New
填应用名和程序路径cmd
填工作目录cwd，命令支持环境变量，$(HOME)会自动替换成家目录
保存后刷新 Moonlight，即可看到新入口

注意：被串流的应用退出时串流自动结束；启动新应用会终止上一个正在跑的应用。

出门在外连回主机

目标：不在家时也能连上主机开玩。

步骤：

在 Web 配置页搜索upnp，把默认disabled改成enabled，让路由器自动映射串流端口（基础端口47989，管理页走47990）
在 Moonlight 里手动添加主机的公网 IP

注意：远程串流对上行带宽更敏感，先把分辨率和码率调低再试。

出了问题：症状对照表与日志定位

症状	原因	解法
Moonlight 发现不了主机	不同网段或防火墙拦截	确认同一局域网并放行相关端口；在 Moonlight 手动填 IP 添加
Web 界面打不开	用了`http`或端口被占	用`https://localhost:47990`访问；检查防火墙规则
日志报编码器错误	显卡驱动或编码支持缺失	更新显卡驱动，对照 README 的功能兼容表核对 GPU 与编码 API
画面卡顿、掉帧	带宽不足或码率过高	先降分辨率/码率再谈画质，参考性能调优文档
键盘鼠标手柄没反应	输入设备权限问题	Linux 执行`sudo usermod -aG input $USER`后重启；Windows 安装 Virtual HID Driver 后重启

日志定位：

Web 入口：网页端Logs标签页直接查看运行日志，Troubleshooting页逐条列出警告与错误

本地文件：Linux 默认~/.config/sunshine/sunshine.log，Windows 在%ProgramFiles%\Sunshine\config\sunshine.log，位置可用配置项log_path修改。想查可用启动参数，终端运行sunshine --help

确认串流链路走通

在主机上按对应系统命令装好 Sunshine
访问https://localhost:47990并创建 Web 登录账号
目标设备装 Moonlight 并完成 PIN 配对
用内置 Desktop 应用串流一次桌面，确认画面与输入正常
在 Applications 页添加至少一个自定义游戏入口
用上面的排障表处理过一次卡顿或输入问题

企业官网建设流程全解析