Sunshine 自托管游戏串流服务器完整教程：30 分钟用 Moonlight 串流你的 PC

Sunshine 自托管游戏串流服务器完整教程30 分钟用 Moonlight 串流你的 PC【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款完全开源、免费的自托管游戏串流服务器专门配合 Moonlight 客户端使用。它把家里的游戏 PC 变成一台随叫随到的串流主机手机、平板、电视、笔记本都能接走你的游戏画面而所有数据始终停留在你自己的网络里不上任何云服务器。本文带你完成 Sunshine 安装、Moonlight 配对、关键参数调优和常见故障排查看完就能上手。你的 PC 就放在书房里但你更想窝在沙发上看它的画面。搬机器不现实云游戏会员又受制于订阅——Sunshine 解决的就是这件事采集本机画面 → 显卡硬件编码 → 走局域网发出去客户端在哪都行。它本身不含云一切发生在你自己家里隐私、延迟、画质都在你手里。 Sunshine 能做什么先看这张速览表你关心的Sunshine 的回答支持哪些系统Windows、Linux、macOS、FreeBSD画面怎么编码NVENC、QuickSync、AMD VCE、VAAPI、Vulkan Video另备 CPU 软编码兜底画面怎么采集Windows 桌面捕获Linux 支持 KMS、X11、Waylandwlr / KWin / Portal手柄怎么办客户端输入在主机上变成虚拟手柄Windows 与 Linux 均支持主流手柄怎么管理浏览器 Web UI配置、应用、日志、设备配对全在里面费用开源免费无订阅、无广告、无账号绑定一句话分工Sunshine 负责把画面高效送出去Moonlight 负责在任何屏幕上把它接回来。 各系统 Sunshine 安装步骤官方为每个平台都提供了现成的安装包从发布页选对应文件即可。Windows首选下载Sunshine-Windows-AMD64-installer.msi双击安装。官方推荐 MSI 安装器安装时按需勾选组件不要无脑全选安装器会顺手把防火墙规则配好。Linux按发行版选Debian/Ubuntusudo dpkg -i ./sunshine-{distro}-{版本}-{架构}.debFedora先sudo dnf copr enable lizardbyte/stable再sudo dnf install Sunshine包名大小写敏感Archpacman -S sunshineFlatpakflatpak install --system flathub dev.lizardbyte.app.Sunshine装完必须补跑flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine同步输入依赖通用兜底./sunshine.AppImage --install ./sunshine.AppImagemacOS实验性下载 DMG把Sunshine.app拖进 Applications或brew install sunshine。注意 macOS 版目前不支持手柄。FreeBSDsudo pkg install ./Sunshine-FreeBSD-14.4-{架构}.pkgDocker进阶玩家docker pull lizardbyte/sunshine。官方明确提示容器镜像不推荐大多数用户使用。完整安装与构建细节见 docs/getting_started.md。 Sunshine 首次启动与 Moonlight 配对方法装完到能串流就三步。第一步打开 Web UI。浏览器访问https://localhost:47990localhost 可换成主机内网 IP。首次访问会要求设置管理员账号密码——记牢它丢了只能走命令行重置。浏览器警告证书不安全是正常现象自签证书而已直接继续访问。第二步确认服务在跑。Linux 上执行systemctl --user start app-dev.lizardbyte.app.Sunshine想开机自启就用systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 的 MSI 安装器已将其注册为服务无需操作。第三步配对。在客户端设备打开 Moonlight它会自动发现局域网里的 Sunshine首次连接时 Moonlight 会显示一个四位 PIN 码回到 Web UI 的 PIN 页面输入该码、给设备起个名字授权完成。之后在 Moonlight 里点任意一个应用串流就开始了。 应用管理与配置搜索Web UI 里最常去的两个地方Sunshine 里所有可串流的东西都叫应用。你可以在 Web UI 把任意可执行程序加成应用每个应用独立配置启动命令和参数Moonlight 端一键启动。内置的 Desktop 应用不带任何命令点了直接串流当前桌面适合办公和看视频再给 Steam 加一个大屏模式应用手柄操作会顺畅很多。配置页有即时搜索框几百个配置项不用翻菜单输入关键词直达。比如搜UPnP直接跳到自动端口转发选项。Web UI 还有个 Featured Apps 标签页聚合了 Moonlight 客户端与配套工具的入口新用户可以从这里认识整个生态。⚙️ 影响串流体验的 4 个关键配置这四个项是画质和带宽的核心变量。先记住一条总原则拿不准就保持默认Sunshine 的默认值是经过调校的组合。max_bitrate码率上限单位 Kbps。默认0表示完全跟随 Moonlight 客户端请求的码率想压带宽就设个上限例如5000。encoder强制指定编码器默认自动选第一个可用的。手动可选nvencNVIDIA、quicksyncIntel、amdvceAMD、vaapi、vulkan仅 Linux或软编码按你的显卡对号入座。nvenc_presetNVENC 性能预设1最快到7压缩率最高、延迟略增。官方建议除非网络或解码端吃紧否则别动它直接加码率收益更大。minimum_fps_target画面静止时的最低帧率兜底默认0表示按流帧率的一半降帧省带宽一般不用改。音频别忘了配audio_sinkWindows 下运行%ProgramFiles%\Sunshine\tools\audio-info.exe查设备名Linux 下用pactl info | grep Sink查。想让主机扬声器保持静音、只把声音送进串流用虚拟声卡virtual_sink而不是直接改输出。串流中的快捷键和 Moonlight 一致CtrlAltShiftN切换光标显隐CtrlAltShiftF1/F12切换串流显示器。全部配置项的说明在 docs/configuration.md具体行为以官方文档为准。 Sunshine 常见故障排查打不开、搜不到、卡顿Web UI 打不开。九成是防火墙拦了端口。确认 47990 端口已放行或临时关防火墙验证Windows MSI 安装时本应自动写入防火墙规则没生效就手动加一条。Moonlight 搜不到 Sunshine。先确认两台设备在同一局域网再看服务是否真在跑Linuxsystemctl --user status app-dev.lizardbyte.app.Sunshine。都不行就重启 Sunshine 服务和路由器。串流卡顿、掉帧、丢包。先怀疑网络别怀疑 Sunshine。官方推荐的体检方式是用 iPerf3 做一次 60 秒 UDP 反向测试主机端跑iperf3 -s客户端跑iperf3 -c {主机IP} -t 60 -u -R -b 50M看客户端输出的丢包和抖动——理想值是丢包 5%、抖动 1ms。如果主机网卡如 2.5G远快于客户端那一环突发流量会冲爆中间设备的缓冲造成丢包把主机网卡速率降一档往往立竿见影。忘记 Web UI 密码。不用重装直接重置sunshine --creds {新用户名} {新密码}AppImage 对应./sunshine.AppImage --creds {新用户名} {新密码}Flatpak 对应flatpak run --commandsunshine dev.lizardbyte.app.Sunshine --creds {新用户名} {新密码}花括号内容自行替换。最后一道保险是日志Web UI 的 Troubleshooting 页能逐条翻看警告和错误本地日志文件在 Windows 的%ProgramFiles%\Sunshine\config\sunshine.log、Linux 的~/.config/sunshine/sunshine.log。更多专项问题Linux 输入失效、Portal 权限、MTU 丢包等见 docs/troubleshooting.md。 下一步三条路线走深一点刚跑通串流把 Desktop 当日常远程桌面用再加一个你玩最多的游戏应用然后换一台设备比如电视盒子再连一次体验完整闭环。想调画质组合研究encoder、nvenc_preset、max_bitrate三个参数跨网络远程游玩前把upnp enabled打开默认是disabled让 47990 等端口自动转发再在 Moonlight 里手动添加家里的公网地址。想读源码从src/nvenc/的 NVENC 编码封装和src/platform/的各平台采集、输入实现看起串流链路一目了然需要 clone 仓库时用git clone https://gitcode.com/GitHub_Trending/su/Sunshine。现在打开浏览器访问你的localhost:47990把第一个应用加进去——半小时后你的游戏库就不再只属于书房那台显示器了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考