免费搭好Sunshine一台电脑、一块电视的本地游戏串流完整方案【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是免费开源的自托管游戏串流服务器专为 Moonlight 客户端提供主机能力游戏画面经硬件编码变成视频流送到电视或手机手柄输入原路传回。从零到第一帧画面大约 10 分钟全程 0 元数据不出家门。先分清串流和云游戏差在哪游戏跑在你显卡上Sunshine 只负责搬运。Sunshine 干三件事抓屏、把画面实时编码成视频流、接收并模拟客户端发来的键鼠和手柄输入。它自己不放画面播放交给 Moonlight 客户端。和另外两类玩屏幕的方案摆在一起差异很清楚维度云游戏订阅硬件厂商闭源串流Sunshine 开源自托管游戏在哪跑机房服务器你的设备你的电脑每月花费订阅费通常免费0 元源码开放数据走哪交给第三方厂商生态只在你自己的网络里客户端覆盖面有限自家生态MoonlightWindows / macOS / Linux / Android / iOS / tvOS 等编码靠什么服务端统一厂商自研复用 NVENC、AMF、QuickSync、VAAPI 等显卡硬编也可软编手柄模拟视平台而定自家协议可模拟 Xbox、PlayStation、Switch Pro 等手柄结论对新手很直白不交订阅费、不绑平台延迟和画质自己说了算。动手前 30 秒照单核对你的主机配置不够早知道比装完再查省事。系统版本Windows 11、Ubuntu 22.04 / Debian 13 / Fedora 43、macOS 14.2、FreeBSD 15.1。macOS 版目前是实验性的暂不支持手柄想玩手柄先用 Windows 或 Linux 主机。硬件底线CPU 为 Ryzen 3 或 i3 及以上内存 4GB显卡支持硬件编码之一NVIDIA NVENC 卡、Intel VAAPI 核显、AMD VCE 1.0三者都没有也能用 CPU 软件编码跑稍吃资源。网络主机和客户端都在 5GHz WiFi802.11ac下是推荐配置要 4K 串流两端都建议走 CAT5e 及以上网线。4K / HDR 进阶线4K 需要 VCE 3.1AMD、HD 510Intel、GTX 1080 / RTX 2000 系及以上NVIDIA加 Ryzen 5 / i5 级 CPUHDR 另需显卡门槛且主机系统要先开启 HDR。安装加首次配对5 步拿到第一帧画面命令按系统挑配对一次约 10 分钟。安装代码块只留一条Linux Flatpak 为例其余发行版见 docs/getting_started.mdflatpak install --user flathub dev.lizardbyte.app.Sunshine # 装完或更新后必须跑一次同步 udev 规则 flatpak run --commandadditional-install.sh dev.lizardbyte.app.SunshineWindows 从发布页下载Sunshine-Windows-AMD64-installer.msi双击安装装完默认以服务运行macOS 用brew tap LizardByte/homebrew brew install sunshine官方提醒 Docker 镜像不推荐大多数用户使用。然后是首次连接共 5 步启动 SunshineLinux 用systemctl --user start app-dev.lizardbyte.app.Sunshine拉起用户服务想开机自启把命令换成--user --now enable前缀形式。浏览器访问https://localhost:47990打开 Web 管理界面。页面会报不安全——自签名证书的正常表现点继续即可。按提示创建 Web 登录用户名和密码这是管理界面的唯一钥匙记牢。在目标设备装 Moonlight 客户端并添加这台主机客户端弹出 PIN 请求时回到网页导航栏PIN页填入该码、给设备起个名字看到成功提示即配对完成。在 Moonlight 里点选一个应用开始串流。怎么算成功了目标屏幕 5 秒内出现主机画面按键和手柄有响应Moonlight 性能叠加层里码率稳定不掉零。三条齐了链路就通了。场景一把桌面直接搬上电视零配置Moonlight 里一点就开。什么都不用配——Sunshine 自带Desktop应用直接串整块桌面不启动任何程序和Steam入口启动后进大屏游戏模式在 Moonlight 应用列表选Desktop点开始电视/平板出现主机桌面按CtrlAltShiftN可隐藏或显示光标所有快捷键都以CtrlAltShift开头。验收标准桌面完整上屏鼠标移动流畅无拖影CtrlAltShiftN按下去光标确实消失。体验提示跑 3A 大作优先走 Steam 入口进大屏模式此时手柄会被模拟成主机上配置的那种游戏手柄输入几乎无感延迟。场景二给游戏开专属入口以后不用翻桌面找图标Moonlight 里一点直达。Web 管理界面进Applications页点Add New填应用名、程序路径cmd和工作目录cwd比如浏览器或某个游戏的启动命令保存后回到 Moonlight应用列表里就能看到新入口。验收标准新入口出现在 Moonlight 列表点开后对应程序在主机的正确工作目录下启动并上屏。体验提示命令里支持环境变量$(HOME)会自动替换成家目录串流中按CtrlAltShiftF1到F12可切换显示器被串流的应用退出时串流自动结束——所以像steam这类常驻程序要用detached方式跑否则启动即掉线。场景三出门在外连回主机一条upnp配置路由器替你开门。Web 配置页搜索upnpUPnP 是让路由器自动开转发的协议把默认disabled改成enabled让路由器自动映射串流端口——Sunshine 基础端口默认47989网页管理走47990在 Moonlight 里手动添加这台主机的公网 IP先压低分辨率和码率再试远程串流对上行带宽更敏感。验收标准手机切到 4G/5G 网络用公网 IP 能配上对并出画面码率低于家网但仍稳定。体验提示Web 管理页的访问范围由origin_web_ui_allowed控制默认lan表示只有局域网设备能打开想从外网管理需另行做端口转发并配强密码、保持软件更新。出问题时6 种高频症状对照表照症状开药先查表再动手。症状常见原因解法Moonlight 发现不了主机不同网段或防火墙拦截确认同一局域网并放行相关端口在 Moonlight 里手动填 IP 添加Web 界面打不开用了http或端口被占用https://localhost:47990访问按文档排查防火墙规则日志报编码器错误显卡驱动或编码支持缺失更新显卡驱动对照 README.md 的功能兼容表核对 GPU 与编码 API画面卡顿、掉帧带宽不足、码率过高或网络路径不稳先降分辨率/码率再谈画质按 性能调优 逐项排查键鼠手柄没反应输入设备权限问题Linux 把用户加入input组后重新登录Windows 安装 Virtual HID Driver 并重启忘记 Web 登录密码凭据丢失终端执行sunshine --creds 新用户名 新密码重置日志定位有三条路网页端Logs标签直接看运行日志Troubleshooting页逐条列出警告与错误编码器、GPU、网络哪环出问题一眼可见本地日志文件在 Linux 的~/.config/sunshine/sunshine.log、Windows 的%ProgramFiles%\Sunshine\config\sunshine.log位置可用配置项log_path改想查全部启动参数终端跑sunshine --help。收工清单今晚就把电视点亮书房那台 PC 的 3A 大作此刻正躺在卧室电视里——十分钟零成本画面一步没出家门。照着勾按安装节对应系统的命令装好 SunshineLinux 记得跑additional-install.sh访问https://localhost:47990完成首次用户名密码设置在 Moonlight 中添加主机通过 PIN 页完成配对用内置Desktop应用串流一次桌面确认画面与键鼠输入正常在Applications页添加至少一个自定义游戏入口按排障表实际处理一次卡顿或输入问题进阶启用upnp解锁出门串流延伸阅读均在仓库内docs/getting_started.md各发行版的安装方式与首次启动完整细节docs/configuration.md每个配置项的含义、默认值与可选值docs/performance_tuning.md码率、分辨率与编码器选择docs/troubleshooting.md按平台细分的疑难问题手册含 iPerf3 网络测试方法docs/building.md想从源码编译 Sunshine 的开发者入口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考