Sunshine 游戏串流主机快速上手指南5 步搭好免费自托管的 Moonlight 服务端【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款完全免费开源的自托管游戏串流主机你电脑上的游戏画面被实时抓取并硬件编码成视频流送到手机、平板、电视上的 Moonlight 客户端键盘、鼠标和手柄输入再原路传回主机。按本指南操作安装、配对、首次串流通常 10 分钟内可以完成全程不需要订阅费所有配置都在浏览器 Web 管理页完成。先想清楚Sunshine 与闭源串流方案的核心差异一句话结论Sunshine 让游戏继续跑在你自己的显卡上视频流只在你自己的网络里传输编码用的是显卡自带硬件编码器。对比项云游戏订阅 / 闭源串流Sunshine开源自托管游戏运行位置厂商机房你自己的电脑使用成本按月订阅费开源免费零费用编码方式服务端统一编码复用自家显卡的 NVENC、QuickSync、VAAPI、AMF 等硬件编码没有硬件编码时也可软件编码客户端生态自家生态MoonlightWindows / macOS / Linux / Android / iOS 等数据流向经过第三方仅在你的网络内传输各平台支持的编码 API、抓屏方式、手柄模拟能力README.md 里有完整的兼容矩阵表格装之前可以先对照自己的显卡查一遍。动手前核对系统版本、硬件底线与网络要求先花一分钟核对三项能避开绝大多数安装问题。README 中提示这些要求表仍在完善中不建议作为购买硬件的唯一依据。系统版本Windows 11、Ubuntu 22.04、Debian 13、Fedora 43、macOS 14.2、FreeBSD 15.1。注意 macOS 版标记为实验性且暂不支持手柄想玩手柄操作请先选 Windows 或 Linux 主机。硬件底线CPU 为 AMD Ryzen 3 或 Intel Core i3 及以上内存 4GB 及以上显卡需支持硬件编码——AMD 为 VCE 1.0、NVIDIA 为带 NVENC 的卡、Intel 在 Linux 需 VAAPI 兼容核显Windows 需 Skylake 或更新带 QuickSync 的核显三者都没有时软件编码用 CPU也能跑。网络主机与客户端都接 5GHz 802.11ac WiFi 是推荐配置4K 串流建议两边都走 CAT5e 及以上网线。可选进阶4K 流需要 AMD VCE 3.1、Intel HD 510、NVIDIA RTX 2000 系Linux/ GTX 1080 及以上Windows以及 Ryzen 5 / i5 级 CPUHDR 流显卡门槛更高AMD VCE 3.4、Intel HD 730、NVIDIA GTX 10 系及以上且主机操作系统需先开启 HDR。首次跑通安装 Sunshine、打开 Web 界面并完成配对1. 按系统安装对应版本# LinuxFlatpak 用户级安装发行版有专属 deb/rpm 包时优先用发行版包 flatpak install --user flathub dev.lizardbyte.app.Sunshine # 安装后必须再跑一次同步主机侧 udev 规则 flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine # macOSHomebrew brew tap LizardByte/homebrew brew install sunshineWindows 从发布页下载Sunshine-Windows-AMD64-installer.msi双击安装即可安装完成后默认以服务运行。官方文档注明 Docker 镜像不推荐大多数用户使用。2. 启动服务并打开 Web 管理页# Linux一次性启动用户级服务 systemctl --user start app-dev.lizardbyte.app.Sunshine # 如需开机自启改用这条 systemctl --user --now enable app-dev.lizardbyte.app.Sunshine浏览器访问https://localhost:47990可把 localhost 换成内网 IP。浏览器提示不安全网站是自签名证书的正常表现继续访问即可。首次进入会要求你创建 Web 登录用户名和密码——务必记牢这是管理页的钥匙。3. 配对 Moonlight 客户端在目标设备安装 Moonlight 客户端并添加这台主机当客户端要求输入 PIN 时回到网页导航栏的PIN页填入该 PIN 并给设备起个名字看到成功提示即配对完成。成功时有三个可观察信号目标屏幕上几秒内出现主机画面键盘、鼠标和手柄操作都有响应串流持续稳定不中断。三条都满足说明已经通了。串通之后三个进阶玩法把 Sunshine 用出价值玩法一用内置 Desktop 入口远程操作主机桌面Sunshine 自带Desktop入口它不启动任何程序直接开始串流适合把主机当远程桌面用另有Steam入口点进去直接进大屏游戏模式跑 3A 大作更合适。串流中按CtrlAltShiftN可隐藏/显示光标所有快捷键都以CtrlAltShift开头按CtrlAltShiftF1到F12可切换串流显示器。玩法二把任意程序注册成一键启动的游戏项在 Web 管理页进Applications应用页点Add New填写应用名、程序路径cmd和工作目录cwd保存后 Moonlight 里刷新即可看到该入口。命令支持环境变量$(HOME)会替换成你的家目录$$会替换成$。两个机制要记住被串流的应用退出时串流会自动结束启动新应用时若已有应用正在运行它会被终止。玩法三开启 UPnP 自动端口转发支持远程串流在 Web 配置页搜索upnp默认disabled改成upnp enabled路由器就会自动映射串流端口。然后在 Moonlight 中手动添加主机公网 IP。基础串流端口默认47989网页管理走47990。远程串流对上行带宽更敏感先调低分辨率和码率再试。⚠️ Web 管理页的访问范围由origin_web_ui_allowed控制默认lan表示只有局域网设备能打开管理界面如需从外网管理要另外做端口转发并配强密码、保持软件更新。诊断与调优串流失败、卡顿、输入无响应对照表遇到问题先对照下表定位再看日志确认细节。症状常见原因处理Moonlight 发现不了主机不同网段或防火墙拦截确认同一局域网并放行相关端口在 Moonlight 中手动填主机 IP 添加Web 管理页打不开用了http或端口被占用https://localhost:47990访问检查防火墙规则日志报编码器错误显卡驱动或编码支持缺失更新显卡驱动对照 README.md 的功能兼容表核对 GPU 与编码 API键盘鼠标手柄无反应输入设备权限不足Linux/FreeBSD 把运行 Sunshine 的用户加入input组后重新登录Windows 安装 Virtual HID Driver 后重启忘记 Web 登录密码凭据丢失执行sunshine --creds 新用户名 新密码重置画面卡顿、掉帧带宽不足或码率过高先降分辨率/码率再参考 docs/performance_tuning.md 调整编码器日志的两个入口Web 端网页Logs标签页直接查看运行日志Troubleshooting页逐条列出警告与错误编码器、GPU、网络各环节的问题一眼可见本地文件Linux / FreeBSD / macOS 的配置目录为~/.config/sunshine日志文件名由配置项log_path控制默认sunshine.log每次启动最多保留 5 份旧日志想查可用启动参数时终端运行sunshine --help。行动清单按首次跑通章节对应自己系统的步骤安装 Sunshine启动服务并访问https://localhost:47990完成首次用户名/密码设置在 Moonlight 中添加主机并完成 PIN 配对用内置 Desktop 入口串流一次桌面确认画面与输入正常在 Applications 页添加至少一个自定义游戏入口按上表处理一次输入或卡顿问题进阶启用 UPnP解锁远程串流延伸阅读仓库内文档安装方式与各平台首次启动细节全部配置项的含义、默认值与可选值码率、分辨率与编码器调优按平台细分的疑难问题手册【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考