Sunshine 游戏串流主机一次跑通装好、连通首条串流并调好常见参数【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一个自托管游戏串流主机装在你自己的 PC 上把本机画面、声音和输入打包推给 Moonlight 客户端。本文覆盖安装确认、首条串流连通、按场景预置参数和排障四件事。先说死一条硬边界一台 Sunshine 只支撑一条活跃串流第二台设备连进来会直接接管当前会话两家人各看各的做不到别指望只能再加一台主机。值不值得装适合主机带硬件编码器NVIDIA/Intel/AMD想低延迟把游戏推到电视、手机或另一台 PC 上玩要本地化管理配置页、PIN 配对、实时日志全在浏览器里不依赖任何云端各平台安装成本可控Windows 装 MSI 即带系统服务Linux 是用户级 systemd 服务macOS 拖Sunshine.app进 Applications 即可不适合想两台设备同一时间各自独立串流——做不到别折腾期望主机关机时还能用——它是本地软件不是云服务不开机就串不了坚持用 Docker 跑——官方文档明确不推荐给普通用户AppImage 和 Flatpak 也不支持 KMS 采集有发行版原生包就优先用原生包动手前核对碰安装之前先确认这 5 件事每件都给了验证方式硬件编码器可用lspci | grep -i vga或nvidia-smi能看到显卡。这决定你能用nvenc、quicksync、amdvce里的哪一个也是后文调参的前提。端口空闲ss -ltnp | grep 47989无输出。同一台机器只能跑一个 Sunshine 实例端口被占是首条串流最常见的拦路虎。输入权限到位Linux/FreeBSDgroups $(whoami)输出里含input组没有就sudo usermod -aG input $USER然后重新登录生效。macOS 权限路径首次启动会请求屏幕录制和麦克风权限不授权就无法采集Web UI 的 Troubleshooting Permissions 可复查。包形态与采集方式匹配需要 KMS 采集就别用 AppImage/Flatpak装发行版原生包。场景触发才改参数先给个总判断编码器只决定画质和主机负载帧率和网络稳定性才决定手感。encoder默认留空即自动选第一个可用的硬件编码器一般不用动。全部参数定义见 docs/configuration.md配置页顶部有搜索框直接搜参数名比翻列表快。如果你只在同一局域网用 → 网络参数一个都不用改Moonlight 会自动发现主机。如果你要外网访问 →upnp默认disabled把它设为enabled让路由器自动端口映射是否成功以日志为准开了不等于成了。路由器不支持 UPnP 就手动转发port是基点默认47989范围 1029–65514Web 管理在基点1 即47990RTSP 在基点21 即48010TCP 和 UDP 都把47989–48010整段转掉改基点会带动整组平移。如果你想让 Sunshine 兜底限流 →max_bitrate默认0表示完全跟随 Moonlight 客户端请求设上限就从5000Kbps起步想画面让位于流畅就压到3000带宽富裕再往上加。如果你用 NVIDIA 卡想换压缩效率 →nvenc_preset范围 1–7默认1最快、延迟最低官方口径是网络和解码端都不受限时别动它直接加max_bitrate效果等价。如果你不想本机喇叭出声 → 用virtual_sinkmacOS 14 把audio_sink留空即走原生系统音频采集旧系统要 BlackHole 类虚拟声卡并填设备名。跑通主链路装好并确认存活目标状态服务在跑管理界面能打开。以 Debian/Ubuntu 为例装好发行版包后启用并启动用户级服务systemctl --user --now enable app-dev.lizardbyte.app.Sunshine怎么判断成了systemctl --user status app-dev.lizardbyte.app.Sunshine显示active (running)浏览器打开https://localhost:47990自签证书警告点继续即可进入页面。走偏时页面打不开或一直报错先查上面这条 status 命令服务没活时网页现象全都没意义。建好管理员账号并配对设备目标状态能登录管理界面Moonlight 设备被批准并命名。操作首次登录按提示创建管理员用户名和密码并记下来。然后在 Moonlight 客户端里添加主机——自动发现不到就手动填主机局域网 IP发起连接时客户端弹出 PIN回到 Web UI 顶部 PIN 页面输入并给设备起名。怎么判断成了PIN 页面出现成功提示且之后 Moonlight 重连不再索要 PIN。走偏时管理员密码忘了不用翻配置文件sunshine --creds 新用户 新密码直接重置。加入第一个应用并连上串流目标状态应用出现在列表里主机画面出现在客户端且输入有响应。操作Applications 页面点 Add New填名字、图标和启动命令命令支持$(HOME)展开。Desktop 是特殊应用不启动任何进程、直接推整个桌面第一次串流连通选它最省事。然后在 Moonlight 里选该应用连接。怎么判断成了客户端看到主机桌面按键和鼠标移动在主机上即时生效。走偏时输入没反应Linux/FreeBSD 下先查动手前核对第 3 条加进input组重新登录。应用分两种类型按你要的行为选cmd型进程退出时串流跟着断detached型串流结束后进程留在后台。症状对照表先拿日志再下判断Web UI 的 Troubleshooting 页有实时日志每条 warning/error 带上下文服务侧日志文件是数据目录下的sunshine.log。拿出问题时间点的 error 行按下表对照症状日志关键词可能原因处理动作Couldnt bind端口被其他进程占用停掉多余实例或改port基点值[libvirtualhid]段报错输入链路虚拟 HID 设备没建立先查input组权限仍不行看日志里输入设备初始化段Buffer overrun客户端侧链路太慢中间设备缓冲溢出压max_bitrate根治办法是降主机网卡速率或做流量整形详见 docs/troubleshooting.md画面正常但完全没声音audio_sink指错回环设备macOS 14 留空走原生采集其他平台核对回环设备名交付前自查encoder不是software确认在跑硬件编码管理员账号已记录Moonlight 设备已配对并命名max_bitrate按场景设过值默认0跟随客户端兜底5000外网场景upnp或手动转发47989–48010端口段已确认生效主机走有线客户端在 5 GHz Wi-Fi 或有线环境内主机亮着、电视黑着——在 Moonlight 上点一下 Desktop主机画面就该在大屏幕上活过来。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考