Sunshine 游戏串流服务器教程从安装到 Moonlight 配对的完整指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine 想象这样一个画面游戏装在书房那台 PC 上你人却窝在客厅的 4K 电视前——一根长 HDMI 线和固定坐姿不再是问题。这就是 Sunshine 要解决的事一个免费开源的自托管串流主机它把 PC 的画面与输入实时编码后推给 Moonlight 客户端让你在电视、手机、平板上直接玩主机端的游戏。同样的机制还覆盖外出场景手机连回家里 WiFi 就能接续游戏进度和临时远程访问——所有画面只走你自己的网络不经过任何第三方云。读完本文你会完成 Sunshine 的完整搭建装包、配凭证、加应用、配对客户端并在卡顿时知道该先动哪个旋钮。一分钟原理画面是怎么到你电视上的Sunshine 和 Moonlight 是一对搭档分工非常明确Sunshine主机端跑在你那台游戏 PC 上。它负责捕获桌面/游戏画面调用显卡硬件编码器NVIDIA 的 NVENC、AMD 的 AMF、Intel 的 QuickSync也有 VAAPI、Vulkan 和软件编码 x264 兜底把画面压成视频流同时把客户端发来的键鼠/手柄输入注回主机。Moonlight客户端端跑在电视、手机、树莓派或另一台电脑上负责拉取并解码这条流再把你的操作回传。数据流就是一条私有串流通道主机画面 → 硬件编码 → 你的网络 → Moonlight 解码 → 屏幕。默认端口占用 47984–47990 这一小段其中 47990 是 Web 管理界面的 HTTPS 端口UPnP 默认开启Sunshine 会自动完成局域网内的端口映射真正需要动手的只有外网访问——那才要自己在路由器上手动转发这段端口。上手前自查先确认这 4 件事在动手之前用这份清单过一遍你的环境能省掉后面 80% 的弯路主机一台 Windows / Linux / macOS 电脑。注意 macOS 目前是实验性支持且暂不支持手柄先有心理预期。编码硬件有 NVIDIA、AMD、Intel 独立显卡或较新核显最好硬件编码几乎不占 CPU什么都没有也能用软件编码代价是 CPU 吃紧。客户端任何能装 Moonlight 的设备都行——Windows、macOS、Linux、Android、iOS、智能电视、树莓派。网络第一次验证务必让主机和客户端在同一个局域网里。外网访问是后面的进阶动作需要路由器端口转发。安装选你的平台走同一条路三个平台的安装入口不同但目标一致——让 Sunshine 以服务/应用形式常驻。按你的系统挑分支即可。Windows从最新发布下载 MSI 安装包Intel/AMD 处理器选 AMD64 版ARM64 版仍属实验性质运行向导装完系统服务会随开机自启。想要完整的手柄输入能力自适应扳机、触摸板等可另行安装 Virtual HID Driver。LinuxDebian/Ubuntusudo dpkg -i sunshine-{发行版}-{版本}-{架构}.deb或apt install对应的 .debFedora先开源再装包sudo dnf copr enable lizardbyte/stable sudo dnf install SunshineArchpacman -S sunshine装完后如果服务没有自启补一条systemctl --user --now enable app-dev.lizardbyte.app.SunshinemacOS按芯片架构下载 DMGApple Silicon 选 arm64Intel 选 x86_64把 Sunshine.app 拖进应用程序文件夹。首次启动时系统会索要屏幕录制与麦克风权限两个都放行否则后面就是黑屏加无声。首次配对从零到连通的 5 步接下来是一条最短路径走完它你就拥有了一路可用串流。打开 Web 界面浏览器访问https://localhost:47990。证书告警是正常的——那是自签名证书忽略即可。设置管理凭证欢迎页要求你为 Web 界面设一组用户名和密码并勾选同意服务条款。⚠️ 凭证只展示这一次抄下来。添加第一个应用登录后进入 Applications 页。系统内置了 Desktop 和 Steam Big Picture 两个卡片验证链路时直接用 Desktop 就够了。要加自己的游戏就点 Add New填名称、可执行文件路径、工作目录、启动参数配一张 600×800 像素的图标。客户端发现并配对在电视或手机上打开 Moonlight它会自动发现局域网里的 Sunshine找不到就手动输 IP。Moonlight 发起配对后回到 Sunshine Web 界面的PIN 页读取配对码在客户端填入顺便给设备起个名字。开流在 Moonlight 里点选刚配对的服务器、选中 Desktop画面就会推过来。主机端同时被注入手柄/键鼠输入到此链路全线打通。需要找 Moonlight 各平台客户端或配套工具时Web 界面的Featured Apps页就是现成的下载站按 Clients / Tools 筛选即可。把串流调到最顺分组看参数调优的大部分动作发生在Moonlight 客户端侧Sunshine 会自动跟随这里按影响权重从高到低分三组讲。第一组带宽相关——卡顿先找这里视频比特率默认推荐 30 Mbps可调区间 2–100 Mbps。有线局域网可以往上顶远程访问压到 5–15 Mbps 更稳。分辨率/帧率建议从 1080p / 60fps 起步最高可到 4K、144fps。无线环境别贪高。实操经验出现卡顿时先降比特率、再降分辨率这个顺序通常比反过来效果更好因为降码率对延迟的改善更直接。第二组编码相关——决定画面底子视频编码器能用硬件就用硬件NVENC / AMF / QuickSync软件 x264 只作兼容兜底会明显吃 CPU。音频编码默认 Opus低延迟首选AAC 是替代项FLAC 无损但很吃带宽一般不值得。音频比特率默认 128 kbps区间 64–192 kbps。追求高音质选 192追极致低延迟选 64。第三组网络相关——决定上限局域网内有线 无线用 iperf3 测一下链路抖动低于 1 ms 才算好底子。外网访问前确认路由器已转发 47984–47990UPnP 只管内网映射替代不了手动转发。遇到问题先对症状把常见故障整理成问答对号入座QMoonlight 发现不了 Sunshine排查两台设备是否在同一子网主机防火墙是否拦了发现广播。 处理确认同局域网放行 47984–47990 端口仍不行就在 Moonlight 里用 IP 手动添加服务器。Q忘记 Web 界面的用户名或密码了原因凭证只在首次设置时展示一次之后不可查看。 处理不用重装直接重置——sunshine --creds 新用户名 新密码。Q延迟高、画面卡顿排查比特率是否给太高无线链路是否丢包。 处理按先降比特率、再降分辨率的顺序压参数条件允许就改有线。Q手柄在游戏里无反应原因主机上的物理手柄抢占了第一个输入设备的位置虚拟手柄反而被忽略。 处理禁用主机物理手柄让 Sunshine 的虚拟手柄成为首个设备Windows 上若装了 Virtual HID Driver确保其已正确注册。Q应用刚启动串流就断了原因被拉起的应用自身瞬间退出典型如 Steam 以普通进程方式启动后把控制权交给已有实例。 处理换用 detached 方式启动或确认可执行文件路径与参数是否真的能独立运行。Q黑屏日志一路报错排查采集后端没启用或缺少系统授权macOS 的屏幕录制/麦克风权限尤其常见。 处理进 Web 界面的 Troubleshooting 页逐条看日志确认采集方式与权限状态。继续深入仓库内的文档比本文详细得多按需取用docs/getting_started.md各平台安装细节与首用流程docs/configuration.md全部配置项说明含 upnp、采集后端等docs/performance_tuning.md性能调优专题docs/troubleshooting.md故障排查大全docs/guides.md社区教程与指南索引收尾回顾一下最短路径装包 → 设凭证 → 加一个应用 → 配对客户端。局域网里走通这四步你就有了一路稳定串流剩下的调参交给网络条件慢慢磨就行。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考