Sunshine 快速入门指南Moonlight 串流主机完整上手手册【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是自托管游戏串流主机装在自己的 PC 上把画面、音频和手柄输入推给任意 Moonlight 客户端电视、手机、另一台电脑都能当屏幕。边界先讲清一台 Sunshine 同一时间只维持一条活跃串流第二台设备发起连接会顶掉当前会话。 30 秒建立心智模型把 Sunshine 想成你自己机房里的一间「直播棚」它负责抓屏、硬编码、打包推流Moonlight 客户端是「电视机」只负责解码播放。串流主机和播放端分工明确你调参数永远只调「棚」这一侧。能做什么用 GPU 硬件编码nvenc/quicksync/amdvce/vulkan/vaapi推 1080p、4K 视频 系统音频把键盘、鼠标、手柄输入反向送进主机上的游戏提供https://localhost:47990的 Web 管理面板管理应用、设备、配置同网段内 Moonlight 自动发现主机零配置连接外网场景下用upnp让路由器自动开端口映射不能做什么不能多人同时各看各的只有一条活跃串流带宽也不会平分不自带播放端必须搭配 Moonlight 客户端各平台入口在 Web 面板 Featured Apps 页macOS 目前不支持虚拟手柄Linux 上 HDR 串流仍是实验性支持最小闭环5 步到第一帧画面第 1 步安装 SunshineWindows 装官方 MSI 安装包自带系统服务装完即自启macOS 把Sunshine.app拖进 Applications首次启动授予屏幕录制、麦克风权限Linux 加官方源后装包sudo apt update sudo apt install sunshine验证信号Windows 任务栏托盘出现 Sunshine 图标macOS 菜单栏出现图标Linux 跳到第 2 步。想从源码构建的clone 仓库https://gitcode.com/GitHub_Trending/su/Sunshine后 Linux 执行bash scripts/linux_build.shmacOS 执行scripts/macos_build.sh。第 2 步启动 Linux 用户级服务systemctl --user --now enable app-dev.lizardbyte.app.Sunshine验证信号命令无报错返回且systemctl --user status app-dev.lizardbyte.app.Sunshine显示active (running)。第 3 步设定管理员账号浏览器打开https://localhost:47990。自签证书会有警告点继续即可。首次访问要求设定管理员用户名和密码——务必写下来丢了只能翻配置文件找回。验证信号输入用户名密码后登录成功进入串流主界面。第 4 步批准 Moonlight 设备Moonlight 客户端里手动添加主机填 Sunshine 本机的局域网 IP发起连接时客户端会弹出一串 PIN。回到 Sunshine 面板顶部的 PIN 页面输入这串码、给设备起个名字、确认。验证信号PIN 页面出现批准成功提示此后这台设备被记住不用再输。第 5 步添加第一个应用并串出第一帧进 Applications 页面点 Add New填名字、图标、启动命令。命令支持环境变量展开$(HOME)会替换为$HOME的值。Steam 游戏建议选detached类型否则串流结束游戏进程会被直接杀掉。验证信号新应用出现在应用列表里Moonlight 客户端点开它电视/手机出现主机画面且声音正常——闭环完成。场景化调参一个表定参数核心判断只有一条编码器决定画质和负载帧率决定手感。进配置页直接用顶部搜索框搜bitrate、encoder、upnp比翻长列表快。场景关键参数推荐值取值理由客厅电视encoder不填自动选第一个可用硬编码器software软编在电视大屏分辨率下 CPU 会先崩客厅电视max_bitrate0或兜底50000表示完全跟随 Moonlight 客户端请求想限流再设 5000客厅电视nvenc_preset1P1 是 NVENC 最快档低延迟优先带宽紧张再上调换压缩效率手机/平板分辨率/帧率客户端侧720p–1080p60 帧客户端解码器和屏幕是瓶颈先降分辨率测帧率稳定手机/平板nvenc_preset1编码延迟最低外网远程max_bitrate3000–5000上行带宽是硬瓶颈画质参数全部让位外网远程nvenc_preset2及以上牺牲一点延迟换压缩效率码流更省外网远程upnpenabled默认disabled路由器不支持 UPnP 时改手动转发手动转发的端口全集基端口47989由源码端口偏移推出TCP47984客户端 HTTPS、47989客户端 HTTP、47990Web 面板、48010RTSP 信令UDP47998视频、47999控制、48000音频。光猫路由的双层 NAT 结构两层都要转。参数逐项含义见 官方配置文档。故障速查顺着分岔问下去出问题先看 Web 面板Troubleshooting页——实时日志就在里面每条 warning/error 都带上下文。Q1 客户端能不能看到主机同网段却没被发现 → 在 Moonlight 里手动填主机 IP 添加。能发现但连不上 → 进 Q2。Q2 是网络问题还是参数问题主机是否插了网线、客户端是否走 5 GHz Wi-Fi 或有线否 → 先换线/换频多数卡顿到此为止。是 → 进 Q3。Q3 帧率稳不稳把分辨率降到 720p 测稳了 → 瓶颈在带宽逐级升分辨率定位拐点仍不稳 → 编码过载把nvenc_preset降回低档或降到 30 帧。Q4 有没有声音配置里的audio_sink是否指到正确的回环设备否 → 改成对应设备名。是 → macOS 用户确认装了 BlackHole 这类虚拟声卡且 Sunshine 有麦克风权限。Q5 键鼠/手柄没反应Linux 用户运行 Sunshine 的用户在input组里吗否 → 加组并重新登录才生效。是 → 看日志里输入设备初始化段的报错。Q6 外网到底通没通upnp enabled不等于映射成功——查日志里的 UPnP 映射结果。失败 → 按上文端口清单手动转发双层 NAT 检查光猫和路由两层。更多细节对照 官方排障文档。上线前决策清单硬件与网络主机走有线所有客户端在 5 GHz Wi-Fi 或有线环境内编码器确认是硬件编码encoder非software账号与设备管理员密码已记录在安全处Moonlight 设备已批准并命名再次连接无需 PIN第二个设备发起连接前已知晓它会顶掉当前串流参数与外网max_bitrate已按需设置保持0或兜底5000外网场景upnp开启且日志确认映射成功或 TCP 47984–47990/48010 与 UDP 47998–48000 手动转发生效常驻类应用如 Steam 本体已设为detached避免退出串流时被杀进程打开电视从 Moonlight 里点开你的第一个应用等第一帧画面亮起来。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考