Moonlight串流工具是一款基于NVIDIA GameStream技术打造的开源游戏串流解决方案，现已全面兼容Windows、macOS、Linux、Android及iOS等主流操作系统。借助高效的实时视频流传输技术，它能将高性能主机或PC上的游戏画面无缝投射至手机、平板等移动设备，同时将用户的键盘、鼠标或手柄操作指令毫秒级回传至主机端。这种双向低延迟通信机制，让远程游戏体验几乎与本地操作无异。在稳定的Wi-Fi或5G网络环境下，甚至可实现4K@60fps的高清画质串流，让普通设备瞬间拥有畅玩3A大作的能力。

moonlight设备连接指南

一、移动端配置流程

1、从官方渠道下载并安装Moonlight应用，启动后点击右上角“+”按钮

2、在弹出的输入框中填写目标主机的IP地址

3、确保主机已开机并正常连接网络

二、主机端环境要求

硬件配置：需配备NVIDIA GTX 600系列或更高型号显卡，并安装GeForce Experience软件

网络环境：建议使用家庭路由器；若需远程串流，须向运营商申请公网IP地址

设备兼容：支持手机、平板、智能电视等多种终端接收串流内容

三、本地网络串流（新手推荐）

基础条件：移动设备与主机必须处于同一局域网内

主机设置：

打开GeForce Experience → 进入“设置” → 选择“SHIELD” → 启用GameStream功能

系统会自动识别已安装的游戏，同时也支持手动添加其他应用程序

移动端操作：

启动Moonlight客户端后，应用将自动搜索局域网内的可用主机

选择目标主机完成配对，即可立即开始串流游戏

四、远程公网串流（高级配置）

网络要求：必须拥有公网IP地址（可联系网络服务提供商申请）

IP配置：支持IPv4/IPv6双协议栈，本教程以IPv4为例说明

端口映射：

需在光猫及路由器中设置端口转发规则，并将主机IP设为静态地址

必须开放以下端口：

TCP：47984、47989、48010

UDP：47998、47999、48000、48010

可使用canyouseeme.org等工具验证端口是否成功开放

配置建议：

建议先在局域网内完成测试，确认串流功能正常后再尝试远程连接

切换至4G/5G移动网络后，只要公网配置正确，仍可保持稳定流畅的串流体验

hdr流媒体技术规范

部分Moonlight客户端已支持HDR10视频流（当前为测试版本），但需满足特定软硬件条件。若设备不达标，HDR选项将自动置灰或不可用。

已知技术限制：

启用HDR时可能出现颜色闪烁或伪影现象

视频流通常需用户进行一次鼠标交互后才开始传输

当串流分辨率与显示设备不匹配时，可能产生缩放失真

主机端HDR状态的变更需重启系统后才能生效

主机端要求：

NVIDIA GTX/RTX 1000系列或更高型号显卡

部分游戏需连接真实HDR显示器或使用EDID模拟器

串流分辨率应与主机当前显示设置保持一致

iOS/Apple TV要求：

系统版本需为iOS/tvOS 11.3或更高

必须连接兼容HDR10的显示设备

iOS设备需配备XDR显示屏（如iPhone 12 Pro及以上机型）

Android要求：

系统版本需为Android 7.0或更高

设备需具备HEVC Main10硬件解码能力

屏幕必须支持HDR10标准

Windows要求：

系统版本需为Windows 10 1703或更高

显示设备需兼容HDR10

GPU需同时支持HEVC Main10解码与HDR10输出

Intel GPU需为第7代（Kaby Lake）或更新型号

NVIDIA GPU需为1000系列（Pascal架构）或更高

AMD GPU需为RX 400系列（Polaris架构）或更高

使用窗口模式时，需在Windows系统设置中手动开启HDR开关

Linux要求：

需通过命令行终端直接启动应用

目前仅确认Intel GPU可正常工作（其他品牌尚未充分测试）

显示设备必须支持HDR10

树莓派4要求：

需通过控制台直接运行程序

连接的显示器必须兼容HDR10标准

输入设备操作手册

PC客户端控制：

支持键盘、鼠标、触摸屏及最多4个游戏手柄同时接入，常用快捷键如下：

Ctrl+Alt+Shift+Q - 终止串流（游戏仍在主机后台运行）

Ctrl+Alt+Shift+Z - 切换鼠标与键盘的捕获状态

Ctrl+Alt+Shift+X - 在全屏与窗口模式间切换

Ctrl+Alt+Shift+S - 显示实时性能统计信息（Steam Link和树莓派设备不支持）

Ctrl+Alt+Shift+M - 切换鼠标控制模式（指针捕获或直接控制）

Ctrl+Alt+Shift+V - 将本地剪贴板内容粘贴到远程主机

Ctrl+Alt+Shift+D - 最小化串流窗口

Ctrl+Alt+Shift+C - 切换本地光标是否显示（远程光标始终可见）

Ctrl+Alt+Shift+L - 锁定鼠标至视频区域（需提前启用“优化鼠标”选项）

触摸屏控制：

提供“触控板模式”与“直接触摸模式”两种操作方式：

触控板模式：

光标移动通过手指滑动屏幕实现

左键点击为单指轻触

右键点击为双指同时轻触

拖动操作需长按后移动手指

垂直滚动通过双指上下滑动完成

在iOS/Android设备上，三指点击可唤出虚拟键盘

直接触摸模式：

点击操作会先移动光标再执行左键点击

右键通过在目标位置长按触发

拖动即点击后持续移动手指

iOS/Android设备同样支持三指点击唤出键盘

iOS设备额外支持双指捏合缩放与双指拖动平移操作

Android设备：

全面支持标准Android手柄映射，兼容Xbox 360/One、PS3/PS4等主流控制器。对于特殊手柄，可通过组合键模拟功能按键：

Start + Select（如有Select键）或 R1 + Start（无Select键）= 模式键

L1 + Start = Select键

非Shield设备或Android 7.1以下系统若需使用外接鼠标，通常需要Root权限，可从GitHub下载专用的app-root-release.apk版本。Shield设备及Android 8.0以上系统已内置鼠标捕获功能，Root设备可通过Ctrl+Alt+Shift+Z切换捕获状态。

在没有物理鼠标的情况下，可使用手柄模拟鼠标操作：长按Start键激活，摇杆控制光标移动，A键为左击，B键为右击。

iOS/tvOS设备：

iOS 13及以上版本支持通过蓝牙连接Xbox One S和PS4手柄，完整映射所有物理按键并支持振动反馈。iOS 12及更早版本仅兼容MFi认证手柄，建议选择带扩展布局的型号。iPadOS 13.4起初步支持鼠标输入，但功能受限；至14.0版本后解除多按钮限制，非Apple品牌鼠标建议通过USB方式连接以获得更好兼容性。

Apple TV遥控器可作为触摸板使用。在iOS设备上从屏幕左侧边缘向内滑动，或在tvOS设备上双击菜单键，均可快速断开串流连接。注意：不支持旧款iCade手柄。

版本更新记录

v12.1版本

新增对Sunshine端到端流加密的支持

修复特定网络环境下连接意外中断的问题

增加模拟震动强度的调节选项

控制器鼠标模式下新增滚动功能

显著提升临时断网后的自动重连稳定性

优化Sunshine特殊键组合下的主机连接体验