Sunshine 新手教程：把游戏串流到家里任意一块屏幕
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一台自托管的游戏串流服务器，装进电脑后，电视、手机、平板就能通过 Moonlight 客户端收到这台机器的画面和输入，就像把整机搬到了那块屏幕前。跑通之后你手里多了一台随时待命的串流主机，外加一个位于https://localhost:47990的网页管理页，管应用、管参数都在上面。本文从安装一直走到第一次投屏成功，最后留给你一张调参表和一份排障速查。
先定个场景：三种串流环境挑一种
参数怎么调，取决于你和客户端之间的网络条件，先对号入座。
- ① 🎮有线局域网：主机和客户端都插网线，追求 60fps 跟手的游戏体验，参数可以放开
- ② 📺无线接收端：手机、平板、电视盒子只做接收，链路走 WiFi，画质标准放宽一档
- ③ 🌐跨网络远程：人和主机不在同一个网段，路由器转发是第一道坎，能连上优先
挑一个编号，后文两张表都跟着它走。
30 秒装好并拉起服务
三个系统流程一致，只有安装动作不同。Windows 和 macOS 装完即跑，只有 Linux 需要额外拉一次用户服务。
Windows
- 下载
Sunshine-Windows-AMD64-installer.msi并双击运行，一路选"允许"。安装器会自动建好防火墙规则并注册后台服务。 成功标志：系统托盘里多出 Sunshine 图标。
Linux
- 用包管理器装。Debian/Ubuntu 先添加官方仓库再执行：
sudo apt install sunshine # 安装 SunshineArch 用户直接一条命令：
pacman -S sunshine # Arch 官方包管理器安装成功标志：终端里能找到
sunshine命令。 - Linux 装完服务不会自己跑，手动启用用户服务（systemd user service，即登录你账户时才运行的后台进程）：
systemctl --user --now enable app-dev.lizardbyte.app.Sunshine # 开机自启并立即启动成功标志：
systemctl --user status app-dev.lizardbyte.app.Sunshine显示active (running)。
macOS
- 先添加官方 tap
LizardByte/homebrew，再安装：brew install sunshine # 通过 Homebrew 安装 Sunshine成功标志：菜单栏出现 Sunshine 图标，首次启动会索要屏幕录制和键鼠控制权限，允许即可。
macOS 目前是实验性功能，手柄输入暂不可用，键鼠和画面串流没问题。
首次配对：给 Moonlight 加一个"桌面"入口
目标：客户端里能点选主机上的桌面或游戏，画面投出去。
- 浏览器打开
https://localhost:47990（别的设备访问就把localhost换主机 IP），首次访问会提示证书不受信任——自签名证书所致，直接继续。首次访问会创建一个 Web 账户，密码记牢。 - 进入应用管理页面，添加一个名为Desktop的桌面项，投的就是整块桌面；想直接起游戏，就填游戏的可执行文件路径。
- 客户端打开 Moonlight，搜索列表里找这台主机；搜不到就手动添加。
- Moonlight 弹出 PIN 请求时，回到 Web 页的PIN入口。
- 输入 PIN 按回车，给设备起个名字，配对完成。
验证：Moonlight 里选中"桌面"，客户端亮起主机画面、光标跟手，就成了。
按场景调帧率与码率
串流起来后，只动下表两个数值（在 Moonlight 客户端的设置里改），其余保持默认。
| 场景 | 目标 | 关键参数 | 关键动作 |
|---|---|---|---|
| ① 有线局域网 | 极限低延迟 | 帧率锁60fps，码率30Mbps起步，带宽有富余加到50Mbps以上 | 两端都插网线 |
| ② 无线接收端 | 流畅不卡顿 | 30fps，或 60fps 但分辨率降一档；码率比 ① 低一档 | 客户端只连5GHzWiFi |
| ③ 跨网络远程 | 能连上优先 | 30fps，码率再降一档 | Web 配置里启用upnp，让路由器自动转发端口 |
码率管清晰度，帧率管跟手感，网络稳定性管能不能用。状况差的时候先砍帧率和码率，编码器设置别碰。
排障速查：按症状对号入座
先别重启，对着症状走这条链路。
| 症状 | 先看哪里 | 怎么处理 |
|---|---|---|
| 浏览器提示站点不安全 | 证书类型 | 自签名所致，点"高级"继续访问；完全打不开再查47990端口 |
| Moonlight 发现不了主机 | 防火墙是否拦了47989和47990 | 放行这两个端口，或给 Sunshine 加防火墙例外 |
| PIN 配对失败 | Web 页是否已登录 | 登录后在PIN入口填 PIN 并给设备命名 |
| 串流卡帧、花屏 | 带宽余量和丢包 | 码率、分辨率各降一档，或改走网线、5GHz |
| Linux 服务起不来 | 用户服务是否已启用 | 执行systemctl --user --now enable app-dev.lizardbyte.app.Sunshine |
都对不上，就打开 Web 页的Troubleshooting标签页，逐条翻警告和错误；Linux 与 macOS 的日志在~/.config/sunshine/。
继续深挖：仓库里三处值得翻
- docs/getting_started.md：各平台安装细节与首次配置全貌，刚装完的人先看它
- docs/performance_tuning.md：AMD Enhanced Sync、NVIDIA Fast Sync 这类降延迟开关，追极致延迟再看
- src_assets/common/assets/web/configs/tabs/：Web 页每个配置标签页的源码，想抠开关背后的机制翻这里
串通之后，家里的电视、卧室的平板、出门带的手机，点开 Moonlight 就是你的游戏机，沙发就是电竞椅。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
