20 分钟搭好自己的游戏串流主机Sunshine 完全上手指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine手机上的 Moonlight 打开后设备列表空空如也装好的主机连影子都没有或者勉强串出画面一跑游戏就掉线。这类问题十有八九不是软件坏了而是中间漏了某一步。Sunshine 是一个自托管的游戏串流主机装在你的游戏 PC 上它负责采集屏幕、做硬件编码再把视频流通过局域网推给手机、平板或电视上的 Moonlight 客户端。跨网组网、下载管理它都不管但把局域网内这第一帧画面串出来20 分钟足够。先确认手头有什么一台主机Windows、Linux 或 macOS 均可macOS 属于实验性支持且暂不支持手柄模拟一台装好 Moonlight 客户端的设备两台设备在同一局域网内主机有带硬件编码的显卡NVIDIA、AMD、Intel 都行没有也能走 CPU 软编码但帧率会受限Linux 主机需已登录桌面环境采集画面离不开显示器会话 把主机端装好Windows 去项目 Release 页面拿Sunshine-Windows-AMD64-installer.msi双击安装防火墙规则由安装器自动写入不用手动加。Linux 按发行版走包管理器Debian/Ubuntu 装完云源配置脚本后执行sudo apt install sunshine。macOS 把 DMG 里的Sunshine.app拖进 Applications。如果走 Flatpak 安装装完必须再执行一条命令flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine⚠️ 坑在这里Flatpak 沙箱不会同步输入注入用的 udev 规则跳过这条命令后面键鼠按下去主机没反应。检查点安装过程无报错弹窗进程能正常退出。 把服务拉起来Windows 的 MSI 已把 Sunshine 注册成系统服务并开机自启这步直接跳过。Linux 手动启动systemctl --user start app-dev.lizardbyte.app.Sunshine想开机自启再补一条systemctl --user --now enable app-dev.lizardbyte.app.SunshinemacOS 首次启动会弹屏幕录制和麦克风授权两项都点允许否则后面采不到画面也听不到声音。检查点Linux 上执行systemctl --user status app-dev.lizardbyte.app.Sunshine状态是 running。设管理员账号浏览器打开https://localhost:47990。页面提示不安全是自签名证书导致的忽略即可。首次进入要求设置管理员用户名和密码——记下来后面全靠它。忘密码不用重装在主机上执行sunshine --creds 新用户名 新密码直接重置。 第一次配对客户端设备打开 Moonlight它会自动扫到局域网里的主机。首次连接时 Moonlight 弹出一个四位 PIN 码回到 Web UI 顶部导航的 PIN 页把它输进去顺手给设备起个名字提示成功即配对完成。检查点在 Moonlight 里点自带的Desktop条目客户端屏幕出现主机桌面的实时画面声音、鼠标都有响应。第一帧出来了。加一个真实游戏Web UI 的 Applications 页默认自带 Desktop 条目它不启动任何程序、直接串整个桌面新串流会自动终止上一个在跑的应用全局同一时间只有一条流。添加游戏就是填程序路径两处细节容易翻车启动命令本身立即退出的程序典型如 Steam在应用配置里勾上detached否则流刚开就断。Flatpak 环境里跑宿主程序命令要加flatpak-spawn --host前缀沙箱里直接找不到目标。路径支持$(HOME)这类环境变量别写死绝对路径。配置只动这几个数配置页顶部有搜索框输关键词直达条目几百个设置项不用翻菜单。真正需要碰的只有下面几个其余全部留默认max_bitrate默认0含义是码率完全按 Moonlight 的请求走只有想在主机端给带宽封顶时才填具体数比如5000Kbps。encoder默认自动选第一个可用编码器手动填nvenc、amdvce、vaapi、vulkan、software是排障手段日常留空。nvenc_preset1 到 7默认1最快网络或客户端解码顶不住时才调大多数情况下提码率比动 preset 划算。upnp默认disabled要走出局域网才改成enabled。容易翻车的点串流卡顿、掉帧。先查网络别急着改配置。主机端起iperf3 -s客户端执行iperf3 -c 主机IP -t 60 -u -R -b 50M目标是丢包低于 5%、抖动低于 1ms。典型诱因是两头速度不匹配2.5G 网卡配 WiFi 客户端把网卡降一档或主机改回有线通常立刻见效。https://localhost:47990打不开。防火墙拦了 47990。Windows 先确认 MSI 写入的规则还在临时关防火墙验证一次通了再补规则放行 47990。键鼠在主机上没反应。Linux 大概率是 udev 规则没重载执行sudo udevadm control --reload-rules后重连Flatpak 用户先回头确认 additional-install.sh 跑没跑。串流时想静音主机扬声器。⚠️ 别动audio_sink它决定采哪个声卡改用virtual_sink指向虚拟声卡流里有声音主机侧保持安静。卡住时先查这里症状最可能原因一条修复动作Moonlight 发现不了主机服务没在跑或不在同一局域网systemctl --user status app-dev.lizardbyte.app.Sunshine确认 running再核对两台设备同网段忘了管理员密码凭据丢失sunshine --creds 新用户名 新密码直接重置有画面没声音采集设备没指对Linux 用pactl info \| grep Sink查默认声卡名填进audio_sink想确认到底卡在哪日志里都有Web UI 的 Troubleshooting 页内置日志导航文件在~/.config/sunshine/sunshine.logLinux/macOS或%ProgramFiles%\Sunshine\config\sunshine.logWindows不同人怎么搭显卡带不动 3A 的轻薄本把它当解码显示端串书房主机跑游戏前提是同局域网且网络稳客户端分辨率按自己屏幕设就行。只想要一块大屏的人让主机当家庭影音节点串 Desktop 到电视看本地片源max_bitrate保持默认0静态内容占的带宽很小。一家人共用一台主机每个成员在自己的 Moonlight 设备上独立配对、各记各的设备名唯一前提是同一时间只有一条流谁在串谁用用完退出。跑通之后做两件事拿第二台设备再配一次对然后挑一个真实游戏完整走一遍配对 → 启动 → 串流 → 退出。完整参数表在 docs/configuration.md各平台安装细节在 docs/getting_started.md疑难杂症索引在 docs/troubleshooting.md编码与采集的各平台实现可以看 src/platform/ 目录。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考