Sunshine 游戏串流服务器 30 分钟新手指南从安装到串出第一帧【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是开源自托管的游戏串流主机配合 Moonlight 客户端使用它在你的主机上采集画面、硬件编码经局域网推送到手机、平板或电视等任意屏幕上。无需账号与订阅画质上限和数据都留在你的局域网里。值不值得上手适合谁想在另一块屏幕上观看强力主机上跑的游戏的人——主机在书房笔记本在卧室电视在客厅都算。要付出什么一台主机Windows / Linux / macOS 实验性 / FreeBSD 一台装了 Moonlight 客户端的客户端设备两者在同一局域网安装加配对约 30 分钟。换回来什么主机的全部性能与硬件编码能力免费、无订阅且整条流不离开家庭网络。与云串流服务的本质区别就一句话编码跑在你自己的机器上。动手前备齐主机系统Windows、Linux、macOS实验性暂不支持手柄模拟或 FreeBSD 之一客户端手机 / 平板 / 电视盒子 / 另一台电脑装有 Moonlight 客户端网络前提两台设备同一局域网连接稳定比带宽峰值更影响体验权限Linux 下运行 Sunshine 的用户需属于input组否则键鼠、手柄的虚拟输入不可用macOS 首次启动要允许屏幕录制与麦克风权限编码NVENC、QuickSync、AMF、VAAPI、VideoToolbox 任选其一即可全都没有时退回 CPU 软编码跑通全流程Sunshine 安装步骤Windows安装官方 Release 的Sunshine-Windows-AMD64-installer.msi。安装器会自动注册系统服务、开机自启并写入防火墙规则不用你手动加。Linux用发行版包管理器安装或从官方 Release 取 deb / RPM / Flatpak / AppImage。macOS把 DMG 里的Sunshine.app拖进 Applications。 通过信号安装程序正常退出无报错弹窗。Linux 启动 Sunshine 服务为什么执行Linux 上 Sunshine 进程不会自己拉起服务没起Web 管理页就不响应。systemctl --user start app-dev.lizardbyte.app.Sunshine启动后用下面这条确认状态看到 active (running) 就是起来了systemctl --user status app-dev.lizardbyte.app.Sunshine想让开机自启把上面命令里的start换成--now enable再执行一次效果是立即启动并注册自启。Windows 用户跳过本节MSI 已注册服务macOS 用户首次启动Sunshine.app时把屏幕录制和麦克风授权都点允许不开这一步后面采集不到画面。Flatpak 用户还必须补执行这条用来同步宿主机的输入依赖规则不补则键鼠注入缺组件flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine执行完连接一次流键鼠能正常注入即补装成功。创建 Sunshine 管理员账号浏览器打开https://localhost:47990。页面报不安全是自签名证书所致忽略即可。首次进入会让你设置管理员用户名和密码——后续配对全靠它记好。 通过信号登录成功顶部导航栏出现 PIN、Applications、Configuration、Troubleshooting 等入口。Moonlight 配对串出第一帧客户端打开 Moonlight它会自动扫到局域网里的 Sunshine。首次连接时 Moonlight 弹出一个四位 PIN 码回到 Web UI 顶部的 PIN 页输入顺手给设备起个名字出现成功提示即配对完成。然后在 Moonlight 里选列表自带的 Desktop 条目——它串整个桌面、不启动任何程序。 通过信号客户端屏幕上出现主机桌面的实时画面键鼠操作有响应声音也到位。到这一步采集、编码、传输、配对四件事全通了。参数怎么调默认别动encoder自动选第一个可用编码器日常留空。max_bitrate默认0码率完全由 Moonlight 请求说了算。nvenc_preset默认1最快。audio_sink默认取系统默认声卡决定采集哪个声卡。什么情况才动max_bitrate只想在主机端给带宽封顶时才填数字例如5000Kbps。encoder自动选择不当时手动填nvenc、vaapi、software等这是排障手段。nvenc_preset1最快到 7压缩率最高只有网络或客户端解码顶不住时才调大。virtual_sink串流时想静音主机扬声器用它指向虚拟声卡一块纯软件设备直接改audio_sink是错的那会改变采集源。upnp默认disabled只有想走出局域网公网连接时才开。动了怎么验证配置页顶部有搜索框输bitrate就能直达对应设置项不用翻几百个条目。保存后重开一次串流观察画质与带宽占用实际生效的编码器可去 Troubleshooting 页的日志里核对。组合玩法轻薄本带不动 3A 的人把它当解码显示端书房主机跑游戏串到笔记本或电视端只负责解码显示。前提两台设备同一稳定局域网客户端分辨率按自身屏幕设。不玩游戏的人把主机变家庭影音节点串 Desktop 到电视放本地片源、看网页。前提max_bitrate保持默认0静态内容带宽占用很小不用拉码率。一家人共用一台主机每个成员在自己的 Moonlight 设备上独立配对Web UI 里各记各的设备名。前提同一时间全局只有一条串流谁在串谁用用完退出。问题定位Qhttps://localhost:47990 打不开最可能原因防火墙拦了 47990 端口。 修复Windows 先确认 MSI 写入的防火墙规则还在临时关防火墙验证一次通了再补一条放行 47990 的规则。QMoonlight 发现不了主机最可能原因不在同一局域网或服务没在跑。 修复Linux 执行systemctl --user status app-dev.lizardbyte.app.Sunshine确认 running再核对两台设备是否同网段。Q串流卡顿、掉帧最可能原因网络问题而不是 Sunshine 本身。 修复先在主机端跑iperf3 -s起服务客户端跑iperf3 -c 主机IP -t 60 -u -R -b 50M反向 UDP 测 60 秒目标是丢包低于 5%、抖动低于 1ms。Q忘了管理员密码最可能原因凭据丢失。 修复不用重装执行sunshine --creds {新用户名} {新密码}直接重置。Q连接后键鼠没反应Linux最可能原因运行 Sunshine 的用户不在input组。 修复把该用户加入input组后重新登录。日志文件位置Windows 在%ProgramFiles%\Sunshine\config\sunshine.logLinux / macOS / FreeBSD 在~/.config/sunshine/sunshine.log。Web UI 的 Troubleshooting 页内置日志与告警导航点告警可直接跳到对应日志段。带走一句话编码器拿不准就留空自动选择日常够用手动指定只留给排障。max_bitrate为 0 意味着码率听 Moonlight 的想封顶带宽才需要碰它。走出局域网前确认upnp enabled默认disabled公网连不进来。下一步动作现在就拿第二台设备配一次对再往应用列表里加一条真实游戏完整走一遍配对 → 启动 → 串流 → 退出。延伸阅读docs/getting_started.md、docs/configuration.md各平台采集与编码实现见 src/platform/。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考