Sunshine 游戏串流服务器 10 分钟上手：安装、首次配对与 Moonlight 开玩完整指南

Sunshine 游戏串流服务器 10 分钟上手安装、首次配对与 Moonlight 开玩完整指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款完全免费开源的自托管游戏串流服务器它为Moonlight客户端提供服务端能力你电脑上的游戏画面被实时编码成视频流推到手机、平板、电视上手柄输入再原路传回主机。这篇文章带你完成 Sunshine 的安装步骤、首次配对并跑通把桌面串到电视这个核心功能全程约 10 分钟不用花一分钱。先搞清Sunshine 到底替你干了什么一句话它是串流链路的服务端自己不放画面只负责抓屏、编码、回传输入。游戏仍然跑在你自己的显卡上画面数据不出家门。Sunshine 在主机上干三件事抓取屏幕、调用显卡硬件编码NVENC、QuickSync、AMF、VAAPI 都行实在不行还能软件编码把画面压成视频流、把你客户端上的键盘鼠标手柄操作模拟回主机。至于播放交给 Moonlight 客户端——Windows、macOS、Linux、Android、iOS、tvOS 等平台上都有。把三种常见的在别人屏幕上玩游戏的方案放一起看差异很直白维度云游戏订阅服务硬件厂商闭源串流Sunshine开源自托管游戏运行位置厂商机房你的电脑你的电脑月度成本订阅费通常免费0 元开源免费数据去向交给第三方厂商生态内只在你自己的网络里客户端平台有限自家生态Moonlight 全家桶编码方式服务端统一厂商自研复用自家显卡硬件编码也可软件编码结论对新手很友好不花订阅费不绑厂商平台延迟和画质都在自己手里。搞清楚分工之后下一站先花一分钟核对硬件能避开绝大多数安装问题。动手前核对三件事系统、显卡、网络先照这张表对一下不达标也别慌——大多数只是降画质不是不能用。系统版本Windows 11、Ubuntu 22.04 / Debian 13 / Fedora 43、macOS 14.2FreeBSD 15.1。⚠️ macOS 版目前是实验性的且暂不支持手柄想用手柄操作请先选 Windows 或 Linux 主机。硬件最低门槛CPU 为 AMD Ryzen 3 或 Intel Core i3 及以上内存 4GB 起显卡带硬件编码即可——NVIDIA 的 NVENC 卡、Intel 的 VAAPI 核显、AMD 的 VCE 1.0。三者都没有时软件编码吃 CPU也能跑。网络主机和客户端都接 5GHz802.11acWiFi 是推荐配置想上 4K双方都建议走 CAT5e 及以上网线。4K 对显卡和 CPU 另有要求如 NVIDIA 需要 GTX 1080/RTX 2000 系以上、AMD 需要 VCE 3.1、CPU 到 Ryzen 5/i5 级HDR 串流门槛更高且主机系统需先开启 HDR细节以 README.md 里的硬件表格为准。条件核对完接下来把软件装上去。按系统选一行命令Sunshine 安装步骤原则是有发行版专属包就用它其次 FlatpakDocker 官方明确不推荐普通用户。Windows从发布页下载Sunshine-Windows-AMD64-installer.msi双击安装装完默认以服务运行。LinuxUbuntu/Debian 装.debFedora 装.rpm或 Copr 源发行版包都没有时再用 Flatpak。macOS下载对应架构的.dmg把Sunshine.app拖进应用程序即可也可用 Homebrew。# LinuxFlatpak发行版包优先 flatpak install --user flathub dev.lizardbyte.app.Sunshine flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine # macOSHomebrew brew tap LizardByte/homebrew brew install sunshine # Docker官方注明不推荐大多数用户使用 docker pull lizardbyte/sunshine装完做两件事把 Sunshine 跑起来。Linux 启动用户服务systemctl --user start app-dev.lizardbyte.app.Sunshine想开机自启就加--now enable。Windows 安装后默认已是服务。打开 Web 管理界面浏览器访问https://localhost:47990。浏览器会警告不安全网站——这是自签名证书的正常表现点继续访问即可看到 Sunshine 欢迎页就说明服务活着。界面能打开剩下唯一的事就是把 Moonlight 接进来。首次配置四步完成 Moonlight 配对这一步是整个流程里唯一需要两台设备配合的环节。登录https://localhost:47990。首次进入会要求创建管理界面的用户名和密码务必记牢——这是你日后改配置、查日志、看 PIN 的钥匙。在目标设备手机/平板/电视/电脑上装好 Moonlight 客户端添加这台主机。Moonlight 弹出 PIN 输入框时回到网页导航栏的PIN页把客户端显示的码填进去回车再给设备起个名字。看到成功提示即配对完成。在 Moonlight 里点选一个应用开始串流。怎么确认成功了目标屏幕 5 秒内出现主机画面按键和手柄都有响应。三条齐了就算跑通了。忘了欢迎页里Featured Apps标签吗各平台 Moonlight 客户端的下载入口都在那儿直接点进去装就行。配通之后别急着收工下面三个小任务能立刻把 Sunshine 用出价值。实战三连桌面串大屏、加游戏入口、出门连回来任务 1把整块桌面串到电视目标Moonlight 里一键看到主机桌面不启动任何程序。不配置任何东西也能做——Sunshine 自带Desktop应用整块桌面直接串流和Steam入口启动即进大屏游戏模式在 Moonlight 应用列表里选Desktop点开始电视/平板出现主机桌面后按CtrlAltShiftN可以隐藏或显示鼠标光标所有快捷键都以CtrlAltShift开头。体验提示跑 3A 大作优先选 Steam 入口进大屏模式手柄会被模拟成主机上配置的游戏手柄类型输入几乎无感延迟。任务 2给每个游戏开一个专属入口目标以后在 Moonlight 里一点直达游戏不用翻桌面图标。Web 管理界面进应用Applications页点Add New填应用名、程序路径cmd与工作目录cwd比如某个浏览器或 Steam 里某款游戏的启动命令命令里支持环境变量$(HOME)会自动替换成你的家目录Flatpak 用户记得在命令前加flatpak-spawn --host保存Moonlight 刷新即可看到新应用。体验提示串流中按CtrlAltShiftF1到F12可以切到不同显示器继续玩被串流的应用退出时串流会自动结束。任务 3出门在外连回主机目标不在家也能开机开玩。Web 配置页搜索栏里输入upnpUPnP 是路由器自动开转发的协议把默认disabled改成enabled让路由器替你映射串流端口Sunshine 基础端口默认47989网页管理走47990在 Moonlight 里手动添加这台主机的公网 IP远程串流对上行带宽很敏感先把分辨率和码率调低再试。体验提示Web 管理页的访问范围由origin_web_ui_allowed控制默认lan表示只有局域网设备能打开想从外网管理需要另行做路由器端口转发并且务必配强密码、保持软件更新。配置搜索长这样跑起来之后剩下就是出问题怎么办这一件事。出问题怎么办症状对照表与日志定位照症状开药先查表再翻日志。症状常见原因解法Moonlight 发现不了主机不同网段或防火墙拦截确认同一局域网并放行相关端口在 Moonlight 里手动填 IP 添加Web 界面打不开用了http或端口被占用https://localhost:47990访问检查防火墙规则日志报编码器错误显卡驱动旧或编码支持缺失更新显卡驱动对照 README.md 的编码兼容表核对 GPU画面卡顿、掉帧带宽不足或码率过高先降分辨率/码率再谈画质见 docs/performance_tuning.md键盘鼠标手柄没反应输入设备权限/驱动缺失Linux 把运行用户加入input组sudo usermod -aG input $USER后重新登录Windows 安装 Virtual HID Driver 后重启忘记 Web 登录密码凭据丢失忘记管理密码怎么重置终端执行sunshine --creds 新用户名 新密码日志定位三条路网页端Logs标签页直接看运行日志Troubleshooting页逐条列出警告与错误编码器、GPU、网络各环节一眼可见本地文件Linux 默认在~/.config/sunshine/sunshine.logWindows 在%LocalAppData%\Sunshine\sunshine.log路径可用配置项log_path修改保留最近 5 份历史查参数终端运行sunshine --help可看到全部启动参数。问题处理完最后用一张清单确认你真的从零跑通了。回到那张卧室的床完成清单那台书房 PC 里的 3A 大作现在正躺在你卧室的电视里——十分钟零成本数据一步不出家门。下次出门前记得把主机开机、Moonlight 点一下客厅就是你的游戏房。按对应系统的命令安装 Sunshine启动服务Linux 用systemctl --user start app-dev.lizardbyte.app.Sunshine访问https://localhost:47990记下首次创建的管理用户名密码在 Moonlight 中添加主机并完成 PIN 配对用内置 Desktop 应用串流一次桌面确认画面与输入正常在 Applications 页添加至少一个自定义游戏入口按症状对照表处理一次卡顿或输入问题进阶把upnp改为enabled解锁远程串流延伸阅读仓库内文档docs/getting_started.md各发行版安装方式与首次启动的完整细节docs/configuration.md每个配置项的含义、默认值与可选值改任何配置前先查这里docs/performance_tuning.md码率、分辨率、编码器选择专治卡顿docs/troubleshooting.md按平台细分的疑难问题手册docs/building.md想从源码编译 Sunshine 的开发者入口克隆仓库用git clone https://gitcode.com/GitHub_Trending/su/Sunshine【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考