Sunshine 游戏串流完整指南如何用 4 个步骤把 PC 变成本地串流主机【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费的开源游戏串流主机专为 Moonlight 客户端设计。它用你显卡的硬件编码能力把 PC 上的游戏画面和声音通过局域网推到电视、平板或笔记本上延迟低、画质好全程跑在你自己的网络里不花一分订阅费。下面这份指南带你从零开始装好、连上、玩起来。 它适合谁有一台游戏 PC 的人电脑放在书房想在客厅电视上玩有多块屏幕的家庭一台主机电视、平板、手机共享想省钱的串流玩家不想为云游戏按月付费数据还留在自己家Linux 用户官方提供 deb、rpm、AppImage、Flatpak 多种发行版包不推荐Mac 用户——官方标注 macOS 版本仍是实验性手柄暂不支持如果你的目标是电视玩 3A或平板玩独立游戏Sunshine 就是干这个的。接下来先用最短路径跑通一遍。⚡ 30 秒快速上手最短体验路径以 Windows 为例Linux 用户看注释即可替换。安装下载最新版本的 MSI 安装器双击运行按向导勾选需要的功能完成安装。Linux 用户下载对应发行版的.deb包执行sudo dpkg -i sunshine-发行版-版本-架构.deb。打开管理界面浏览器访问https://localhost:47990首次会要求你设置用户名和密码。验证信号看到欢迎页如 Sunshine 默认主题登录框可以输入你刚设置的账号。添加一台 Moonlight 客户端在电视、平板或手机上装 Moonlight点添加主机扫描或手动输入串流主机的 IP。验证信号Moonlight 弹出配对码输入框。配对在 Sunshine 主屏上按提示输入配对码然后从 Moonlight 启动任意一个应用。验证信号Moonlight 里出现你 PC 的桌面画面说明端到端已通。四步走完链路已经通了。但你可能想知道画面到底是怎么从显卡跑到电视上的 底层原理速览把 Sunshine 理解成一条屏幕快递线你的显卡把画面用 NVENCN 卡、AMFA 卡或 QuickSync核显这类硬件编码器压成 H.264/H.265 视频流——就像电视台发射信号而不是寄录像带编码在 GPU 上完成CPU 基本不干活。编码后的视频、音频、按键鼠标和手柄事件分别走几条 UDP 通道发出去。默认以47989为基准端口视频流占 47998、控制通道占 47999、音频流占 48000RTSP 握手在 48010 附近这些偏移量定义在 src/stream.h 和 src/rtsp.h 里。Moonlight 客户端负责另一头解码、渲染、把输入事件原路送回。管理侧则是一个内嵌的 Web 服务占47990端口你浏览器里看到的配置页、日志页、配对页都来自它。配置项以纯文本形式存在sunshine.conf里逐项说明见 docs/configuration.md。想深入源码三个入口够用src/video.cpp 负责编码与画面抓取src/rtsp.cpp 负责握手和会话管理src/platform/ 下按操作系统分目录放的是各平台的屏幕捕获和输入注入实现。原理讲完下面挑一种安装方式。 安装方式对比官方提供 4 种主要安装途径各有取舍方式适用平台优点限制建议谁选MSI 安装器WindowsWindows x64/ARM64自带服务和防火墙规则最省心仅 WindowsWindows 用户的默认选择发行版包deb/rpm/AppImage/FlatpakLinux直接调用系统 API支持 KMS 等全部捕获方式Flatpak 与 AppImage 不支持 KMS 捕获Linux 游戏主机优先发行版包HomebrewmacOS/Linux一条命令安装macOS 为实验性手柄不可用想在 Mac 上尝鲜的人Docker全平台环境隔离便于批量部署官方明确不建议大多数用户使用需要手工透传显卡和输入设备做隔离环境或自动化部署的运维默认推荐Windows 选 MSI 安装器Linux 选发行版专用包有 deb 就别用 AppImage有 rpm 就别用 Flatpak。macOS 目前只建议尝鲜。装好之后真正的配置都在 Web 界面里完成下面一步步来。 手把手配置确认服务在运行Linux 上执行systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 安装器已默认注册服务。确认成功终端里ss -ltn | grep 47990能看到该端口在监听。创建账号打开https://localhost:47990输入你第一次设置的用户名和密码。浏览器提示不安全属正常现象——它用的是自签名证书直接继续。确认成功进入欢迎页。添加应用进入 Apps 标签页把常玩的游戏或 Steam 本身加成桌面卡片每个卡片可填启动路径和准备工作命令。确认成功欢迎页出现对应的应用卡片。配对 Moonlight在 Moonlight 端添加主机并输入配对码。确认成功Moonlight 的应用列表里出现你在 Sunshine 建好的卡片。改配置可选不想翻菜单可以搜索配置页支持按关键字定位任意配置项比如直接搜bitrate。开始串流从 Moonlight 点开任意应用。确认成功几秒内出画面声音同步手柄按键有响应。配置到这一步就能用了。剩下的时间主要花在避坑上。❓ 避坑问答Q浏览器一直警告您的连接不是私密连接A正常。Sunshine 用自签名证书点高级 → 继续访问即可不影响安全。QMoonlight 搜不到主机 / 配对失败A先确认防火墙放行了 47989–48010 这个端口段再检查两边是否在同一网段跨路由器就先把 UPnP 关掉手动放行端口。QWindows 上手柄不响应A装 Sunshine 配套的虚拟 HID 驱动并重启电脑这是官方要求的输入链路缺它按键和手柄都进不去。Q有画面没声音A检查 Web UI 里的音频捕获设备Linux 对应audio_sink配置选对了没有选错设备是最高频原因。Q画面一顿一顿的A先把客户端改成有线网络再测还是卡就降分辨率或码率。无线环境下 5GHz 频段和信号强度比任何编码参数都重要。Q出问题去哪看日志A日志文件sunshine.log与sunshine.conf同目录Linux/macOS 在~/.config/sunshine/Windows 在%ProgramFiles%\Sunshine\configWeb UI 的故障排查页也能直接浏览。Q为什么不建议我用 DockerA官方文档原话是不适用于大多数用户——你需要手工透传/dev/dri、输入设备和音频省下的不多排查成本高。QN 卡用户看不到硬件编码A确认装的是最新官方驱动Linux 下捕获还依赖 CUDA/NVFBC发行版官方包已内置自己编译才需要额外处理。坑绕得差不多了接下来聊怎么把画质再往上抬一截。 进阶与生态调优三件事按收益排序网络客户端优先有线必须无线就 5GHz 以上频段、路由器距离拉近。这一项的收益大于任何编码参数。码率与分辨率在 Web UI 的 Audio/Video 页按屏幕调整——1080p60 大约 20–30 Mbps 起步4K 建议 50 Mbps 以上并配千兆有线。编码器按显卡选N 卡用 NVENC、A 卡用 AMF、核显用 QuickSync具体实现看 src/nvenc/ 目录。改参数前记住一点每改一项只测一项否则不知道是哪项起效。搭配清单Moonlight客户端全家桶覆盖 Windows、macOS、Linux、Android、iOS 和树莓派与 Sunshine 是固定搭档ViGEmBus / 虚拟 HID 驱动Windows 上的虚拟手柄底座docs/images/vigembus-installer.png 对应的就是这套系统包管理器Fedora/openSUSE 用户可直接走 COPR 仓库dnf copr enable lizardbyte/stable省去手动下载 rpm进阶文档构建与发布流程见 docs/building.md排障思路见 docs/troubleshooting.md✅ 行动清单下载安装器装好 Sunshine确认 47990 端口在监听打开https://localhost:47990创建账号忽略不安全警告添加 1–2 个常用游戏应用卡片在目标设备装 Moonlight完成配对并看一次完整画面把串流端设备接上线再试 10 分钟现在就去装吧——四步之后你的客厅电视就该有游戏画面了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Sunshine 游戏串流完整指南如何用 4 个步骤把 PC 变成本地串流主机【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费的开源游戏串流主机专为 Moonlight 客户端设计。它用你显卡的硬件编码能力把 PC 上的游戏画面和声音通过局域网推到电视、平板或笔记本上延迟低、画质好全程跑在你自己的网络里不花一分订阅费。下面这份指南带你从零开始装好、连上、玩起来。 它适合谁有一台游戏 PC 的人电脑放在书房想在客厅电视上玩有多块屏幕的家庭一台主机电视、平板、手机共享想省钱的串流玩家不想为云游戏按月付费数据还留在自己家Linux 用户官方提供 deb、rpm、AppImage、Flatpak 多种发行版包不推荐Mac 用户——官方标注 macOS 版本仍是实验性手柄暂不支持如果你的目标是电视玩 3A或平板玩独立游戏Sunshine 就是干这个的。接下来先用最短路径跑通一遍。⚡ 30 秒快速上手最短体验路径以 Windows 为例Linux 用户看注释即可替换。安装下载最新版本的 MSI 安装器双击运行按向导勾选需要的功能完成安装。Linux 用户下载对应发行版的.deb包执行sudo dpkg -i sunshine-发行版-版本-架构.deb。打开管理界面浏览器访问https://localhost:47990首次会要求你设置用户名和密码。验证信号看到欢迎页如 Sunshine 默认主题登录框可以输入你刚设置的账号。添加一台 Moonlight 客户端在电视、平板或手机上装 Moonlight点添加主机扫描或手动输入串流主机的 IP。验证信号Moonlight 弹出配对码输入框。配对在 Sunshine 主屏上按提示输入配对码然后从 Moonlight 启动任意一个应用。验证信号Moonlight 里出现你 PC 的桌面画面说明端到端已通。四步走完链路已经通了。但你可能想知道画面到底是怎么从显卡跑到电视上的 底层原理速览把 Sunshine 理解成一条屏幕快递线你的显卡把画面用 NVENCN 卡、AMFA 卡或 QuickSync核显这类硬件编码器压成 H.264/H.265 视频流——就像电视台发射信号而不是寄录像带编码在 GPU 上完成CPU 基本不干活。编码后的视频、音频、按键鼠标和手柄事件分别走几条 UDP 通道发出去。默认以47989为基准端口视频流占 47998、控制通道占 47999、音频流占 48000RTSP 握手在 48010 附近这些偏移量定义在 src/stream.h 和 src/rtsp.h 里。Moonlight 客户端负责另一头解码、渲染、把输入事件原路送回。管理侧则是一个内嵌的 Web 服务占47990端口你浏览器里看到的配置页、日志页、配对页都来自它。配置项以纯文本形式存在sunshine.conf里逐项说明见 docs/configuration.md。想深入源码三个入口够用src/video.cpp 负责编码与画面抓取src/rtsp.cpp 负责握手和会话管理src/platform/ 下按操作系统分目录放的是各平台的屏幕捕获和输入注入实现。原理讲完下面挑一种安装方式。 安装方式对比官方提供 4 种主要安装途径各有取舍方式适用平台优点限制建议谁选MSI 安装器WindowsWindows x64/ARM64自带服务和防火墙规则最省心仅 WindowsWindows 用户的默认选择发行版包deb/rpm/AppImage/FlatpakLinux直接调用系统 API支持 KMS 等全部捕获方式Flatpak 与 AppImage 不支持 KMS 捕获Linux 游戏主机优先发行版包HomebrewmacOS/Linux一条命令安装macOS 为实验性手柄不可用想在 Mac 上尝鲜的人Docker全平台环境隔离便于批量部署官方明确不建议大多数用户使用需要手工透传显卡和输入设备做隔离环境或自动化部署的运维默认推荐Windows 选 MSI 安装器Linux 选发行版专用包有 deb 就别用 AppImage有 rpm 就别用 Flatpak。macOS 目前只建议尝鲜。装好之后真正的配置都在 Web 界面里完成下面一步步来。 手把手配置确认服务在运行Linux 上执行systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 安装器已默认注册服务。确认成功终端里ss -ltn | grep 47990能看到该端口在监听。创建账号打开https://localhost:47990输入你第一次设置的用户名和密码。浏览器提示不安全属正常现象——它用的是自签名证书直接继续。确认成功进入欢迎页。添加应用进入 Apps 标签页把常玩的游戏或 Steam 本身加成桌面卡片每个卡片可填启动路径和准备工作命令。确认成功欢迎页出现对应的应用卡片。配对 Moonlight在 Moonlight 端添加主机并输入配对码。确认成功Moonlight 的应用列表里出现你在 Sunshine 建好的卡片。改配置可选不想翻菜单可以搜索配置页支持按关键字定位任意配置项比如直接搜bitrate。开始串流从 Moonlight 点开任意应用。确认成功几秒内出画面声音同步手柄按键有响应。配置到这一步就能用了。剩下的时间主要花在避坑上。❓ 避坑问答Q浏览器一直警告您的连接不是私密连接A正常。Sunshine 用自签名证书点高级 → 继续访问即可不影响安全。QMoonlight 搜不到主机 / 配对失败A先确认防火墙放行了 47989–48010 这个端口段再检查两边是否在同一网段跨路由器就先把 UPnP 关掉手动放行端口。QWindows 上手柄不响应A装 Sunshine 配套的虚拟 HID 驱动并重启电脑这是官方要求的输入链路缺它按键和手柄都进不去。Q有画面没声音A检查 Web UI 里的音频捕获设备Linux 对应audio_sink配置选对了没有选错设备是最高频原因。Q画面一顿一顿的A先把客户端改成有线网络再测还是卡就降分辨率或码率。无线环境下 5GHz 频段和信号强度比任何编码参数都重要。Q出问题去哪看日志A日志文件sunshine.log与sunshine.conf同目录Linux/macOS 在~/.config/sunshine/Windows 在%ProgramFiles%\Sunshine\configWeb UI 的故障排查页也能直接浏览。Q为什么不建议我用 DockerA官方文档原话是不适用于大多数用户——你需要手工透传/dev/dri、输入设备和音频省下的不多排查成本高。QN 卡用户看不到硬件编码A确认装的是最新官方驱动Linux 下捕获还依赖 CUDA/NVFBC发行版官方包已内置自己编译才需要额外处理。坑绕得差不多了接下来聊怎么把画质再往上抬一截。 进阶与生态调优三件事按收益排序网络客户端优先有线必须无线就 5GHz 以上频段、路由器距离拉近。这一项的收益大于任何编码参数。码率与分辨率在 Web UI 的 Audio/Video 页按屏幕调整——1080p60 大约 20–30 Mbps 起步4K 建议 50 Mbps 以上并配千兆有线。编码器按显卡选N 卡用 NVENC、A 卡用 AMF、核显用 QuickSync具体实现看 src/nvenc/ 目录。改参数前记住一点每改一项只测一项否则不知道是哪项起效。搭配清单Moonlight客户端全家桶覆盖 Windows、macOS、Linux、Android、iOS 和树莓派与 Sunshine 是固定搭档ViGEmBus / 虚拟 HID 驱动Windows 上的虚拟手柄底座docs/images/vigembus-installer.png 对应的就是这套系统包管理器Fedora/openSUSE 用户可直接走 COPR 仓库dnf copr enable lizardbyte/stable省去手动下载 rpm进阶文档构建与发布流程见 docs/building.md排障思路见 docs/troubleshooting.md✅ 行动清单下载安装器装好 Sunshine确认 47990 端口在监听打开https://localhost:47990创建账号忽略不安全警告添加 1–2 个常用游戏应用卡片在目标设备装 Moonlight完成配对并看一次完整画面把串流端设备接上线再试 10 分钟现在就去装吧——四步之后你的客厅电视就该有游戏画面了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
