Sunshine 游戏串流完整指南30分钟从零搭建自托管 Moonlight 串流主机【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费、开源的自托管游戏串流服务器和 Moonlight 客户端配套使用把你自己电脑上的桌面和游戏画面实时送到手机、平板或电视上。读完本文你能在 30 分钟内完成安装、配对和首次串流并掌握编码器选择、远程接入与故障排查的完整方法。快速上手完成安装、配对并启动第一次串流这一节做完你的手机或另一台设备上就能看到串流画面了。安装 Sunshine。主流 Linux 发行版用包管理器一条命令装完依赖和服务会自动处理sudo apt install sunshineWindows 和 macOS 用户直接下载官方安装包按向导完成即可。创建管理员账户。服务启动后浏览器打开https://localhost:47990首次访问会要求设置用户名和密码。这是管理界面的访问凭证也是后续配对的安全基础建议记好。用 Moonlight 配对。在接收端设备手机、平板、电视或另一台电脑上安装 Moonlight 客户端打开后通常会自动发现局域网内的主机找不到就手动输入主机 IP。选择配对主机 Web 界面会弹出一个四位 PIN 码把它填进 Moonlight 的配对框双向信任就建立了。添加要串流的应用。Web 界面的 Applications 页面点 Add New填入应用名称、可执行文件路径和启动参数。默认配置里一般已有桌面Desktop和 Steam 大屏幕模式够你先跑起来。两种备选装法想掌控每个依赖可以 git clone https://link.gitcode.com/i/633fbd9e1a0cd272c859cbd28403eb89 后用 CMake 编译各平台的依赖清单见 docs/building.md不想动主机环境则用 Docker 运行关键是把 47984-47990/tcp、48010 和 47998-48000/udp 映射出去并挂载配置目录完整参数在 DOCKER_README.md 里有示例。30秒看懂原理串流的四步链路这一节看完你就知道卡顿和马赛克分别该找谁问罪。画面从主机到你手里的设备要经过四个环节捕捉通过系统级接口截取屏幕——Windows 用 DXGILinux 走 KMS/DRM 或 WaylandmacOS 用原生屏幕捕获编码把画面压成 H.264、HEVC 或 AV1 视频流音频一并编码进去传输经网络把视频和你的键鼠、手柄指令双向送到对端渲染Moonlight 解码播放你的操作沿原路返回主机。编码速度决定延迟网络质量决定清晰度——后面所有调优都围绕这两点展开。想深挖实现可以看 src/video.cpp 和 src/nvenc/ 这两个视频编码核心模块。家里怎么串得爽按显卡选编码器并调参这一节做完你在客厅沙发上拿到的画面质量会明显上一个台阶。Sunshine 能识别显卡并自动启用对应硬件编码先按你的硬件对号入座显卡WindowsLinuxmacOSNVIDIANVENCNVENCCUDA软件编码AMDAMFVAAPI / Vulkan Video软件编码IntelQuickSyncVAAPIVideo Toolbox没有可用硬件编码时会退回软件编码功能不受影响但 CPU 占用会明显上升。编码器确定后三项参数决定最终体验分辨率与帧率先看接收端屏幕的实际规格不必盲目上 4K。射击、竞速优先保帧率剧情向优先保分辨率比特率有线局域网可以大胆给到 30Mbps 以上无线或远程则降一档避免花屏编码预设对延迟敏感的游戏选低延迟预设看画面为主选高质量预设。配置页项很多但支持直接搜索关键词找到比翻菜单快出门在外怎么串UPnP、TLS 与动态 DNS这一节做完你在外面也能连回家里的游戏主机。远程串流比局域网多三步准备端口转发路由器支持 UPnP 的话在 Network 配置里启用 upnpSunshine 会自动打开串流所需端口不支持就手动转发 47984-47990 与 47998-48000相关实现见 src/upnp.cppTLS 加密走公网务必启用 TLS避免画面和输入明文传输动态 DNS家用宽带多是动态 IP配一个 DDNS 服务IP 变了也能稳定找到主机。两套参数策略按场景切换场景建议局域网主机接网线客户端用 5GHz 频段打开 local_network_only 限制只在本网络内响应分辨率拉满比特率 30Mbps 起远程分辨率和比特率各降一档换稳定性公网的延迟和抖动远高于局域网稳比清晰更重要排查手册五类常见问题按顺序检查遇到故障别慌按下面的顺序逐项过一遍多数问题在前三步内就能定位。现象按顺序检查客户端找不到主机1) 主机上 Sunshine 服务是否在运行 → 2) 两端是否在同一局域网 → 3) 防火墙是否放行 47984-47990 → 4) 改为手动输入主机 IP卡顿、马赛克1) 网络是否稳定有线优先 → 2) 比特率是否过高降一档试试 → 3) 显卡驱动是否过旧硬件编码器很吃驱动版本串流没声音1) 主机是否有其他程序独占音频 → 2) 切换 Sunshine 的音频输出设备 → 3) 系统默认播放设备是否被静音输入延迟高1) 键鼠、手柄的省电模式是否开启 → 2) 接收端设备性能是否足够 → 3) 关掉后台下载、在线视频等占带宽的应用多个客户端画质不一致属正常行为主机端按最高规格送画面各客户端在自己端调整压缩参数互不影响排查时先看日志编码器加载失败、网络断流这类问题在 Logs 页面里通常写得明明白白行动清单用包管理器装好 Sunshine在localhost:47990创建管理员账户在 Moonlight 里输入四位 PIN 完成配对添加游戏应用先串流桌面验证链路需要远程时按上一节配好 UPnP、TLS 和 DDNS再对照排查表微调参数。更多平台客户端和配套工具可在 Web 界面的 Featured Apps 页面直接查看。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考