Sunshine 自托管游戏串流服务器：四步把 PC 桌面推到电视和手机
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款开源免费的自托管游戏串流服务器，装好后它把一台 Windows、Linux 或 macOS 电脑变成串流主机，配合 Moonlight 客户端，把主机画面和手柄输入实时推到电视、手机或另一台电脑上。本指南带你从零基础跑通第一路串流：装包、开控制台、配对、开播，全程不需要碰代码。
跑通之后，你会看到什么
先描述终点，你照着做，最后对照一遍就知道自己到没到位：
- 主机上：Windows 任务栏托盘出现 Sunshine 图标，Linux 后台跑着一个
app-dev.lizardbyte.app.Sunshine服务，macOS 菜单栏出现托盘菜单。 - 浏览器里：访问
https://localhost:47990能打开 Sunshine 管理控制台，登录后能看到 Home、PIN、Applications 等页面。 - 客户端上：Moonlight 设备列表里出现你的主机，选中 Desktop 点 Play，一秒钟内主机桌面出现在电视或手机上，你动鼠标、敲键盘，对面同步响应。
这三条就是本文的验收清单，任何一条对不上，去后面的"坏的时候"一节找答案。
动手之前：30 秒看你的装备
| 角色 | 门槛 | 什么情况要注意 |
|---|---|---|
| 主机 | Win11 / 主流 Linux / macOS 14.2+ | macOS 为实验性支持，暂不支持手柄 |
| 显卡 | 任意 GPU 都能跑 | 有 NVIDIA/AMD/Intel 核显或独显可走硬件编码；都没有时退回软件编码，能吃 CPU |
| 客户端 | 任何能装 Moonlight 的设备 | Windows、macOS、Linux、Android、iOS、智能电视 |
| 网络 | 主机与客户端同一局域网 | 外网访问要在路由器转发 47984–47990 端口 |
硬件编码就是让显卡专职压缩画面，CPU 基本不干活；软件编码则相反。有硬件编码就尽量用，延迟和流畅度都更好。
⚡ 第一步：把主机程序装起来
Windows：去 Sunshine 官方发布页下载 AMD64 版 MSI（Intel/AMD CPU 都选它；ARM64 版是实验性质），双击安装。安装器会注册自启动的系统服务。想要完整手柄模拟（Xbox Series、DualSense 等新型手柄）需另装 Virtual HID Driver；不装的话，免费的 ViGEmBus 后端也能用，只是只支持 Xbox 360 和 DualShock 4。做完你应该看到任务栏托盘出现 Sunshine 图标。
Linux：按发行版执行其中一条。
Debian/Ubuntu（从发布页拿到对应.deb后）：
sudo apt install ./sunshine_{version}_{arch}.debFedora：
sudo dnf copr enable lizardbyte/stable sudo dnf install SunshineArch：
pacman -S sunshine如果服务没自动起，手动启用并开机自启：
systemctl --user --now enable app-dev.lizardbyte.app.Sunshine做完你应该看到命令无报错，systemctl --user status app-dev.lizardbyte.app.Sunshine显示 active。
macOS：从发布页下载 DMG（Apple Silicon 选 arm64，Intel 选 x86_64），把 Sunshine.app 拖进"应用程序"文件夹。首次启动会依次请求屏幕录制和麦克风权限，全部允许。做完你应该看到菜单栏出现 Sunshine 托盘菜单，且应用没有反复弹权限框。
第二步：打开 Web 控制台，把首启四件事做掉
浏览器访问https://localhost:47990。浏览器会报"不安全"——这是自签名证书（程序自己生成的证书，浏览器厂商没背书），正常现象，选"继续访问"。
- 设凭证：欢迎页让你创建 Web 界面的用户名和密码。这组凭证只显示一次，立刻抄到密码管理器里，忘了就要用命令行重置。
- 接受条款并登录，进入控制台主页，能看到版本号与常用入口，右上角 Theme 菜单可换主题。
- 加应用：进 Applications 页点 Add New，填名称、可执行文件路径、工作目录、启动参数，图标建议 600×800 像素。验证链路不用急着加游戏——系统内置的 Desktop 应用就是"串整个桌面"，先用它。做完你应该看到应用列表里多出这张卡片。
一个提前说好的坑：应用进程一退出，串流立刻结束。像 Steam 这种以壳进程拉起的游戏，要按 detached（脱离父进程独立运行）方式添加，否则串流刚开就断。
- 记住 PIN 页：导航栏里的 PIN 页专门给下一步配对用，先知道它存在就行。
📺 第三步：配 Moonlight，发出第一路串流
- 在客户端设备（电视、手机、另一台电脑）装好 Moonlight。同一局域网内它会自动发现你的主机；发现不了就在添加服务器里手动填主机 IP。
- 在 Moonlight 里对主机发起配对。它会让你输一个 PIN 码——此时切回 Sunshine 的 Web 界面，打开 PIN 页，把页面上的配对码填进 Moonlight，顺手给设备起个名字。页面提示成功后，这台设备就被记住了。
- 选 Desktop，点 Play。
做完你应该看到主机桌面在客户端上实时出现，鼠标键盘手柄全部跟手。需要 Moonlight 各平台客户端或其他配套工具时，Web 界面的 Featured Apps 页直接有入口。
要更顺滑：参数先动哪里
画质和帧率都在 Moonlight 客户端侧设置，Sunshine 自动跟随，你只需要知道往哪个方向拧：
| 参数 | 起步值 | 可动区间 | 判断依据 |
|---|---|---|---|
| 分辨率 / 帧率 | 1080p / 60fps | 720p–4K，最高 144fps | 无线先稳 1080p，有线再冲 4K |
| 视频比特率 | 30 Mbps | 2–100 Mbps | 比特率是"每秒推多少画面数据"，有线取高值，走远程/外网降到 5–15 Mbps |
| 视频编码器 | 硬件编码（NVENC/AMF/QuickSync） | 软件编码 x264 | 仅在硬件编码不兼容时用它兜底 |
| 音频 | Opus / 128 kbps | 64–192 kbps | 追求无损且带宽够就换 FLAC；要极致低延迟取 64 |
卡顿时的动手顺序是固定的：先降比特率，再降分辨率，最后才考虑换软件编码。UPnP 默认关闭，想在别的网络访问，去 Web 的 Network 页开启 UPnP，或在路由器手动转发 47984–47990。
🔧 坏的时候：五种最常见情况
| 你看到 | 多半是 | 怎么办 |
|---|---|---|
| Moonlight 列表里没有主机 | 不在同一子网，或防火墙拦了发现广播 | 确认同局域网；防火墙放行 47984–47990；或直接手动填 IP 添加 |
| 忘了 Web 密码 | 凭证只展示一次 | 主机上执行sunshine --creds 新用户名 新密码重置 |
| 画面卡顿、掉帧 | 比特率偏高或无线丢包 | 按"先降比特率、再降分辨率"顺序降；有条件改有线 |
| 手柄按了游戏没反应 | 主机物理手柄和虚拟手柄抢位 | 让虚拟手柄成为第一个输入设备；Windows 先装好手柄驱动 |
| 黑屏、日志一直刷错 | 采集方式未启用或缺少系统授权 | 打开 Web 的 Troubleshooting 页，按页面上列出的告警逐条修 |
Troubleshooting 页是排障的主入口，每条告警都带说明和处理建议，比翻系统日志快得多。
继续往深里走
- Getting Started：各平台安装与首用细节
- Configuration：全部配置项逐项说明
- Performance tuning：按 AMD/NVIDIA 显卡做的性能调优
- Troubleshooting：故障排查专题
装包、设凭证、加应用、配对，四步走完，串流就通了。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考