Sunshine + Moonlight 免费 PC 游戏串流指南：从零安装到 10 分钟出画面

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

晚上 11 点，你想在客厅电视上开一把 PC 游戏——Sunshine + Moonlight 就是干这件事的。Sunshine 是跑在你自己主机上的免费自托管游戏串流服务器，抓屏、由 GPU 硬件编码；Moonlight 是装在电视、平板或手机上的客户端，负责把画面收回来。整套链路只走你家局域网，不经过云中转、没有订阅费。跟着这份 Sunshine 安装与 Moonlight 配对指南走，10 分钟出画面。

它凭什么能做到（原理极简版）

这一节用四跳，让你明白一帧画面走的路。

• Sunshine 抓取屏幕画面；
• GPU 直接编码，不占 CPU；
• 音视频流推给局域网里的 Moonlight；
• 你的键位与手柄操作由客户端反向传回主机。

全程不离开自家网络，无云中转、无订阅——这就是免费和低延迟的根本原因。

动手前，先过三道门槛（核对只要 1 分钟）

开装之前，按这张总表对一下平台、硬件、网络三类前提。

⚠️ macOS 版仍是实验阶段，虚拟手柄暂不可用，串桌面和应用没问题。 ⚠️ Linux 上 AppImage 与 Flatpak 均不支持 KMS 捕获，能装发行版包就优先装包。 ⚠️ FreeBSD 只接受 15.1 及以上版本。

最短路径：从零到出画面

这一节是全文重心：先装主机端，再装接收端，最后配对，画面就出来。

主机端：装 Sunshine 并拉起

1. Windows：下载Sunshine-Windows-AMD64-installer.msi双击安装（ARM64 设备选 ARM64 版）。装完它以系统服务后台常驻，浏览器自动弹出配置页https://localhost:47990。提示"不安全"是自签证书导致，点"继续访问"即可。

2. Linux：优先用发行版包。

   sudo apt update sudo apt install sunshine

   Fedora 用sudo dnf install Sunshine。没有现成包时，把Sunshine_{version}_{arch}.AppImage放到主目录执行./Sunshine_{version}_{arch}.AppImage --install。装好用用户级 systemd 服务拉起来并设为开机自启：

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

   systemctl --user status里显示 active 即跑起来了。

3. macOS / FreeBSD：两条命令的事。

   brew tap LizardByte/homebrew brew install sunshine

   macOS 首次启动弹出授权框，把"屏幕录制"和"麦克风"都允许。FreeBSD 执行sudo pkg install ./Sunshine-{version}-{arch}.pkg。

4. 网页端首配（三个平台通用）：

   • 首次访问https://localhost:47990会要求创建管理员账号，这是登录网页和设备配对的唯一凭证，记牢它；
   • 应用列表默认有一条 Desktop，选它就串整个桌面；
   • 想单独串某个游戏，点"添加"，填名称和启动命令，保存后与 Desktop 并列。
   • 配置页顶部有搜索框，输入encoder、max_bitrate等关键词可立刻过滤出对应参数：

接收端：装 Moonlight

1. 在电视盒子、手机或平板上安装 Moonlight（Android、iOS、macOS、Windows 均有官方客户端）。
2. 确认它与主机处于同一局域网。客户端会自动扫描，跑着 Sunshine 的主机会直接出现在设备列表里。登录网页版后，首页大致长这样：

联调：PIN 配对，开始串流

1. 在 Moonlight 里发起配对，屏幕弹出一个PIN 码；
2. 打开网页版并登录，点导航栏的"PIN"页；
3. 输入 PIN 码，顺手给这台设备起个名字，保存；
4. 回到 Moonlight，应用列表选 Desktop，点击开始串流。

✅ 画面出来之后，按键、鼠标、手柄操作就会实时传回主机。到这里，你的 PC 游戏已经在大屏上跑起来了。

挑一个玩法先跑通

对号入座，先选一个场景落地。

不顺时，按这张表查

卡住了别猜，按现象查表。

表格解决不了时，进网页版的 Troubleshooting 标签——那里汇总了全部运行日志，逐条点开警告按提示修：

进阶：画质与帧率拉满

只动两个旋钮：编码器、码率。

• 编码器：在配置页搜encoder。默认自动选第一个可用编码器，手动锁定更稳——N 卡设nvenc，AMD 设amdvce，Intel 核显设quicksync。
• 码率：画面发糊多半是码率偏低。搜max_bitrate，单位 Kbps，按家里带宽往上加，示例写法max_bitrate = 5000。

想冲 4K 60fps，主机和客户端都要过这条硬件线：

继续深入

按场景取用，各一条链接：

• 查全部可调参数：docs/configuration.md
• 编码器细节与系统级优化（如 N 卡 Fast Sync）：docs/performance_tuning.md
• 快捷键与多显示器切换：docs/getting_started.md
• 重装系统前先备份配置目录：Linux / macOS / FreeBSD 在~/.config/sunshine/，Windows 在%LOCALAPPDATA%\LizardByte\Sunshine，整目录拷走即可。

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