免费自建游戏串流服务器：Sunshine完整上手指南，把PC游戏搬到任何屏幕
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款免费开源的游戏串流服务器，它能把书房那台 PC 上的游戏画面，以极低延迟送到客厅电视、平板或手机屏幕上。这篇指南写给想省下云游戏会员费、又不想被复杂配置劝退的玩家，从原理讲到调优，带你一步步把属于自己的串流平台跑起来。
为什么别人的串流又卡又糊？先搞懂这四步流水线
说句实在话，很多人玩串流翻车，不是设备不行，而是压根不清楚背后发生了什么。串流本质上很像"远程桌面"和"直播"的结合体，整个流程就四步：
- 游戏在主机上运行：算力都在你那台 PC 上，客户端只是"观众"；
- 画面交给编码器压缩：把一帧帧画面压成数据流，这是延迟高低的关键；
- 数据走网络传输：局域网内跑，速度快、隐私好；
- 客户端解码并回传输入：你按手柄，指令瞬间传回主机。
把每一步想明白了，后面调参时你就知道该动哪里。编码这一步尤其重要，它有两种路线，差别很大：
| 编码方式 | 靠谁干活 | 延迟 | 画质上限 | 适合谁 |
|---|---|---|---|---|
| 硬件编码 | 显卡内置编码器 | 极低 | 高 | 绝大多数玩家，首选 |
| 软件编码 | CPU 计算 | 较高 | 视 CPU 而定 | 老显卡、应急兜底 |
硬件编码的实现分散在项目里，想看细节可以翻一翻核心源码：src/nvenc/（NVIDIA 相关）和 src/platform/（各平台的图形与编码接入）。
动手之前：四项自查清单，避免白忙一场
别急着下载安装，先花两分钟核对下面四件事，能帮你省掉后面一大堆麻烦。
- 显卡：NVIDIA（NVENC）、AMD（AMF）、Intel（QuickSync）都行，越新越好；没有独显也能跑，只是走软件编码，别指望 4K 高帧率。
- 网络：有线网线永远是最优解；无线至少要 5GHz，尽量靠近路由器。
- 操作系统：Windows、Linux、macOS、FreeBSD 都支持，选你手头最熟的即可。
- 客户端设备：手机、平板、笔记本、电视盒子都行，只要装得上 Moonlight 客户端。
如果家里是"千兆路由 + 有线连接主机"，那恭喜你，起步条件已经很理想了，接下来放心往下走。
四条安装路线，挑一条最顺手的
Sunshine 的安装方式多到让人选择困难，这里按上手难度给你排个序：
Windows 用户，最省事的就是装个客户端包，双击下一步就行；习惯命令行的话，用包管理器一条命令搞定：
winget install LizardByte.SunshineLinux 用户，推荐 Flatpak，隔离干净、更新省心：
flatpak install flathub dev.lizardbyte.app.SunshinemacOS 用户，Homebrew 一行命令：
brew install sunshineDocker 用户，官方镜像开箱即用：
docker pull lizardbyte/sunshine想研究源码、参与编译的玩家，可以拉取官方仓库自行构建：
git clone https://gitcode.com/GitHub_Trending/su/Sunshine官方文档：docs/building.md 里写了各平台的编译依赖和步骤，照着做基本不会卡壳。
打开 Web 管理页后，前五分钟应该做什么
安装完成，浏览器输入http://localhost:47990，你会看到欢迎界面。别被英文界面吓到，核心操作就一件事：设置访问凭证。
这里划三个重点，错过任何一个都可能让你重来一遍：
- 默认用户名是
sunshine，第一次登录会让你设置密码； - 密码一定要记牢，界面会明确提示凭证不会再次显示，丢了只能重置；
- 顺手确认防火墙放行了
47990端口，不然客户端永远找不到服务器。
设置完凭证，你就正式拥有自己的串流服务器了。剩下的操作，几乎都能在同一个 Web 面板里完成，不用再碰命令行。
把游戏"登记"进服务器：三分钟学会应用管理
Sunshine 不会自动知道你装了哪些游戏，你得手动把它们"登记"进应用列表。听起来麻烦，实际点几下就完事。
打开 Web 面板的 Applications 页面，你会看到默认自带两个应用卡片：桌面（DESKTOP）和 Steam 大屏模式，点击 Add New 就能添加自己的游戏。
添加应用的关键就两个字段：
- 名称：随便起，客户端里显示的就是它；
- 启动命令：填游戏的可执行文件路径，或者 Steam 的快捷协议，比如
steam://open/bigpicture。
想配得更细？不同应用可以设置独立的启动参数、工作目录甚至运行前的准备脚本。官方文档：docs/app_examples.md 收集了不少现成模板，参考着抄就行。
画质与流畅度的三个旋钮：分辨率、码率、帧率
串流体验好不好，说到底就是在这三个参数之间找平衡。它们互相牵制：分辨率要画面，码率要带宽，帧率要流畅，网不够快时就只能舍一保二。
| 使用场景 | 推荐分辨率 | 推荐码率 | 目标帧率 |
|---|---|---|---|
| 手机、平板便携游玩 | 1080p | 10–20 Mbps | 60 fps |
| 客厅电视 3A 大作 | 4K | 40–80 Mbps | 60 fps |
| 高刷电竞屏 | 1440p | 25–50 Mbps | 120 fps |
几点实操建议：
- 码率宁高勿低，带宽够就尽量给足，画面细节和流畅度都更稳；
- 显卡驱动更新到最新版，编码器 bug 修复大多藏在驱动更新里；
- 支持 HDR 的显示器和游戏，记得在面板里开启 HDR，视觉提升非常明显；
- 网络波动明显时，优先降分辨率而不是硬扛高码率。
连不上、卡顿、掉帧？按这份清单逐项排除
串流出问题，九成是网络或配置，别急着怀疑软件坏了。按下面顺序排查，效率最高：
- 客户端找不到服务器：先确认两台设备在同一个局域网；再检查防火墙是否放行
47990端口；最后重启服务端和路由器试试。 - 画面卡顿、延迟高：看看是不是在用 2.4GHz WiFi，换 5GHz；关闭其他占带宽的下载任务；有线连接永远优先。
- 画质模糊、马赛克：码率给太低，把码率往上调一档；或者网络质量波动大，改为有线连接。
- 手柄没反应：先检查客户端设备是否识别到手柄，再确认按键映射是否被改过。
这四项检查完，绝大多数问题都能解决。真遇到解决不了的，往下看日志。
学会看日志，你的排查效率直接翻倍
日志是 Sunshine 留给你的"黑匣子"，里面记录了每一次启动、每一条报错。别嫌它长，会看日志的人，半小时能解决的问题，比瞎猜一晚上都强。
先找到日志文件：
| 系统 | 日志位置 |
|---|---|
| Windows | %ProgramFiles%\Sunshine\config\sunshine.log |
| Linux / macOS | ~/.config/sunshine/sunshine.log |
| Docker | docker logs sunshine |
看日志时记住三步：
- 找红色报错行，那是问题根源的线索；
- 看设备信息区，确认编码器、分辨率是否被正确识别；
- 带着日志去搜，把报错关键词复制下来，通常能直接命中答案。
比如日志里出现 "encoder not found" 之类的提示，基本就是编码器没加载成功，优先排查显卡驱动和硬件支持，方向就对了。
安全与日常维护：四条不起眼但重要的建议
服务器架好了，别忘了它也是暴露在局域网里的一台设备，维护习惯决定你能省多少心。
- 密码用强的：别用生日、123456 这种，串流服务器被外人登录，等于把整台 PC 交出去；
- 定期更新：Sunshine 和显卡驱动都保持最新，安全修复和性能优化往往一起到；
- 按需开关 UPnP：面板里能找到 UPnP 选项，它自动配置端口转发，家用够用；追求严谨就手动在路由器上做端口映射；
- 别长期闲置不关：不玩的时候关掉串流服务，减少暴露面，也省点电。
想深入调整的朋友，Web 面板的 Configuration 页面支持关键词搜索，输入想找的设置名就能直接跳转，不用在几十个选项里翻来翻去。官方文档：docs/configuration.md 对每个选项都有详细解释。
从今天开始的行动路线图
聊了这么多，总结下来其实就是五步，照着做，今晚就能玩上：
- 选安装方式：按你的系统，执行上面四条路线中对应的一条；
- 完成首登：打开
localhost:47990，设置并牢记密码； - 登记游戏：在 Applications 页面添加想串流的游戏；
- 装客户端：在手机、平板或另一台电脑上安装 Moonlight，登录并连接；
- 微调画质：按上面的参数表，把分辨率、码率和帧率调到舒服的组合。
还有几个值得收藏的资源，遇到问题随时翻：
- 配置详解：docs/configuration.md
- 性能调优：docs/performance_tuning.md
- 排错手册：docs/troubleshooting.md
- 应用示例：docs/app_examples.md
串流这件事，门槛远没有想象中高。Sunshine 把最复杂的部分都封装好了，你只需要花一顿饭的工夫完成配置，之后就能在任何一块屏幕上，随时接着玩你的游戏。现在就去试试吧。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
