零基础 30 分钟跑通 Sunshine 游戏串流从安装到串出第一帧画面【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine主机塞在书房桌下你却想在客厅沙发上续昨晚的进度抬机器太沉拉 HDMI 太乱再买显示硬件更贵。Sunshine 是 Moonlight 的自托管游戏串流主机——它在你主机上采集画面、硬件编码走局域网把流推到 Moonlight 客户端的屏幕上。编码跑在你自己机器上画质和隐私都留在局域网。照着做从安装、建账号、配对到串出第一帧全程由你自己完成不需要任何人帮忙。跑通长什么样判定是否成功看四条可观察项在客户端设备手机、平板、电视盒子打开 Moonlight主机出现在设备列表里。点进列表自带的 Desktop 条目客户端屏幕上出现主机桌面的实时画面键鼠操作有响应。主机端 Web 管理界面https://localhost:47990能打开且已设置管理员账号。主机端进程后台存活装完服务后持续待命不需要额外操作。四条都满足说明采集、编码、传输、配对四件事全部打通后面只是加应用和调参数。项目速览维度内容主机端平台Windows 11、Linux、macOS实验性暂不支持手柄、FreeBSD编码通路NVENC、QuickSync、AMF、VAAPI、Vulkan Video、VideoToolbox外加 CPU 软编码兜底采集方式Windows 走桌面复制 APILinux 可选 NvFBC、KMS、X11、WLR、KWin、PortalmacOS 走系统屏幕录制管理入口浏览器 Web UI默认https://localhost:47990自签名证书浏览器报不安全属正常费用模式开源免费、自托管无账号无订阅与云端串流服务的本质区别一句话编码跑在你自己的机器上上限和隐私都不出局域网。跑通流程 Step 1按系统装好主机端软件 按系统拿安装包装完即可进下一步Windows到 Release 页面下Sunshine-Windows-AMD64-installer.msi双击安装。防火墙规则由安装器自动写入不用手动加。Linux按发行版选 debDebian/Ubuntu、rpmFedora/OpenSUSE或 pacmanArch包或从 Release 页手动下载对应包安装。macOS打开 DMG把Sunshine.app拖进 Applications弹出屏就点允许。 Flatpak 用户补一步——装完或每次更新后再执行下面这条同步宿主 udev 规则否则键鼠注入会缺组件flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine检查点安装程序正常退出无报错弹窗。 Step 2把服务拉起来 分系统启动服务WindowsMSI 已把 Sunshine 注册成系统服务并开机自启这步直接跳过。macOS首次启动会弹屏幕录制和麦克风授权都点允许否则后面采不到画面。Linux手动拉起服务下面两条命令分别是本次启动和开机自启systemctl --user start app-dev.lizardbyte.app.Sunshine systemctl --user --now enable app-dev.lizardbyte.app.Sunshine检查点进程后台活着。Linux 执行systemctl --user status app-dev.lizardbyte.app.Sunshine看到active (running)即通过。 Step 3建账号、配对、出画面 建管理员账号浏览器打开https://localhost:47990页面报不安全是自签名证书所致忽略即可。首次进入会让你设置管理员用户名和密码——记好配对全靠它。 Moonlight 端配对在客户端打开 Moonlight它会自动扫到局域网里的主机。首次连接 Moonlight 弹一个四位 PIN 码回到 Web UI 顶部导航的 PIN 页输入顺手给设备起个名字看到成功提示即配对完成。检查点Moonlight 里点 Desktop客户端屏幕出现主机桌面画面和声音都到位——第一帧串出来了。翻车清单最容易配错的三种写法Desktop 是唯一默认应用Applications 页默认自带 Desktop 条目串整桌面、不启动程序新串流会自动终止上一个在跑的应用——同一时间全局只有一条流。Steam 这类要勾 detached像 Steam 这种启动命令立即退出的进程在应用配置里勾上detached脱离式启动否则流刚开就断。Flatpak 宿主程序要加前缀Flatpak 环境里串宿主应用命令要加flatpak-spawn --host前缀不然沙箱内找不到目标。路径别写死应用命令支持$(HOME)这类环境变量写法直接替换成$HOME的值。三个核心参数max_bitrate默认0→ 管主机端编码的最高码率Kbps0表示完全由 Moonlight 请求说了算 → 只有想在主机端给带宽封顶时才填具体数比如5000。encoder默认取第一个可用编码器 → 管强制指定用哪个编码器 → 手动填nvenc、amdvce、vaapi、vulkan、software是排障手段日常留空即可。nvenc_preset默认1P1 最快→ 管 NVENC 的性能预设数字越大压缩越好但编码延迟越高 → 只有网络或客户端解码顶不住时才调大多数情况提码率比调 preset 划算。配置页顶部有搜索框几百个设置项直接输bitrate就能定位不用翻菜单。系统默认做了但没告诉你的行为全局只有一条流多人共用时谁连着谁用用完退出没有多路并发。macOS 是实验性且不支持手柄想用手柄主机请用 Windows 或 Linux。upnp默认disabled公网连不进来走局域网前想出门先改成enabled。audio_sink默认取系统默认设备多声卡时 Linux 用pactl info | grep Sink查名字再填想静音主机扬声器别改audio_sink它决定采哪个声卡改用virtual_sink指向虚拟声卡。适用场景显卡带不动 3A 的轻薄本/旧本用它当解码显示端串流书房主机跑游戏。前提两台设备同一局域网且网络稳定客户端分辨率按自身屏幕设即可。不玩游戏、只想要一块大屏的人主机当家庭影音节点串 Desktop 到电视放本地片源、看网页。max_bitrate保持默认0就行静态内容带宽占用很小。一家人共用一台主机的人每个成员在自己的 Moonlight 设备上独立配对Web UI 里各记各的设备名。前提就一条——同时只有一条流谁在串谁用用完退出。谁不适合想多路并发串流、或需要 macOS 上手柄模拟的人不适合。快速排障症状最可能原因一条修复动作https://localhost:47990打不开防火墙拦了 47990Windows 先确认 MSI 写入的防火墙规则还在临时关防火墙验证一次通了再补规则放行 47990Moonlight 发现不了主机不在同一局域网或服务没在跑Linux 执行systemctl --user status app-dev.lizardbyte.app.Sunshine确认 running再核对两台设备同网段串流卡顿、掉帧大概率是网络不是 Sunshine主机端iperf3 -s客户端iperf3 -c 主机IP -t 60 -u -R -b 50M目标丢包低于 5%、抖动低于 1ms忘了管理员密码凭据丢失不用重装sunshine --creds {新用户名} {新密码}直接重置还不行时优先看 Web UI 的 Troubleshooting 页内置日志与告警导航可逐条点开定位。日志文件位置——Windows 在%ProgramFiles%\Sunshine\config\sunshine.logLinux/macOS/FreeBSD 在~/.config/sunshine/sunshine.logDocker 用docker logs sunshine。带走这几条网络稳定性比带宽峰值更决定体验动手调画质前先跑一次 iPerf3 体检。编码器拿不准就留空自动选择日常够用手动指定只留给排障。max_bitrate为 0 意味着码率听 Moonlight 的想封顶带宽才需要碰它。走出局域网前确认upnp enabled默认是disabled公网连不进来。下一步动作现在就拿第二台设备配一次对再往应用列表里加一条真实游戏完整走一遍配对 → 启动 → 串流 → 退出。想深入看完整参数表在 docs/configuration.md疑难杂症索引在 docs/troubleshooting.md安装与用法在 docs/getting_started.md。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考