企业官网建设流程全解析

Sunshine 游戏串流完整教程：安装、Moonlight 配对与参数调优一步到位

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

游戏装在书房那台 PC 上，人却坐在客厅 4K 电视前，长 HDMI 线和固定坐姿都是痛点。Sunshine 做的就是游戏串流：把主机 PC 的画面与输入实时编码，推给 Moonlight 客户端，电视、手机、平板都能接着玩。这篇教程按安装、首次配置、配对、调优的顺序走一遍，全程只走你自己的网络。

30 秒看懂 Sunshine

Sunshine 是自托管串流服务端，装在游戏主机上：采集屏幕、硬件编码、向外推流。Moonlight 是配套的解码端，装在电视、手机或另一台电脑上，负责解码和画面呈现。两者一推一收，视频只在自己的网络里跑，不经过任何第三方云。

Sunshine 安装前准备清单

• 主机：Windows、Linux 或 macOS 一台（macOS 为实验性支持，暂不支持手柄）
• 编码：NVIDIA / AMD / Intel 独显或较新核显可硬件编码；没有就退回 x264 软件编码，代价是占 CPU
• 客户端：能装 Moonlight 的设备即可——Windows、macOS、Linux、Android、iOS、智能电视
• 网络：先在同一局域网内验证；外网回连需在路由器转发 47984–47990 端口

🖥️ 安装 Sunshine

Windows

1. 从最新 Release 下载 MSI 安装包，Intel/AMD CPU 选 AMD64 版，ARM64 版为实验性质
2. 运行向导完成安装，系统服务随机器自启动
3. 需要完整手柄输入时，另装 Virtual HID Driver

Linux

• Debian/Ubuntu：sudo dpkg -i sunshine-{发行版}-{版本}-{架构}.deb
• Fedora：

sudo dnf copr enable lizardbyte/stable sudo dnf install Sunshine

• Arch：pacman -S sunshine
• 服务没自启时补一条：systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

macOS

1. 下载对应架构 DMG：Apple Silicon 为 arm64，Intel 为 x86_64
2. 把 Sunshine.app 拖入应用程序文件夹
3. 首次启动授予屏幕录制与麦克风权限

Sunshine 与 Moonlight 的配对流程

1. 浏览器打开https://localhost:47990，证书告警属正常（自签名），可忽略
2. 欢迎页设置 Web 用户名与密码，凭证只显示一次，先记下来
3. 接受服务条款并登录，进 Applications 页添加应用：名称、可执行文件路径、工作目录、启动参数、图标（建议 600×800）。内置 Desktop 与 Steam Big Picture，验证链路先跑 Desktop

4. 客户端打开 Moonlight，会自动发现局域网内的 Sunshine，也可用 IP 手动添加
5. 发起配对后到 Sunshine Web 的 PIN 页查配对码，填进客户端并给设备命名
6. 选中应用开始串流，主机随即启动程序并推送画面

Sunshine 调优参数速查

这些值大多在 Moonlight 客户端侧设置，Sunshine 会自动跟随。UPnP 默认开启、内网映射自动完成，外网仍需手动转发 47984–47990。出现卡顿先降比特率、再降分辨率，顺序反过来效果通常更差。

常见问题快诊

• 客户端发现不了服务器 → 确认同一子网、放行 47984–47990，或在 Moonlight 里用 IP 手动添加
• 忘记 Web 界面密码 → 凭证只展示过一次，用sunshine --creds 新用户名 新密码重置
• 延迟高或卡顿 → 先降比特率、再降分辨率，无线换有线；用 iperf3 测链路，抖动应低于 1 ms
• 手柄游戏中无响应 → 禁用主机物理手柄，让 Sunshine 虚拟手柄成为"第一个"设备；Windows 先装 Virtual HID Driver
• 应用启动后串流立即结束 → 多半是应用启动即退出，改用 detached 方式或核对可执行文件路径
• 黑屏且日志持续报错 → 打开 Troubleshooting 页逐条看日志，确认采集后端已启用、权限给够

延伸阅读

• docs/getting_started.md：各平台安装与首用流程
• docs/configuration.md：全部配置项说明
• docs/performance_tuning.md：性能调优细节
• 问题反馈与日常交流：项目官方 Discord 社区

装包 → 设凭证 → 加应用 → 配对客户端，四步走完就能开玩；局域网跑通后再按网络条件慢慢调参。

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