Sunshine 游戏串流服务器：从安装到首次串流的免费完整教程-平芜编程栈

Sunshine 游戏串流服务器：从安装到首次串流的免费完整教程

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

周末刚过半，你想用手柄接着打书房电脑上的 3A 大作，可显示器在另一个房间；或者加班回来，只想把游戏切到客厅电视上继续。这种"把自家电脑里的游戏搬到另一块屏幕"的需求，不用花钱订阅云游戏——一个叫 Sunshine 的免费游戏串流服务器就能搞定，客户端再配上 Moonlight，无需注册任何账号，数据全部留在自己手里。

这个游戏串流服务器到底在做什么

串流的两个角色分工非常清晰：

角色	软件	运行位置	职责
宿主端	Sunshine	装有游戏的电脑	接收远端输入，采集画面与声音，实时编码推流
客户端	Moonlight	手机、平板、电视盒子、另一台电脑	显示画面，回传手柄与键鼠操作

说白了就是接力：你的操作指令传到宿主电脑，Sunshine 把游戏画面编码后回传给客户端，一来一回的延迟被压得很低，体验接近本地游玩。

它适合手里有一台中高端电脑、想在多台设备上免费玩游戏的人；如果你没有闲置主机，或需要远程操控别人的机器，那它帮不上你。

动手前的 5 分钟自检

上手之前花 5 分钟核对一下环境，能省掉后面大部分弯路：

宿主系统是 Windows 10/11、主流 Linux 发行版或 macOS —— 三个平台都官方支持，版本决定你走哪条安装路线
最好有一台带独立显卡的电脑 —— 硬件编码比软编稳定得多，NVIDIA、AMD、Intel 都有对应方案
电脑和客户端设备在同一张网络里 —— 局域网内直接就能串，不需要理解复杂网络概念
有一台能装 Moonlight 的客户端设备 —— 电脑、安卓/iOS 手机、电视盒子、树莓派都行
不需要注册任何云服务 —— 仅首次登录 Web 界面时创建本地管理账号即可

五项都打勾，就可以开工了。

分平台落地：3 条路径装好游戏串流服务器

按宿主系统选一条路线走，每条花不了三分钟。

Windows：装个安装包，2 分钟完事

打开项目官方发布页面，下载最新的 Windows 安装程序。双击运行，跟着向导一路到底，安装完成后程序自动启动，并在系统托盘留下常驻图标。

这一步做完，你就得到了一个开箱即用的串流服务器，全程无需手动配置。

Linux：一条命令完成构建安装

先确认系统里装了git和基础编译工具，然后依次执行：

# 克隆 Sunshine 源码仓库 git clone https://gitcode.com/GitHub_Trending/su/Sunshine

# 进入项目目录，运行官方构建脚本，自动处理依赖并完成安装 cd Sunshine && ./scripts/linux_build.sh

脚本会拉取并编译若干第三方依赖，首次运行耗时较长属正常现象，放着让它跑就行。完成后 Sunshine 会以系统后台服务的形式装好，开机自动待命。

macOS：Homebrew 一行命令

如果还没装过 Homebrew，先按其官网说明装好，然后执行：

# 用 Homebrew 一行命令安装 Sunshine brew install sunshine

这一步做完，Sunshine 已经注册进系统，从应用列表里打开就能用。

从零完成关键配置：按优先级做 4 步

现在配好一次，后面基本不用再动，推荐顺序是账号、网络、应用、画质，不用在界面里乱翻。

第 1 步：创建管理账号

浏览器访问http://localhost:47990，首次打开是欢迎页。依次填写用户名、密码并再次确认密码，然后点击登录。这组凭据是日后管理串流服务器的唯一入口，务必记牢。

第 2 步：网络与端口

同一局域网内使用，默认配置即可直接串流。想在外网玩的话：进入 "Configuration" 页面，在搜索框输入"Upnp"，到 "Network" 选项卡下勾选"UPnP" 开关，再点击底部 "Save"，让路由器自动完成端口转发。

第 3 步：登记可串流的应用

你想串的游戏要以"应用"形式登记在 Sunshine 里：点击顶部 "Applications" 选项卡，点击左下角 "Add New" 按钮，输入应用名称和可执行文件的完整路径，点击"Save"。页面默认预置了 "Desktop"（桌面）和 "Steam Big Picture"，可直接使用；注意页面提示应用列表要在客户端重启后才刷新，加完记得重启一次客户端。

第 4 步：画质与编码

按显卡品牌选编码器：NVIDIA 用户选 NVENC，AMD 与 Intel 同样有硬件编码支持
有线网络下码率、分辨率可以拉高；无线环境先保守设置，再逐步上调找平衡点
帧率与显示器刷新率对齐，高刷屏设备可开启更高帧率串流

Moonlight 首次联机：从打开客户端到画面出现

Web 界面的 "Featured Apps" 页面列出了官方适配各平台的客户端：Windows/macOS/Linux 桌面版、安卓版，以及面向树莓派等嵌入式 Linux 的版本，点击"Get" 即可跳转下载。

装好客户端后，完整流程是这样：

确认客户端设备与宿主电脑在同一张网络里
打开Moonlight，局域网内的 Sunshine 主机会被自动发现
在 Sunshine Web 界面的 PIN 选项卡查看 4 位配对码，输入到客户端完成配对
配对成功后，客户端列出所有可串流应用，点选要玩的那一个
按下开始，画面推送到你手里的设备

一次配对、长期有效，之后每次打开客户端都能直接进入游戏。

高频翻车场景急救手册

串流总有小状况，这五个症状覆盖了绝大多数日常翻车：

客户端发现不了主机→ 多半是两台设备不在同一网络，或防火墙拦截 → 检查网络连接，在系统防火墙中放行 Sunshine 相关端口（Web 管理端口47990、串流数据端口47998–48000等）
画面卡顿、模糊→ 码率超出实际带宽 → 先改走有线，再适当调低码率或分辨率
黑屏或启动失败→ 显卡驱动或编码器状态异常 → 更新显卡驱动，并在日志里看具体报错
手柄 / 键鼠无响应→ 输入设备未在客户端被识别 → 重新识别输入设备，检查宿主机输入相关配置
内网能连、外网不行→ 端口转发没生效 → 确认 UPnP 开关已打开，并查看路由器的 NAT 转发表

所有问题都有一个统一出口：Web 界面提供了完整的日志查看入口，遇到报错就截图留存。

去社区求助时，截图加上含错误信息的日志片段，比一句"我用不了"高效得多。