Sunshine 自托管游戏串流完整指南4 步跑通第一条 Moonlight 串流【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一台跑在你自己电脑上的自托管游戏串流主机抓取主机画面、音频和手柄输入推流给任意 Moonlight 客户端电视、手机、平板都行。先说清一条最容易误解的边界——同一时刻 Sunshine 只维持一条活跃串流第二台设备发起连接会直接挤掉当前会话。想让两家人各看各的趁早别折腾。 Sunshine 能做什么、不能做什么支持Windows / macOS / Linux / FreeBSD 主机端客户端即 Moonlight覆盖 Android、iOS、TV、PC 各平台支持硬件编码nvenc、quicksync、amdvceLinux 另有vulkan、vaapiHDR 在 Windows 正式支持、Linux 实验性支持不支持多路并发串流永远只有一条流有条件支持手柄输入。macOS 和 Windows 上虚拟手柄依赖另装的 Virtual HID Broker付费许可macOS 老版本甚至不支持手柄Linux 需用户加入input组 开工前核对 5 件事核对项怎么确认显卡有硬件编码器装完进 Web 配置页看encoder是否自动选到了nvenc/quicksync/amdvce空着或只剩software就别上大屏主机到路由器链路质量主机跑iperf3 -s客户端跑iperf3 -c 主机IP -t 60 -u -R -b 50M丢包 5%、jitter 1 ms 才算合格Linux 输入权限groups $USER里有input没有就sudo usermod -aG input $USER后重新登录macOS 系统权限首次启动会要屏幕录制、麦克风照给Web UI 的 Troubleshooting Permissions 里复查Linux 捕获方式KMS 捕获需要原生包安装Flatpak / AppImage 用不了 KMS需要就换发行版包 首次配对到第一条串流4 步操作对照每一步都给你怎样算成功的判断点别跳着做。第 1 步装好并让它常驻。Windows 装 MSI自带系统服务装完自启macOS 把Sunshine.app拖进 ApplicationsLinux 加官方源后sudo apt update sudo apt install sunshine systemctl --user --now enable app-dev.lizardbyte.app.Sunshine验证信号Windows 托盘出现 Sunshine 图标Linux 执行systemctl --user status app-dev.lizardbyte.app.Sunshine显示 active (running)。第 2 步设管理员账号。浏览器打开https://localhost:47990自签证书报警告点继续即可。首次进入是 Welcome 页设定管理员用户名和密码——写下来忘了只能命令行找回。验证信号登录成功能进 Applications 页面。第 3 步批准 Moonlight 设备。客户端里手动添加主机填 Sunshine 本机的局域网 IP发起连接时它会弹一串 PIN。回 Web UI 顶部导航进 PIN 页输入这串码、给设备起个名字、回车。验证信号Moonlight 端弹出设备上的应用列表而不是转圈。此后该设备被记住不用再输 PIN。第 4 步添加第一个应用。Applications 页点 Add New填名字、图标和启动命令。命令支持$(HOME)环境变量展开Steam 游戏直接填steam://rungameid/xxx这种 URI参考 docs/app_examples.md。验证信号Moonlight 里点这个应用画面推过来了。容易翻车的地方应用分类型。普通cmd应用退出时串流跟着断detached类比如拉 Steam 本体这种会自我更新、杀原始进程的程序串流结束后不会被杀游戏挂在后台。你要关游戏就断流还是挂着后台按行为选类型。 按场景选参数先给结论再解释一句话结论编码器只决定画质和负载帧率才决定手感。进配置页顶部有搜索框直接搜bitrate、encoder比翻长列表快得多按串给谁看来定你的场景推荐配置为什么客厅电视encoder留空自动选第一个硬件编码器max_bitrate5000nvenc_preset11080p/60 起步再上 4K/60大屏分辨率可以妥协帧率不能preset 数字越大压缩越好但延迟越高追求低延迟就保持 1手机/平板分辨率压到 720p 或 1080p帧率 60nvenc_preset保持最小值手机解码器和屏幕都小参数往低延迟、低负载偏Wi-Fi 差就先 720p 测稳不稳外网远程max_bitrate限 5000、上行差压到 3000帧率 30 起步nvenc_preset调大换压缩效率外网带宽是硬瓶颈画质全给帧率让路两个默认值要心里有数max_bitrate默认0含义是完全跟随 Moonlight 客户端的请求填了才是 Sunshine 侧兜底限流encoder默认自动选第一个可用的NVIDIA 一般落到nvenc别去选software大屏分辨率下 CPU 会先崩。外网接入再补一档配置里开启upnp默认关闭让路由器自动映射路由器不支持就手动转发TCP 47984–47990Web 管理界面是 47990和UDP 48010光猫加路由的双层结构两层都得转。 出问题时按症状查先别猜打开 Web UI 的Troubleshooting页看实时日志每条 warning/error 都带上下文还能打包拿去社区问。症状第一步动作还不行再查什么延迟高主机插网线、客户端走 5 GHz 或有线先降到 720p 测帧率是否稳定稳了再逐级升分辨率定位瓶颈编码器过载就nvenc_preset降档或降到 30 帧完全没声音检查audio_sink是否指到正确回环设备macOS 用 BlackHole或 14 系统把 Audio Sink 留空走原生捕获想同时静音本机喇叭改用virtual_sink音画不同步在 Moonlight 客户端设置里调同步偏移以百毫秒为单位逼近正负都试键鼠/手柄没反应Linux用户加入input组后重新登录生效看日志里输入设备初始化段外网连不上确认端口转发生效TCP 47984–47990、UDP 48010upnp开了不代表映射成功看日志里的映射结果忘了管理员密码命令行执行sunshine --creds 新用户名 新密码重置详见 docs/troubleshooting.md✅ 上线前自查清单主机走有线所有客户端在 5 GHz Wi-Fi 或有线内管理员密码已记下来Moonlight 设备已批准并命名encoder是硬件编码max_bitrate按需限定兜底 5000外网场景已确认 TCP 47984–47990 / UDP 48010 转发生效应用类型选对了后台常驻的用detached随流断的用普通命令电视黑着屏遥控器一按主机风扇转起来——加载页出现在大屏上链路就成了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考