Sunshine 游戏串流完整指南如何把自己的 PC 变成家庭游戏服务器 【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款自托管游戏串流服务器运行在你自己的电脑上配合 Moonlight 客户端串流播放端用硬件编码把 Windows、Linux、macOS 上的桌面与游戏画面低延迟地送到电视、手机、平板上——无需买主机、不依赖厂商云游戏库完全留在自己手里。对号入座三种典型玩家Sunshine 分别帮你解决什么客厅电视党家里有一台 4K 电视和一台游戏 PC想让 3A 大作在客厅大屏上玩又不想搬机器。Sunshine 帮你把 PC 变成客厅游戏主机画面、声音、手柄输入全部走局域网。移动开黑党想在卧室、床上或出差途中用手机、平板玩 PC 游戏只要网络和 Moonlight 客户端在手就能随时接入。多平台玩家日常在 Linux 或 Windows 上游戏偶尔用 Mac 也想串流。Sunshine 支持三大主流桌面系统其中macOS 为实验性支持且暂不支持手柄请留意这一点。从零搭建5 分钟跑通第一次串流安装 Sunshine。优先用官方发行包不必自己编译源码。Debian/Ubuntu 系执行sudo apt install sunshineWindows 用户从发布页下载 MSI 安装包即可Linux 用户也可以直接运行命令sunshine手动启动。打开 Web 管理界面。浏览器访问https://localhost:47990localhost可换成主机内网 IP。浏览器提示不安全属正常现象原因是它使用自签名证书直接继续访问即可。首次打开时创建的用户名和密码是管理员凭据务必当场记下。添加第一个应用。在 Web UI 的 Applications 页添加要串流的游戏系统自带的Desktop桌面应用无需配置点它就能直接串整个桌面适合先验证环境。用 Moonlight 配对设备。在电视或手机上打开 Moonlight 客户端找到主机并发起配对回到 Web UI点导航栏的PIN填入客户端显示的配对码给设备起个名字即完成配对。开始串流。在 Moonlight 里选择刚添加的应用画面就会推送过来。功能全景按你的使用场景找功能在电视上玩 3ASteam 库集成解决什么问题不想一个个手动填游戏路径希望 Moonlight 里直接看到 Steam 游戏库。怎么开启在 Applications 里添加 Steam 作为应用Sunshine 会自动识别游戏库并列出可串流的游戏同时保留成就与云存档等原生能力。想玩哪个游戏就推哪个应用管理解决什么问题不同游戏需要不同的启动参数、工作目录和启动前后脚本比如先关加速器再进游戏。怎么开启Web UI → Applications为每个应用单独配置命令、工作目录与参数支持环境变量如$(HOME)。应用管理相关的配置入口在 src_assets/common/assets/web/configs/。多显示器只串一块Display 设置解决什么问题主机接了多块屏而你想只串其中游戏所在的那块。怎么开启Web UI → Display选择目标显示器的编号并配置分辨率串流中也可以按CtrlAltShiftF1~F12快速切换显示器。配置项太多找不到搜索栏解决什么问题配置项上百个记住名称不如会搜。怎么开启Web UI 顶部搜索栏直接输入关键词定位任意配置项。出问题了先看日志Troubleshooting 页解决什么问题串流失败时不知道原因翻磁盘找日志文件太慢。怎么开启Web UI → Troubleshooting日志在线查看每条警告和错误都能展开看细节配合下方避坑手册能快速定位。多设备、随时随地接入Moonlight 配对解决什么问题手机、平板、电视、盒子都想同时接入。怎么开启每台设备首次连接时输入一次 PIN 即可之后随时接入一个主机可配对多台客户端。远程玩UPnP 自动端口映射解决什么问题想在外网访问家里的串流主机。怎么开启Web UI → Network开启 UPnP若路由器不支持则需在路由器手动转发47989 与 47990 端口TCP UDP串流走 47998 的 UDP 流量。参数速查不同网络环境下的推荐参数组合环境推荐比特率推荐帧率编码器建议附加建议局域网 · 有线50~100 Mbps60 fpsNVENC / AMF / VAAPI 硬件编码主机与客户端都走网线延迟最低的方案局域网 · Wi-Fi20~50 Mbps60 fps硬件编码优先 5 GHz 频段客户端尽量靠近路由器公网远程5~15 Mbps30 fps硬件编码端口转发 稳定上行带宽画质优先于帧率电视 / TV 盒子客户端20~50 Mbps30~60 fps硬件编码若丢包率高把主机网卡降速1000M 降到 100M 档位测试串流对网络稳定性低延迟、低抖动、无丢包的要求高于裸带宽用iperf3测试时理想状态是丢包低于 5%、抖动低于 1 ms。避坑手册高频问题四则 ⚠️1. 浏览器提示连接不安全现象访问 47990 时浏览器拦截页面。 原因Sunshine 默认使用自签名 HTTPS 证书浏览器不认识。 处理直接选择继续访问即可这是正常现象而非攻击不要因此改用不存在的 HTTP 地址。2. 连上后手柄、键盘、鼠标没反应Linux现象Moonlight 里能看画面但输入完全失效。 原因虚拟输入设备依赖 udev 规则安装后未重载。 处理重载规则或重启系统sudo udevadm control --reload-rules sudo udevadm trigger3. Wi-Fi 客户端画面掉帧、花屏、丢包现象有线主机如 2.5G 网卡配 Wi-Fi/千兆客户端串流一阵后大量丢包。 原因Sunshine 每 16 ms 突发发送一帧数据慢速链路中间的缓冲区被瞬时打满溢出。 处理把主机网卡降速到与客户端匹配的档位如 1Gbps 降到 100Mbps或升级客户端链路先用 iPerf3 测出丢包与抖动再动手调参。4. 忘了管理员用户名密码现象Web UI 无法登录被锁在门外。 原因凭据只保存在本地配置中没有找回入口。 处理用命令直接重置新凭据替换大括号内容不含大括号sunshine --creds 新用户名 新密码验收自检逐项确认你的串流环境 ✅检查项通过标准常见异常Web UI 可登录浏览器打开localhost:47990能进入界面打不开 → 检查 Sunshine 是否在运行、防火墙是否放行 47990PIN 配对Moonlight 发起配对后Web UI 填入 PIN 显示成功找不到主机 → 确认两端在同一局域网路由器是否开启 AP 隔离桌面串流选择 Desktop 应用画面数秒内出现且可操作黑屏 → 检查显卡驱动与硬件编码器是否可用手柄输入按键、摇杆在串流端全部有响应部分按键无效 → 检查 Virtual HID 驱动/许可状态Windows日志干净Troubleshooting 页无持续刷新的 Error出现CAP_SYS_NICE告警 → 换用非沙盒安装方式或 Vulkan 编码装好 Sunshine你就拥有了一个 24 小时待命的私人游戏串流服务器——现在就打开 Web UI 添加第一款游戏把客厅电视变成就近的主机吧 【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考