Sunshine游戏串流新手完整指南从零到卧室畅玩只需6步【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款开源自托管的游戏串流服务端Self-hosted game stream host专为 Moonlight 客户端设计能把书房主机的画面以极低延迟送到客厅电视、笔记本、平板甚至手机上。本文用 6 个可复现的步骤带你完成从安装、配对到添加第一个游戏应用的完整流程并附上新手最容易踩的坑和一份上线前自检清单全程免费、无需任何订阅。从客厅被占到随便在哪玩先讲一个真实场景周末晚上想在大电视上玩刚买的 3A 大作但电视正被家人看剧台式机又在书房总不能把整台主机搬来搬去。朋友的解决办法很简单主机留在书房不动在客厅放一台小盒子装 Moonlight书房跑 Sunshine 负责推流画面和声音就隔空到了大屏上。你只需要坐在沙发里握着手柄输入一次配对码之后每次想玩点一下就行。这个场景就是 Sunshine 最常见的用途把高性能主机变成一台私人游戏云主机家里任何屏幕都能随时调用它。30秒理解分工Sunshine 和 Moonlight 各自扮演什么角色一句话Moonlight 是播放端Sunshine 是推流端。Sunshine 运行在你放游戏的那台主机上负责采集画面、编码、发送并在收到指令时帮你启动游戏、调整分辨率。Moonlight 运行在你想用来玩的设备上负责解码画面、回传手柄和键鼠输入。两者通过局域网或互联网握手配对配对成功后彼此记住对方之后连接基本就是点一下的事。打个比方Sunshine 是电视台Moonlight 是你手里的遥控器加屏幕。整个链路完全自托管数据不出你的设备也不依赖任何云厂商。开跑前先备齐这几样东西类别要求说明推流主机带独立显卡的 Windows / Linux / macOS 主机NVIDIA、AMD、Intel 均可Sunshine 会按平台自动选择编码方案客户端设备手机、平板、笔记本、电视盒子等装 Moonlight 客户端即可性能要求很低网络家庭路由器 有线或 5G Wi-Fi首次配置建议在同一局域网内进行可选手柄、键盘鼠标手柄走虚拟手柄通道键鼠走系统输入注入如果你是 Windows 用户最好先把显卡驱动更新到较新版本Linux 用户建议优先用发行版自带的软件包或官方提供的 deb/rpm 包比通用 AppImage 更省心AppImage 不支持 KMS 采集功能上有取舍。第1步安装并启动服务端三平台速览Sunshine 官方为 FreeBSD、Linux、macOS、Windows 都提供了现成安装包安装方式和普通软件没有区别平台常见安装方式Windows下载安装包双击安装之后在开始菜单启动Ubuntu / Debiansudo apt install ./sunshine-ubuntu-24.04-*.debFedora / openSUSE通过 COPR 仓库安装或用 rpm 包macOS下载 pkg 包安装在启动台启动Archsudo pacman -U sunshine.pkg.tar.zst启动成功后服务默认监听47989HTTP和47990Web UI两个端口。如果不想用现成包、希望从源码构建也可以拉取项目仓库自行编译git clone https://gitcode.com/GitHub_Trending/su/Sunshine编译依赖较多新手建议先用现成安装包跑通流程源码构建留到想折腾时再说。第2步首次打开 Web UI创建你的管理账号浏览器访问https://localhost:47990首次访问会有自签名证书提示选择继续即可。第一次进入会看到欢迎页面需要你创建一组用于管理界面的用户名和密码默认用户名是sunshine密码由你自己设置。这组凭据请务必记牢因为之后改端口、改网络、加应用全都要靠它登录。如果哪天忘了可以在系统托盘里找到 Sunshine 图标重置或者删除配置文件后重新初始化。第3步用10分钟把基础设置过一遍登录后进入配置页。页面顶部有搜索框输入关键词就能快速定位设置项对新手非常友好例如搜Upnp就能直接跳到端口转发相关选项。配置页的标签页很多新手只需关注三个重点密码安全确认刚才的账号密码已生效并建议开启强制使用密码相关选项避免局域网内被他人随意连接。网络Network如果打算跨网络串流比如在公司连家里的主机开启 UPnP 让路由器自动做端口转发只在家用则不必开。音频/视频Audio/Video把编码器、分辨率和帧率上限按显卡能力设置好例如 NVIDIA 卡优先用 NVENC画质和延迟平衡最好。其余标签页如高级、编码器专属参数保持默认即可等玩熟了再慢慢调。第4步在另一台设备上装 Moonlight 并完成配对Sunshine 的精选应用Featured Apps页面会直接列出官方推荐的 Moonlight 客户端入口包括 Windows、macOS、Linux、Android、iOS 等版本按你的实际设备选择下载即可。配对流程非常简单在客户端设备上打开 Moonlight它会自动发现局域网里的 Sunshine 主机。点击主机名客户端会弹出 4 位 PIN 码。回到 Sunshine Web UI 的 PIN 页面输入这 4 位数字配对即完成。配对成功后客户端里就能看到这台主机了下次连接不再需要输入 PIN。如果客户端没自动发现主机检查两台设备是否在同一网段、防火墙是否放行了47989和47990端口。第5步添加你的第一个应用不只游戏配对完成后客户端里默认会有一个桌面Desktop入口点击它你就能直接串流整个主机桌面。但更常见的使用方式是把单个游戏或程序注册为应用这样客户端界面里每个应用一张卡片点一下就直达不用先进桌面再手动找图标。在 Web UI 的 Applications 页面点击Add New就会看到应用配置表单。配置一个应用核心要回答一个问题这个程序怎么启动常见有三种方式启动方式适用场景说明Command直接命令普通游戏、浏览器、模拟器直接执行指定可执行文件Detached分离命令Steam、Epic 等启动器类程序程序启动后立即放走不等待它退出URI协议链接走平台协议的启动方式如steam://、com.epicgames.launcher://比如注册一个 Steam 大屏模式入口最稳妥的做法是用分离命令加协议链接{ name: Steam 大屏模式, detached: [steam://open/bigpicture], image-path: steam.png }再比如想在客厅躺着刷网页视频可以把浏览器注册成一个应用{ name: 卧室观影模式, cmd: \C:\\Program Files\\Mozilla Firefox\\firefox.exe\, working-dir: C:\\Program Files\\Mozilla Firefox }表单里还有两个值得留意的字段Image用于给应用配封面图填desktop.png、steam.png这类项目内置图片即可Output可以把应用的运行日志上传到 Sunshine排查启动失败时非常有用。更完整的跨平台配置示例可以查阅项目内的docs/app_examples.md。进阶玩法用预备命令让分辨率跟着客户端走串流最常见的问题之一是客户端屏幕比例和主机桌面不一致导致画面变形或留黑边。Sunshine 的预备命令prep-cmd就是为此准备的串流开始时执行 Do 命令串流结束时执行 Undo 命令把分辨率临时切到客户端请求的值退出后再恢复。比如在 Wayland 桌面环境下可以这样配置prep-cmd: [ { do: sh -c \wlr-xrandr --output DP-1 --mode ${SUNSHINE_CLIENT_WIDTH}x${SUNSHINE_CLIENT_HEIGHT}${SUNSHINE_CLIENT_FPS}Hz\, undo: wlr-xrandr --output DP-1 --mode 3840x2160120Hz } ]这里的${SUNSHINE_CLIENT_WIDTH}等变量由 Sunshine 在会话启动时注入代表客户端实际请求的宽、高和帧率不用手写死。另一个实用小技巧串流时本机关闭显示器用xset dpms force off关屏、串流结束用xset dpms force on恢复能省电也避免画面串扰。常用环境变量速查如下环境变量含义SUNSHINE_CLIENT_WIDTH/HEIGHT客户端请求的画面宽高SUNSHINE_CLIENT_FPS客户端请求的帧率SUNSHINE_CLIENT_HDR客户端是否启用 HDRtrue/falseSUNSHINE_CLIENT_AUDIO_CONFIGURATION音频通道配置2.0 / 5.1 / 7.1SUNSHINE_APP_NAME/SUNSHINE_APP_ID当前应用的名字与唯一标识这些变量的详细说明在docs/configuration.md里都有写预备命令前先查一眼能少走很多弯路。新手最容易踩的 5 个坑误区正确做法应用一启动串流就立刻结束对 Steam 这类会自动重启自身的程序改用 Detached 分离命令而不是直接等待进程退出Windows 下手柄完全没反应在 Troubleshooting 页面安装 ViGEmBus 虚拟手柄驱动没装它手柄通道是空的画面黑屏或花屏先看 Troubleshooting 里的日志确认编码器是否加载成功常见原因如显卡驱动过旧、编码器被占用分辨率不对、画面拉变形用预备命令按客户端参数临时切换分辨率不要依赖默认桌面设置直接用默认密码裸奔首次登录必须改密码跨网络串流再配合 UPnP 时尤其要注意其中两个排查入口强烈建议新手记下来Web UI 的Troubleshooting故障排除页面会实时展示推流日志编码器报错、权限不足都会记录在这里。而 Windows 用户的手柄问题基本都能在 Troubleshooting 页面的 ViGEmBus 一项里一键解决。上线前的最后自检清单在正式投用之前花五分钟对着这份清单过一遍能避免绝大多数怎么连不上的尴尬服务端已启动https://localhost:47990能正常打开默认密码已更换凭据已妥善保存至少一个客户端完成 PIN 配对桌面入口测试串流成功画面、声音、鼠标都正常手柄测试通过Windows 用户确认 ViGEmBus 已安装关键游戏应用已添加并用 Detached/URI 方式做过一次完整启动测试若跨网络串流UPnP 或手动端口转发已配置下一步把这篇指南变成你的第一场串流现在就去干一件具体的事在 Applications 页面添加你的第一款游戏然后用客户端点开它。成功的那一瞬间你会觉得前面所有步骤都值得。串流跑通之后再慢慢研究预备命令、多客户端、HDR 这些进阶能力——它们都藏在 Web UI 的配置页和项目文档如docs/app_examples.md、docs/configuration.md里随用随查。记住Sunshine 的价值不在于配置多复杂而在于它把主机在哪和想在哪玩彻底解耦。从今晚开始你的游戏不再被锁在书房里。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考