NAS 与运维

Sunshine 与 Moonlight:主机串流配置与客户端配对

  • 0 次阅读
  • 0 条评论
文章摘要

Sunshine 运行在被串流的电脑上,负责捕获桌面并编码画面;Moonlight 运行在手机、平板或另一台电脑上,接收画面并把输入传回主机。主机与客户端承担的角色不同,不能只安装其中一端就建立连接。

项目介绍

Sunshine 运行在被串流的电脑上,负责捕获桌面并编码画面;Moonlight 运行在手机、平板或另一台电脑上,接收画面并把输入传回主机。主机与客户端承担的角色不同,不能只安装其中一端就建立连接。

它适合桌面和游戏串流。画面清晰度、帧率和延迟受主机编码器、客户端解码器和网络共同影响,首次建议从局域网和较低参数开始,再逐步提高画质。

核心功能

功能 说明
主机捕获与编码 由 Sunshine 读取桌面,并生成可传输的音视频流。
客户端接收 由 Moonlight 解码画面并显示在接收设备上。
输入回传 把键鼠或支持的控制器操作传回主机。
画质调整 结合网络和硬件设置分辨率、帧率与码率。

功能示意

Sunshine 与 Moonlight 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 桌面与移动应用
分类 NAS 与运维
项目仓库 LizardByte/Sunshine
整理日期 2026-11-14

安装与使用步骤

主机安装和初始化

  1. 从 Sunshine Releases 选择目标主机系统和架构对应的安装包,按官方说明安装并启动。
  2. 打开 Sunshine 提供的管理页面,创建管理员账号,确认选中了可用的捕获与编码方式。
  3. 在客户端安装 Moonlight,让两台设备先连接同一局域网。
  4. 在 Moonlight 中选择发现的主机;无法发现时按客户端支持的方式填写主机地址。
  5. 发起配对,在 Sunshine 管理端确认客户端显示的配对信息,再启动桌面或一个测试应用。
  6. 依次检查图像、声音、鼠标键盘和手柄,确认后再调整分辨率、帧率与码率。

怎样逐步提高体验

先用主机有线连接测试。移动客户端尽量靠近无线接入点,避免隔墙弱信号;关闭正在占满上行或下行的任务,再比较串流表现。

出现卡顿时先降低码率,再降低分辨率或帧率,并观察主机 CPU/GPU 与网络。高分辨率不等于更清楚的实际体验,如果网络无法持续承载,画面会出现停顿和恢复。

常见问题

黑屏先检查主机显示状态、捕获权限和编码器;有画面没声音检查主机音频输出及串流设置;只能局域网连接时,先解决外部网络到主机的可达性,可使用自己管理的组网方案。

保存主机配置和客户端配对信息,更新驱动或切换显示器后重新测试。分开验证“管理页面能打开”和“串流能建立”,两者使用的连接与功能并不相同。

更新与备份

保存串流应用配置与配对记录,凭据不与演示截图一同公开。

参考资料