Sunshine游戏串流服务器教程：让主机随叫随到
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
想想这个场景：晚上窝在沙发上，白天没打完的那局还停在存档里等你。Sunshine 是一个完全开源免费的游戏串流服务器，专为 Moonlight 客户端（免费的接收端，装在手机、平板、电视上）打造，Windows、Linux、macOS 全平台支持。它把电脑画面实时压成视频流发到任意屏幕，数据全程不出你自己的设备。读完这篇，你能独立完成安装、配对、加应用和日常调优。
一、三十秒看懂串流链路：画面怎么一路跑到你屏幕上
整条链路能压缩成四个动词：
抓屏 → 压流 → 送流 → 回传。
- 抓屏：从系统级接口把桌面帧实时截下来（Windows 走 DXGI，Linux 走 KMS/DRM 或 Wayland，macOS 用原生捕获框架）；
- 压流：交给显卡上的硬件编码器，压成 H.264 / HEVC / AV1，音频一起打包；
- 送流：走优化过的网络协议，把视频和你的输入指令双向传递；
- 回传：你在 Moonlight 上的键鼠、手柄操作原路送回主机。
瓶颈只藏在两处：编码环节定延迟，网络环境定清晰度，后面所有调优都绕不开这两个词。想抠实现细节，src/video.cpp 和 src/nvenc/ 是编码相关的核心模块。
二、Sunshine安装方法对比：三条路按省心程度排队
包管理器装：依赖服务全托管
Ubuntu、Debian、Arch 用户一条命令完事，依赖解析和服务注册都替你办妥：
sudo apt-get update && sudo apt-get install sunshineWindows 和 macOS 直接下官方安装包一路下一步。更多安装细节见 docs/getting_started.md。
源码编译装：想尝鲜最新功能选它
爱折腾的朋友适合这条路，clone 下来用 CMake 构建即可：
git clone --recurse-submodules https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine && mkdir build && cd build cmake .. && make -j$(nproc) sudo make install各平台完整依赖清单在 docs/building.md。
Docker容器装：主机环境零污染
想卸载无残留、配置随目录一起搬？容器化最干净（端口与挂载细节以 DOCKER_README.md 为准）：
docker run -d --name=sunshine \ -p 47984-47990:47984-47990/tcp \ -p 48010:48010 \ -v /path/to/config:/config \ lizardbyte/sunshine:latest三条路殊途同归：服务跑起来、浏览器打开 47990 端口，就算正式开工。
三、Sunshine首次运行步骤：从建账户到设备配对
浏览器输入http://localhost:47990（47990 是 Web 管理端的默认端口），你会看到欢迎页：
- 建管理员账户：首次访问会让你设用户名和密码，这是 Web 端的访问凭证，建议强密码——它也是配对安全的一环；
- Moonlight 里配对：在手机或电脑打开 Moonlight，同一局域网内主机一般自动被发现，选择"配对"，把屏幕上弹出的四位 PIN 码填进客户端，双向互认完成，主机上的应用列表同步出现在客户端里；
- 确认服务常驻：如果客户端迟迟发现不了主机，先回主机确认 Sunshine 服务还在跑。
配对成功的标志是客户端里出现了主机的应用列表，这一步之后只剩加应用。
四、给串流列表加游戏：Applications页面三步配置
默认列表通常只有 Desktop（桌面串流）和 Steam Big Picture。想加自己的游戏，进"Applications"页面点"Add New"：
- 名称：随手起，客户端上显示什么由它决定；
- 可执行文件路径：填游戏启动文件的绝对路径；
- 启动参数：有需要再填，没有就留空。
列表只在客户端重启时刷新，配完记得重启 Moonlight，新游戏才会露面。
五、Sunshine编码器选择指南：显卡、画质与延迟怎么平衡
Sunshine 会自动识别你的显卡并挑对应的硬件编码器，大致对照如下：
| 显卡 | Windows | Linux | macOS |
|---|---|---|---|
| NVIDIA | NVENC | NVENC（走 CUDA） | 软件编码 |
| AMD | AMF | VAAPI / Vulkan Video | 软件编码 |
| Intel | Quick Sync | VAAPI | Video Toolbox |
没有硬件编码可用时会自动退回软件编码兜底，功能不缺，只是 CPU 占用实打实地上去。
具体参数不用翻菜单，Configuration 页面直接搜关键词，比一层层找快得多：
三条口语化建议：
- 分辨率和帧率先看客户端屏幕的规格——小屏硬开 4K 是白费劲；竞速、射击保帧率，剧情向保分辨率；
- 比特率先由带宽定——有线局域网可以往 30Mbps 以上给，无线或远程就降一档，防花屏；
- 预设跟着玩法走——竞技选低延迟，观影选高质量。
别背参数表，拿一局实战的手感当验收标准，改完就跑一局试试。全部配置项可查 docs/configuration.md。
六、局域网与远程串流配置：两种场景各改三处
本地玩法（主打零延迟）
- 主机插网线，客户端连 5GHz 频段；
- 在配置里开启"仅本地网络"相关开关（具体配置项以当前版本为准），端口不暴露公网，安全省心；
- 同一 WiFi 下先试默认参数，别一上来就动比特率。
远程玩法（主打随时随地）
- 路由器开启 UPnP 自动转发（配置页里就有
upnp开关）； - 启用 TLS 加密，公网传输的数据全程密文；
- 家里是动态 IP 的话，挂一个动态 DNS 服务，IP 怎么变都能找回家。
远程场景建议降分辨率、降比特率换稳定，公网的延迟和抖动远高于局域网。本地图快、远程图稳，两个场景的配置方向正好相反，别用同一套参数两边凑合。
七、Sunshine常见问题速查：五个高频坑的问与答
客户端死活找不到主机？确认主机服务在跑、两端同一局域网、47984-47990 端口没被防火墙拦。最稳的办法是手动填主机 IP，别指望自动发现。
画面一直卡顿、马赛克？三个方向依次查：网络稳不稳（有线优先）；比特率是不是给高了（降一档试试）；显卡驱动是不是太旧（硬件编码器很吃驱动版本）。
有画面没声音？看主机上有没有程序独占音频设备，换个输出设备试试，再确认系统默认播放设备没被静音。
操作不跟手、输入延迟高？无线外设的省电模式是头号嫌疑，其次看客户端设备性能够不够，最后关掉后台下载和视频播放这类吃带宽的应用。
编码器报错、日志一片红？打开管理端"Logs"页面，Sunshine 会把日志传上来，错误通常写得很明白：
八成问题，日志里都直接写了答案，翻日志永远排在猜原因前面。
八、行动清单：四步把这套串流跑通
- 挑一种安装方式，把 Sunshine 服务跑起来；
- 手机或平板装上 Moonlight，走完 PIN 码配对；
- 加进两三个真会玩的游戏，从桌面串流开始体验；
- 局域网、远程各测一轮，按手感微调参数。
Web 端的"Featured Apps"页面还列着各平台官方推荐的 Moonlight 客户端，装客户端时顺手就能拿到。
与其把主机锁在书桌前，不如让它追着沙发跑——以后是画面来找你，不是你去找机箱。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
