Sunshine 完整指南：如何用 Moonlight 快速跑通第一路游戏串流-创锋一号

Sunshine 完整指南：如何用 Moonlight 快速跑通第一路游戏串流

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

在主机 PC 装 Sunshine、在电视或手机上装 Moonlight，本文按"安装 → 设凭证 → 加应用 → 配对"四步带你从零搭建自托管游戏串流，做完即可把 PC 桌面与任意游戏画面推送到局域网内任意大屏。

3 个典型使用场景

场景	需要准备	用后效果
客厅电视打游戏	一台装好 Sunshine 的 PC，一台能装 Moonlight 的电视	4K 大屏直接跑主机上的 PC 游戏，摆脱长 HDMI 线
手机 / 平板续玩	与 PC 同网段的移动设备	出门在地铁上接着推进游戏存档，回局域网无缝续连
自托管远程桌面	Windows / Linux 主机加任意客户端	画面与数据只走自己的网络，不经过第三方云端

上手前自检 5 项

主机系统：Windows 11+、Debian 13+ / Ubuntu 22.04+、Fedora 43+ 或 macOS 14.2+（macOS 属实验性支持，手柄暂不可用）
编码硬件：带硬件编码的 NVIDIA / AMD / Intel 显卡；没有也可用软件编码，代价是吃 CPU
内存与 CPU：≥4GB 内存，i3 / Ryzen 3 起步
客户端设备：可安装 Moonlight 的 Windows、macOS、Linux、Android、iOS 或智能电视
网络：先在同一个局域网内验证；外网访问需要路由器转发 Sunshine 端口

安装：Windows / Linux / macOS 三步走

Windows

从项目最新 Release 页下载Sunshine-Windows-AMD64-installer.msi（Intel / AMD CPU 均选此版本，ARM64 版为实验性质）。
运行向导完成安装，系统服务随机器自启动，选项按需勾选，不要盲目全装。
需要完整手柄输入时，另行安装 Virtual HID Driver 并重启。

Linux

从最新 Release 页下载与发行版匹配的包：Debian/Ubuntu 用 deb，Fedora 用 rpm，Arch 可直接用 pacman 仓库。
安装命令按发行版三选一：

# Debian / Ubuntu（或先配置官方 stable 源后 sudo apt install sunshine） sudo apt install ./sunshine_{version}-1+{distro}{distro-version}_{arch}.deb # Fedora（Copr 源） sudo dnf copr enable lizardbyte/stable sudo dnf install Sunshine # Arch pacman -S sunshine

启用用户服务并立即启动：

systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

macOS

从最新 Release 页下载对应架构的 DMG：Apple Silicon 选arm64，Intel 选x86_64。
打开镜像，把Sunshine.app拖入 Applications 文件夹。
首次启动时授予屏幕录制与麦克风权限；音频采集留空即可走系统 Audio Tap。
注意 macOS 目前为实验性支持，手柄暂不可用。

首次跑通的 5 个步骤

打开https://localhost:47990，浏览器提示自签名证书不受信任，忽略即可。
在欢迎页设置 Web 界面的用户名与密码——这两个凭证只在当页出现一次，立即记下来。

在 Applications 页添加第一个应用：填名称、可执行文件路径、工作目录与启动参数；验证链路前先选内置的Desktop，它不启动任何程序、直接推流整个桌面。

客户端设备打开 Moonlight：同一局域网会自动发现 Sunshine，发现不了就用 IP 手动添加；发起配对后，把 Moonlight 端显示的配对码填入 Web UI 的 PIN 页，给设备起个名字。
在 Moonlight 里选中Desktop开始串流，主机桌面画面与输入随即实时推到客户端，链路即验证完毕。

参数速查表

参数	推荐值	可调范围	适用情况
分辨率 / 帧率	1080p / 60fps	720p 至 4K，最高 144fps	无线环境从 1080p 起步，有线可上探
视频编码	NVENC / AMF / QuickSync 等硬件编码	软件编码 x264	硬件优先，软件仅作兼容兜底
视频比特率	30 Mbps	2 至 100 Mbps	有线取高值，远程访问调低
音频编码	Opus	AAC / FLAC	FLAC 无损需要更高带宽
`port`	47989	1029–65514	端口被占用时在配置 UI 修改，相关端口整体偏移

分辨率、帧率与比特率主要在 Moonlight 客户端侧设置，Sunshine 会自动跟随客户端请求；卡顿时的调整顺序是先降比特率、再降分辨率。

6 类常见问题速查

现象	可能原因	解决办法
打不开 Web 界面	防火墙拦截 47990 端口	检查主机防火墙规则，放行 Sunshine 端口
忘记 Web 界面密码	凭证仅展示一次	执行`sunshine --creds 新用户名新密码`重置
Moonlight 发现不了服务器	不在同一子网，或发现广播被拦截	确认同局域网，或在 Moonlight 中按 IP 手动添加
手柄在 Steam 里能用、游戏中失灵	主机物理手柄抢占了"第一个设备"	禁用主机物理手柄，让 Sunshine 虚拟手柄优先
应用一启动串流就结束	以`cmd`方式拉起的进程秒退（如 Steam）	改用`detached`方式或换正确的可执行文件路径
画面卡顿、日志报 buffer overrun	无线链路抖动大或比特率过高	用 iperf3 测试（抖动应低于 1 ms、丢包低于 5%），降比特率或改有线

日志持续报错时，逐条点开 Troubleshooting 页里的警告与错误，基本都能定位到采集后端或权限问题。

继续深入的 4 个入口

docs/getting_started.md：各平台安装、初始配置与完整用法
docs/configuration.md：全部配置项逐项说明
docs/troubleshooting.md：故障排查专题
docs/performance_tuning.md：分 GPU 品牌的性能调优建议

问题反馈与日常交流可加入项目官方 Discord 社区。

从安装包到第一路串流，全程只需四步：装包、设凭证、加一个应用、配对客户端。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析