十分钟零成本串流上电视Sunshine 自托管游戏串流服务器上手指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想把手柄从书桌挪到沙发上又不想为云游戏按月付费Sunshine 是一个免费开源的自托管游戏串流服务器为 Moonlight 客户端提供主机端它把主机上的游戏画面硬件编码成视频流推给手机、平板或电视再把客户端的键盘、鼠标、手柄输入模拟回主机。你解决的是「用现有硬件把游戏投到大屏」这个问题不用买服务也不用换设备。Sunshine 是 Moonlight 的主机端不是云游戏先把定位说透。串流链路分两头Sunshine 装在主机上负责抓屏、编码、注入输入Moonlight 装在客户端上负责解码和播放。Sunshine 自己不播画面。把它和另外两类常见方案放在一起看对比维度云游戏订阅厂商自家串流如平台自带 Remote PlaySunshine Moonlight游戏跑在哪厂商机房你的电脑你的电脑费用按月订阅多随平台赠送开源免费编码方厂商统一平台自研你主机上的 NVENC / AMF / QuickSync / VAAPI无硬编也能软件编码客户端选择指定 App自家生态Moonlight 全家桶Windows、macOS、Linux、Android、iOS、tvOS可调深度基本不可调有限编码器、分辨率、码率、快捷键、应用入口全部开放它不做什么不做解码播放Moonlight 的事不提供云端算力游戏占的是你自己的显卡macOS 上的 Sunshine 目前是实验性且不支持手柄模拟想玩手柄请拿 Windows 或 Linux 当主机。先查显卡再查 CPU最后查网络按「先查什么、再查什么、最后查什么」的顺序过一遍先查显卡。最低门槛NVIDIA NVENC 卡、支持 VAAPI 的 Intel 核显、AMD VCE 1.0 任意一个即可。三者都没有也没关系Sunshine 提供软件编码CPU 干活略吃资源。体验增强项4K 流需要 RTX 2000 系 / GTX 1080 及以上NVIDIA、VCE 3.1AMD、HD 510IntelHDR 流另有一档显卡门槛且要先在主机系统里开启 HDR。再查 CPU 和内存。入门线是 Ryzen 3 / Core i3 及以上、4GB 内存4K 和 HDR 建议升到 Ryzen 5 / i5 级。最后查网络。主机和客户端都连 5GHz WiFi802.11ac是推荐配置上 4K 则两边都插 CAT5e 及以上网线。系统版本同样要过线Windows 11、Ubuntu 22.04 / Debian 13 / Fedora 43、macOS 14.2FreeBSD 15.1。不满足的版本以官方文档为准。三条安装命令对应三套系统从官方发布页下载对应安装包或执行对应命令有发行版专属包时优先用专属包# Windows下载 Sunshine-Windows-AMD64-installer.msi 双击安装装完以服务运行 # LinuxDebian/Ubuntu替换为你的发行版与架构 sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb # LinuxFlatpak另需同步 udev 规则 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装完依次做五步每步都有可见信号启动服务。Linux 执行systemctl --user start app-dev.lizardbyte.app.Sunshine判断标准systemctl --user status app-dev.lizardbyte.app.Sunshine显示active (running)。Windows 安装后默认已作为服务在跑托盘区能看到 Sunshine 图标。macOS 首次启动会弹屏幕录制与麦克风授权点允许。打开 Web 管理界面。浏览器访问https://localhost:47990。出现「不安全网站」警告是自签名证书的正常表现继续访问即可。判断标准页面正常加载。设置 Web 登录账号。首次进入按提示创建用户名和密码。记牢它这是管理界面的唯一钥匙。配对客户端。在目标设备装 Moonlight添加这台主机当它索要 PIN 时回到 Web 界面导航栏的PIN页把码填进去给设备起个名字。判断标准出现成功提示Moonlight 里列出主机和应用。开一次流。在 Moonlight 里点任意应用。判断标准客户端 5 秒内出现主机画面键盘和手柄按键有响应性能叠加层里的码率稳定不掉零。三个用例把串流用出日常价值用例一整块桌面一键上大屏。目标电视上看主机桌面不启动任何程序。步骤Moonlight 应用列表里选内置的Desktop应用点开始。验证信号电视出现桌面且鼠标可控按CtrlAltShiftN能隐藏光标说明快捷键链路也通了。提示跑 3A 大作时改选Steam入口直接进大屏游戏模式手柄会被模拟成主机上配置的手柄类型输入延迟更低。用例二给单个游戏开直达入口。目标以后不在桌面里翻图标Moonlight 一点直达。步骤Web 界面进「应用」页点Add New填应用名、命令cmd与工作目录cwd比如某个游戏的启动命令保存Moonlight 刷新。验证信号列表里出现新入口点击后游戏被拉起且画面串出。提示命令里支持环境变量$(HOME)会自动替换成家目录串流中按CtrlAltShiftF1到F12可以切换显示器被串流应用退出时流会自动结束这是预期行为。用例三出门在外连回主机。目标不在家也能开玩。步骤Web 配置页搜索upnp让路由器自动映射转发把默认disabled改成enabled在 Moonlight 里手动添加主机的公网 IP。验证信号在外网设备发起连接后画面出现。提示基础串流端口默认47989Web 管理走47990远程对上行带宽敏感先把分辨率和码率调低再试。另外origin_web_ui_allowed默认lan即管理界面只允许局域网打开外网管理需要另做端口转发并配强密码。症状对号入座再翻日志症状常见原因处理Moonlight 搜不到主机不在同一网段或防火墙拦截确认同局域网在 Moonlight 手动填 IP 添加Web 界面打不开用了http前缀或端口被占改用https://localhost:47990检查防火墙日志提示编码器错误显卡驱动旧或缺少编码支持更新驱动对照 README 里的功能兼容表核对显卡与编码 API画面卡顿、掉帧带宽不足或码率过高先降分辨率和码率再谈画质键盘鼠标手柄无响应Linux 输入组权限缺失Windows 未装 Virtual HID DriverLinux 将用户加入input组后重启Windows 安装驱动后重启忘记 Web 登录密码凭据丢失命令行执行sunshine --creds 新用户名 新密码重置日志两个入口Web 界面的Troubleshooting页按条列出警告与错误编码器、GPU、网络问题逐条可查本地文件 Linux 在~/.config/sunshine/sunshine.logWindows 在%ProgramFiles%\Sunshine\config\sunshine.log位置可用配置项log_path改。想查全部启动参数终端跑sunshine --help。从装好到电视出画面全程不到十分钟花费为零延迟和画质都在你自己手里。按系统对应命令装好 Sunshine 并确认服务在运行打开https://localhost:47990完成首次账号密码设置在 Moonlight 添加主机通过 PIN 页完成配对用内置 Desktop 应用串一次桌面确认画面与输入正常在应用页添加一个自定义游戏入口并成功启动对照症状表处理一次卡顿或输入无响应进阶把upnp设为enabled验证外网可连延伸阅读均为仓库内文档上手安装各平台安装包、首次启动与快捷键细节全部配置项每个配置项的含义、默认值与可选值故障排查按平台细分的疑难问题与网络测试方法性能调优AMD / NVIDIA 侧的降延迟设置构建指南想从源码编译的开发者入口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考