从零搭建自托管游戏串流服务器Sunshine安装、Moonlight配对与延迟调优全指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine你是否遇到过这样的尴尬时刻游戏正打到关键时刻却被叫去客厅想在卧室大屏上躺平玩游戏主机却孤零零躺在书房出差住酒店手痒想玩家里电脑上那款只有 PC 才有的大作。Sunshine 正是一套专门解决这些场景的开源免费自托管游戏串流服务器它作为主机端程序运行在你的电脑上配合 Moonlight 客户端就能把 PC 上的游戏画面以低延迟、高质量的编码串流到手机、平板、电视和笔记本等任何设备上。一、先想清楚你需要的是一台会分身的电脑在动手之前我们先用一句话说清 Sunshine 的定位它不是云游戏平台而是把你自家的电脑变成云游戏主机。数据不出家门画面在你的设备间流转游戏进度和账号始终留在本地。免费且开源没有月费、没有时长限制代码完全开放社区持续维护。不挑显卡AMD、Intel、NVIDIA 的硬件编码器都能用没有显卡时还能退回软件编码。跨平台覆盖主机端支持 Windows、Linux、macOS客户端几乎覆盖所有主流操作系统。它的工作模型很简单Sunshine 负责在主机上采集画面、编码、接收控制指令Moonlight 负责在客户端上解码画面、回传键鼠手柄操作。两端通过专为游戏设计的低延迟协议通信这也是它比传统远程桌面更流畅的根本原因。二、动手前自查一套清单看清你的设备够不够格安装前花两分钟对照下面的清单可以帮你省掉后面一半的排障时间。项目最低要求推荐配置操作系统Windows 10 / Ubuntu 20.04 / macOS 11最新稳定版CPU四核处理器六核及以上显卡支持硬件编码即可NVIDIA GTX 10 系 / AMD RX 500 系 / Intel 核显 6 代以上内存8GB16GB网络主机千兆有线或 5GHz Wi-Fi千兆有线路由器支持端口转发即可支持 UPnP可免去手动转发需要特别提醒的是主机端请务必使用有线网络。串流画质的瓶颈往往不在编码器而在 Wi-Fi 的抖动与丢包。三、三种安装方式按你的系统对号入座方式一包管理器直接安装最快Debian / Ubuntu 及衍生系统可以直接安装sudo apt-get update sudo apt-get install sunshine安装完成后服务会自动启动稍后访问http://localhost:47990即可进入配置界面。方式二从源码编译想尝鲜最新版如果你想要最新的开发版功能或者发行版仓库里的版本太旧推荐源码编译git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine mkdir build cd build cmake .. make -j$(nproc) sudo make install编译前请确认系统已装好 CMake、编译工具链以及 FFmpeg、Boost 等依赖项目文档 docs/building.md 里列出了各平台的完整依赖清单。方式三Docker 容器部署隔离最干净不想污染宿主机环境的用户可以用容器docker run -d \ --namesunshine \ --restartunless-stopped \ --device/dev/dri:/dev/dri \ -p 47984-47990:47984-47990/tcp \ -p 48010:48010/udp \ -v /path/to/config:/config \ lizardbyte/sunshine:latest提示容器方案需要额外把显卡设备映射进容器--device/dev/dri是 Intel/AMD 核显与独显常见的映射方式NVIDIA 用户则需配合容器工具包使用。四、首次启动90 秒完成账号与安全设置无论用哪种方式安装首次启动后打开浏览器访问http://localhost:47990会看到欢迎页。首次访问时需设置 Web 管理界面的用户名和密码页面会提醒你妥善保管这一步的要点有三个设置强密码这个账号掌管着整个串流服务密码最好与日常账号区分开。记住端口47990 是管理界面端口47989 才是真正的串流端口两者别混淆。建议开启 HTTPS如果计划从公网访问务必在配置中启用 TLS避免密码明文传输。五、把桌面和游戏加进串流列表登录后进入 Applications应用页面你会看到 DESKTOP桌面环境和 STEAMSteam 大屏幕模式两个默认应用它们已经可以正常串流了。应用管理界面可对每个串流应用进行编辑、删除也可以随时添加新应用添加自定义游戏的方法点击 Add New填写应用名称与启动命令即可。比如给《赛博朋克2077》建一个入口启动命令可以填游戏的可执行文件路径。所有应用的配置最终都会汇总到一个 JSON 文件里——Linux 下通常在~/.config/sunshine/apps.jsonWindows 下在%APPDATA%\sunshine\apps.json手动编辑同样生效{ apps: [ { name: Steam 大屏幕模式, image-path: , prep-cmd: [], detached: [], output: desktop, cmd: [steam://open/bigpicture] } ] }修改完文件后重启 Sunshine 或让客户端重新连接应用列表即会刷新。六、捕获与编码让画质和延迟兼得的平衡术Sunshine 在屏幕捕获和视频编码两层都做了多后端支持这也是它跨平台表现稳定的底气。操作系统屏幕捕获方式特点WindowsDXGI 桌面复制捕获开销低支持多显示器LinuxKMS/DRM、X11、Wayland按桌面环境自动选择macOS系统原生采集与系统集成度高编码层面Sunshine 会按显卡品牌自动探测可用的硬件编码器并在配置界面的 Audio/Video 标签页中展示显卡品牌优先编码器备选方案NVIDIANVENC软件编码AMDAMF / VAAPIVulkan VideoIntelQuick SyncQSVVAAPI给新手的建议默认自动选择即可。只有当画面卡顿或编码器报错时才需要手动指定编码器——这通常发生在驱动版本过旧或显卡不支持某个编码格式时。七、网络调优实战局域网与公网两套方案网络配置是串流体验的分水岭。进入 Configuration 页面搜索框可以帮你快速定位任意配置项不必在一长串列表里翻找。输入关键词即可快速定位到对应的配置项例如搜索 UPnP 直接跳转到网络设置场景 A只在家庭局域网内串流这种场景最简单配置追求稳字upnp false local_network_only true bitrate 20000局域网内 20Mbps 的码率已能获得相当不错的 1080p 画面如果你的路由器和客户端都支持可以逐步上调到 30–40Mbps。场景 B从公网远程访问远程串流的关键是能连上和连得上按下面顺序检查upnp true local_network_only false端口可达串流端口 47989 及 48010 的 UDP 需要能从公网访问路由器支持 UPnP 时让 Sunshine 自动转发即可不支持就手动做端口映射。启用加密在 Web 界面开启 HTTPS避免控制指令和 PIN 码在公网裸奔。动态 IP 问题家庭宽带公网 IP 会变化配合动态 DNS 服务把固定域名指向家里客户端只需记住域名。码率收缩公网上行带宽有限时把分辨率降到 1080p、码率控制在 10–15Mbps流畅度优先于画质。八、Moonlight 客户端从配对到开玩的四步曲主机配置完毕接下来在任意设备上安装 Moonlight 客户端。Sunshine 的 Web 界面里内置了 Featured Apps 页面直接列出各平台官方推荐的客户端省去四处搜索的麻烦。在 Web 界面即可查看并获取各平台的 Moonlight 客户端配对流程只需四步添加主机在 Moonlight 中添加主机输入 Sunshine 所在电脑的 IP 或域名。局域网内通常会自动发现。发起配对点击配对按钮客户端会生成一组四位 PIN 码。确认 PIN在 Sunshine 的 Web 界面 PIN 页面输入这组数字完成授权。选择应用配对成功后选择要串流的桌面或游戏即可开始。小贴士同一台 Sunshine 支持多台设备分别配对。哪天换了新平板只需在客户端重新走一遍配对流程旧设备的授权也不会被覆盖。九、常见问题速查表症状、原因、解法一次讲清串流过程中遇到问题不要慌九成情况都能在下面的表里找到答案。症状可能原因解决方案客户端找不到主机两端不在同一网络或防火墙拦截确认同一网段放行 47984–47990 端口必要时手动输入 IP连上了但画面卡成幻灯片Wi-Fi 信号弱或带宽不足主机改有线降低分辨率与码率关闭占用带宽的后台下载画面模糊有马赛克码率设置过低局域网内上调 bitrate公网则优先降低分辨率手柄无响应虚拟手柄驱动未安装在 Troubleshooting 页面安装 ViGEmBus 驱动并确认版本 ≥ 1.17编码器报错打不开驱动过旧或编码格式不支持更新显卡驱动在配置中切换到备选编码器声音延迟或断流音频缓冲区过小调大音频缓冲关闭其他应用的独占音频诊断问题最直接的工具是日志页面它实时滚动输出 Sunshine 的运行记录编码器错误、握手失败等信息都会明明白白写在这里。日志界面会列出编码器初始化失败等具体错误是排查问题的第一手资料十、进阶玩法让串流服务更顺手用 API 实现自动化Sunshine 提供了 HTTP API可以脚本化地管理应用与串流。例如查询应用列表curl -X GET http://localhost:47990/api/apps启动某个应用curl -X POST http://localhost:47990/api/apps/launch \ -H Content-Type: application/json \ -d {app_id: desktop}把这类请求写进家庭自动化脚本就能实现一键开机进游戏之类的联动。换一个顺眼的主题Web 界面的外观可以按喜好切换主题色深色、浅色以及多种强调色随意搭配长时间管理也不刺眼。配置界面支持多种主题配色管理体验更舒适用日志做长期观察如果串流体验时好时坏建议每次出问题都看一眼日志页面丢包、编码耗时、握手耗时这些数据会告诉你瓶颈究竟在网络还是在主机性能上。十一、回顾与行动清单现在把整套流程串起来回忆一遍定位Sunshine 是把自家电脑变成串流主机的开源方案数据全程自持。准备主机走有线、显卡支持硬件编码是体验的地基。安装包管理器最快、源码编译尝鲜、Docker 最干净三选一即可。安全首次启动设强密码公网访问务必开启 HTTPS。应用桌面与 Steam 开箱即用自定义游戏只需一条启动命令。网络局域网求稳、公网求通码率按带宽动态取舍。客户端Moonlight 四步配对一次授权多端复用。排障遇到问题先查日志再对照症状速查表逐项排除。给你的行动清单今天先选一种安装方式部署起来 → 在浏览器完成账号设置 → 用手机装个 Moonlight 配对 → 串流一次桌面确认基本通路 → 之后再去折腾码率、主题和 API。别一上来就追求极限参数先把能流畅玩起来做到再慢慢优化——稳定流畅永远比数字好看更重要。愿你无论坐在哪块屏幕前都能随时回到自己的游戏世界。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/17 21:41:53 · 阅读 1.2k 从零搭建自托管游戏串流服务器：Sunshine安装、Moonlight配对与延迟调优全指南
从零搭建自托管游戏串流服务器Sunshine安装、Moonlight配对与延迟调优全指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine你是否遇到过这样的尴尬时刻游戏正打到关键时刻却被叫去客厅想在卧室大屏上躺平玩游戏主机却孤零零躺在书房出差住酒店手痒想玩家里电脑上那款只有 PC 才有的大作。Sunshine 正是一套专门解决这些场景的开源免费自托管游戏串流服务器它作为主机端程序运行在你的电脑上配合 Moonlight 客户端就能把 PC 上的游戏画面以低延迟、高质量的编码串流到手机、平板、电视和笔记本等任何设备上。一、先想清楚你需要的是一台会分身的电脑在动手之前我们先用一句话说清 Sunshine 的定位它不是云游戏平台而是把你自家的电脑变成云游戏主机。数据不出家门画面在你的设备间流转游戏进度和账号始终留在本地。免费且开源没有月费、没有时长限制代码完全开放社区持续维护。不挑显卡AMD、Intel、NVIDIA 的硬件编码器都能用没有显卡时还能退回软件编码。跨平台覆盖主机端支持 Windows、Linux、macOS客户端几乎覆盖所有主流操作系统。它的工作模型很简单Sunshine 负责在主机上采集画面、编码、接收控制指令Moonlight 负责在客户端上解码画面、回传键鼠手柄操作。两端通过专为游戏设计的低延迟协议通信这也是它比传统远程桌面更流畅的根本原因。二、动手前自查一套清单看清你的设备够不够格安装前花两分钟对照下面的清单可以帮你省掉后面一半的排障时间。项目最低要求推荐配置操作系统Windows 10 / Ubuntu 20.04 / macOS 11最新稳定版CPU四核处理器六核及以上显卡支持硬件编码即可NVIDIA GTX 10 系 / AMD RX 500 系 / Intel 核显 6 代以上内存8GB16GB网络主机千兆有线或 5GHz Wi-Fi千兆有线路由器支持端口转发即可支持 UPnP可免去手动转发需要特别提醒的是主机端请务必使用有线网络。串流画质的瓶颈往往不在编码器而在 Wi-Fi 的抖动与丢包。三、三种安装方式按你的系统对号入座方式一包管理器直接安装最快Debian / Ubuntu 及衍生系统可以直接安装sudo apt-get update sudo apt-get install sunshine安装完成后服务会自动启动稍后访问http://localhost:47990即可进入配置界面。方式二从源码编译想尝鲜最新版如果你想要最新的开发版功能或者发行版仓库里的版本太旧推荐源码编译git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine mkdir build cd build cmake .. make -j$(nproc) sudo make install编译前请确认系统已装好 CMake、编译工具链以及 FFmpeg、Boost 等依赖项目文档 docs/building.md 里列出了各平台的完整依赖清单。方式三Docker 容器部署隔离最干净不想污染宿主机环境的用户可以用容器docker run -d \ --namesunshine \ --restartunless-stopped \ --device/dev/dri:/dev/dri \ -p 47984-47990:47984-47990/tcp \ -p 48010:48010/udp \ -v /path/to/config:/config \ lizardbyte/sunshine:latest提示容器方案需要额外把显卡设备映射进容器--device/dev/dri是 Intel/AMD 核显与独显常见的映射方式NVIDIA 用户则需配合容器工具包使用。四、首次启动90 秒完成账号与安全设置无论用哪种方式安装首次启动后打开浏览器访问http://localhost:47990会看到欢迎页。首次访问时需设置 Web 管理界面的用户名和密码页面会提醒你妥善保管这一步的要点有三个设置强密码这个账号掌管着整个串流服务密码最好与日常账号区分开。记住端口47990 是管理界面端口47989 才是真正的串流端口两者别混淆。建议开启 HTTPS如果计划从公网访问务必在配置中启用 TLS避免密码明文传输。五、把桌面和游戏加进串流列表登录后进入 Applications应用页面你会看到 DESKTOP桌面环境和 STEAMSteam 大屏幕模式两个默认应用它们已经可以正常串流了。应用管理界面可对每个串流应用进行编辑、删除也可以随时添加新应用添加自定义游戏的方法点击 Add New填写应用名称与启动命令即可。比如给《赛博朋克2077》建一个入口启动命令可以填游戏的可执行文件路径。所有应用的配置最终都会汇总到一个 JSON 文件里——Linux 下通常在~/.config/sunshine/apps.jsonWindows 下在%APPDATA%\sunshine\apps.json手动编辑同样生效{ apps: [ { name: Steam 大屏幕模式, image-path: , prep-cmd: [], detached: [], output: desktop, cmd: [steam://open/bigpicture] } ] }修改完文件后重启 Sunshine 或让客户端重新连接应用列表即会刷新。六、捕获与编码让画质和延迟兼得的平衡术Sunshine 在屏幕捕获和视频编码两层都做了多后端支持这也是它跨平台表现稳定的底气。操作系统屏幕捕获方式特点WindowsDXGI 桌面复制捕获开销低支持多显示器LinuxKMS/DRM、X11、Wayland按桌面环境自动选择macOS系统原生采集与系统集成度高编码层面Sunshine 会按显卡品牌自动探测可用的硬件编码器并在配置界面的 Audio/Video 标签页中展示显卡品牌优先编码器备选方案NVIDIANVENC软件编码AMDAMF / VAAPIVulkan VideoIntelQuick SyncQSVVAAPI给新手的建议默认自动选择即可。只有当画面卡顿或编码器报错时才需要手动指定编码器——这通常发生在驱动版本过旧或显卡不支持某个编码格式时。七、网络调优实战局域网与公网两套方案网络配置是串流体验的分水岭。进入 Configuration 页面搜索框可以帮你快速定位任意配置项不必在一长串列表里翻找。输入关键词即可快速定位到对应的配置项例如搜索 UPnP 直接跳转到网络设置场景 A只在家庭局域网内串流这种场景最简单配置追求稳字upnp false local_network_only true bitrate 20000局域网内 20Mbps 的码率已能获得相当不错的 1080p 画面如果你的路由器和客户端都支持可以逐步上调到 30–40Mbps。场景 B从公网远程访问远程串流的关键是能连上和连得上按下面顺序检查upnp true local_network_only false端口可达串流端口 47989 及 48010 的 UDP 需要能从公网访问路由器支持 UPnP 时让 Sunshine 自动转发即可不支持就手动做端口映射。启用加密在 Web 界面开启 HTTPS避免控制指令和 PIN 码在公网裸奔。动态 IP 问题家庭宽带公网 IP 会变化配合动态 DNS 服务把固定域名指向家里客户端只需记住域名。码率收缩公网上行带宽有限时把分辨率降到 1080p、码率控制在 10–15Mbps流畅度优先于画质。八、Moonlight 客户端从配对到开玩的四步曲主机配置完毕接下来在任意设备上安装 Moonlight 客户端。Sunshine 的 Web 界面里内置了 Featured Apps 页面直接列出各平台官方推荐的客户端省去四处搜索的麻烦。在 Web 界面即可查看并获取各平台的 Moonlight 客户端配对流程只需四步添加主机在 Moonlight 中添加主机输入 Sunshine 所在电脑的 IP 或域名。局域网内通常会自动发现。发起配对点击配对按钮客户端会生成一组四位 PIN 码。确认 PIN在 Sunshine 的 Web 界面 PIN 页面输入这组数字完成授权。选择应用配对成功后选择要串流的桌面或游戏即可开始。小贴士同一台 Sunshine 支持多台设备分别配对。哪天换了新平板只需在客户端重新走一遍配对流程旧设备的授权也不会被覆盖。九、常见问题速查表症状、原因、解法一次讲清串流过程中遇到问题不要慌九成情况都能在下面的表里找到答案。症状可能原因解决方案客户端找不到主机两端不在同一网络或防火墙拦截确认同一网段放行 47984–47990 端口必要时手动输入 IP连上了但画面卡成幻灯片Wi-Fi 信号弱或带宽不足主机改有线降低分辨率与码率关闭占用带宽的后台下载画面模糊有马赛克码率设置过低局域网内上调 bitrate公网则优先降低分辨率手柄无响应虚拟手柄驱动未安装在 Troubleshooting 页面安装 ViGEmBus 驱动并确认版本 ≥ 1.17编码器报错打不开驱动过旧或编码格式不支持更新显卡驱动在配置中切换到备选编码器声音延迟或断流音频缓冲区过小调大音频缓冲关闭其他应用的独占音频诊断问题最直接的工具是日志页面它实时滚动输出 Sunshine 的运行记录编码器错误、握手失败等信息都会明明白白写在这里。日志界面会列出编码器初始化失败等具体错误是排查问题的第一手资料十、进阶玩法让串流服务更顺手用 API 实现自动化Sunshine 提供了 HTTP API可以脚本化地管理应用与串流。例如查询应用列表curl -X GET http://localhost:47990/api/apps启动某个应用curl -X POST http://localhost:47990/api/apps/launch \ -H Content-Type: application/json \ -d {app_id: desktop}把这类请求写进家庭自动化脚本就能实现一键开机进游戏之类的联动。换一个顺眼的主题Web 界面的外观可以按喜好切换主题色深色、浅色以及多种强调色随意搭配长时间管理也不刺眼。配置界面支持多种主题配色管理体验更舒适用日志做长期观察如果串流体验时好时坏建议每次出问题都看一眼日志页面丢包、编码耗时、握手耗时这些数据会告诉你瓶颈究竟在网络还是在主机性能上。十一、回顾与行动清单现在把整套流程串起来回忆一遍定位Sunshine 是把自家电脑变成串流主机的开源方案数据全程自持。准备主机走有线、显卡支持硬件编码是体验的地基。安装包管理器最快、源码编译尝鲜、Docker 最干净三选一即可。安全首次启动设强密码公网访问务必开启 HTTPS。应用桌面与 Steam 开箱即用自定义游戏只需一条启动命令。网络局域网求稳、公网求通码率按带宽动态取舍。客户端Moonlight 四步配对一次授权多端复用。排障遇到问题先查日志再对照症状速查表逐项排除。给你的行动清单今天先选一种安装方式部署起来 → 在浏览器完成账号设置 → 用手机装个 Moonlight 配对 → 串流一次桌面确认基本通路 → 之后再去折腾码率、主题和 API。别一上来就追求极限参数先把能流畅玩起来做到再慢慢优化——稳定流畅永远比数字好看更重要。愿你无论坐在哪块屏幕前都能随时回到自己的游戏世界。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考