Sunshine：8步快速搭好你的游戏串流服务器

Sunshine8步快速搭好你的游戏串流服务器【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineHDMI 线够不到客厅的电视却想在电视上玩 PC 游戏库Sunshine 是一款免费的自托管游戏串流服务器配合 Moonlight 客户端把你的游戏画面串流到手机、平板或电视上。Sunshine 是一个自托管游戏串流主机专为 Moonlight 客户端设计。它支持 AMD、Intel、NVIDIA 显卡的硬件编码也提供软件编码兜底适合想把游戏 PC 变成家用串流主机的玩家。低延迟硬件编码三大显卡厂商的硬编方案全支持浏览器配置管理Web UI 完成配对、加游戏、改参数多平台客户端接入手机、平板、电视装 Moonlight 即可连环境门槛最低配置与推荐配置组件最低配置推荐配置4K 串流GPUAMD VCE 1.0 / Intel VAAPI 或 Skylake / NVIDIA NVENC 开启的卡AMD VCE 3.1 / Intel HD 510 / NVIDIA RTX 2000 系WindowsGTX 1080CPUIntel Core i3 / AMD Ryzen 3Intel Core i5 / AMD Ryzen 5内存4GB 及以上—网络主机与客户端均为 5GHz 802.11ac主机与客户端均为 CAT5e 有线操作系统支持Windows 11、macOS 14.2、LinuxUbuntu 22.04/Debian 13/Fedora 43、FreeBSD 15.1。注意 macOS 版本仍属实验性手柄暂不可用。完整参数说明见官方配置文档docs/configuration.md。Sunshine 安装与首次连通步骤按顺序执行以下 6 步跑通第 6 步就可以用了。安装 SunshineWindows下载官方 MSI 安装器AMD64 或 ARM64安装时注意按需勾选选项。macOSbrew tap LizardByte/homebrew brew install sunshineLinuxDebian/Ubuntucurl -1sLf https://dl.cloudsmith.io/public/lizardbyte/stable/cfg/setup/bash.deb.sh | sudo -E bash sudo apt update sudo apt install sunshineFedora/openSUSE 用sudo dnf install SunshineArch 用pacman -S sunshine。可选容器部署Docker 镜像适合高级用户配置保存在容器内/configdocker run -d \ --device /dev/dri/ \ --namesunshine --ipchost \ -v /path/to/config:/config \ -p 47984-47990:47984-47990/tcp -p 47998-48000:47998-48000/udp \ lizardbyte/sunshine:latest-ubuntu-24.04启动 SunshineLinux 装完是 systemd 用户服务一条命令开机自启systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 安装器默认以服务运行其他情况手动执行sunshine即可。完成 macOS 首次授权如适用首次启动会请求屏幕录制和麦克风权限授予即可。macOS 14.0 留空 Audio Sink 就能采集系统声音。浏览器打开 Web UI访问https://localhost:47990可换成主机内网 IP浏览器提示不安全属正常证书是自签名的。首次打开会要求你创建管理员用户名和密码务必记下来。添加第一个应用在 Web UI 里点添加应用输入 Desktop 并选择desktop.png图片就能串流整个桌面串流 Steam 游戏则添加启动命令steam steam://open/bigpictureWindows作为分离命令。示例见 docs/app_examples.md。Moonlight 客户端配对在 Moonlight 里添加这台主机请求配对时进入 Web UI 导航栏的 PIN 页面输入 PIN 码并给设备起个名字然后选一个应用开始串流。首次连通后Web UI 首页如下功能全景能力清单能力什么时候用注意什么游戏/应用串流日常使用启动新应用会结束正在运行的应用应用退出串流也会结束桌面串流想串流整个桌面应用名填 Desktop、图片选desktop.png无启动命令虚拟手柄客户端用手柄玩游戏Windows 需另装 Virtual HID 驱动macOS 暂不支持手柄多显示器切换主机接了多块屏快捷键CtrlAltShiftF1/F12切换串流输出HDR 串流主机与客户端都支持 HDRWindows 正式支持Linux 实验性主机 OS 需先开启 HDRWeb UI 远程管理配置、配对、查日志局域网即可访问Featured Apps 页可找 Moonlight 客户端配置项太多时用顶部搜索框直接定位比翻文档快。找 Moonlight 客户端和配套工具去 Featured Apps 标签页分场景调优该改什么 为什么轻度串流办公、远程桌面、低配主机编码器保持默认自动选择即可Sunshine 会用第一个可用的编码器没有可用硬编时会自动落到 CPU 软件编码。minimum_fps_target默认为 0取串流帧率一半静态画面多时 Sunshine 会补发重复帧省带宽不用改。音频想更省流可以改stream_audio为 disabled代价是串流无声。重度串流4K 高帧率游戏、低延迟需求max_bitrate默认 0表示完全跟随 Moonlight 请求的码率带宽有限时设一个上限如max_bitrate 5000单位 Kbps避免爆带宽。Windows NVIDIA在 NVIDIA 控制面板开启 Fast Sync 可再降一帧延迟出现卡顿可尝试关闭vsync:fast。Windows AMD开启 Enhanced Sync 可降低约一帧延迟。Linux 高 GPU 负载下硬编掉帧日志出现CAP_SYS_NICE capability is missing警告时改用vulkan编码器通常能解决AMD/Intel/NVIDIA 均支持Linux 专用。排障速查连接被拒绝、黑屏、手柄失灵怎么办现象可能原因处理动作连接被拒绝防火墙拦截检查防火墙规则放行 Sunshine 端口Web UI 打不开防火墙拦截同上确认地址用https://而非http://忘了 Web UI 密码凭据遗忘执行sunshine --creds 新用户名 新密码重置手柄无响应Linux输入设备权限sudo usermod -aG input $USER后重新登录必要时重启KMS 抓取黑屏NVIDIA内核模块参数内核命令行加nvidia_drm.modeset1掉包严重、画面卡顿主机网卡远快于客户端用iperf3测试链路降低码率或网卡速率定位问题的入口在 Web UI 的 Troubleshooting 标签页日志逐条列出警告和错误每条都是排查线索。更完整的分平台问题清单见 docs/troubleshooting.md。进阶玩法自定义输出、多屏与音频指定显卡、显示器与分辨率Windows 下配合 Desktop Duplication 使用adapter_name Radeon RX 580 Series output_name HDMI-A-1 dd_resolution_option manual dd_manual_resolution 2560x1440效果强制用指定显卡抓指定显示器的指定分辨率混合显卡的机器尤其有用。多显示器串流切换串流中按CtrlAltShiftF1到F12直接切换输出屏幕不用回 Web UI 改output_name。另有CtrlAltShiftN隐藏/显示鼠标指针。自定义音频输出Linux/PipeWireaudio_sink Steam Streaming Speakers stream_audio enabled效果把指定音频 sink 的声音回环进串流pacmd list-sinks | grep name:可查出可用名称。HDR 串流额外注意主机 OS 必须开启 HDR可能需要 HDR 显示器或 EDID 模拟 dongleMoonlight 客户端也要开 HDR 选项否则会 SDR 过曝。总结与行动清单Sunshine 把游戏 PC 变成局域网内的串流主机装好、配对完剩下的都是享受。✅ 确认显卡支持硬件编码核对最低配置表✅ 按系统安装 SunshineMSI / brew / apt / dnf✅ 启动服务并打开https://localhost:47990✅ 创建并牢记 Web UI 管理员账号✅ 添加 Desktop 或第一个 Steam 应用✅ 在 Moonlight 客户端输入 PIN 完成配对✅ 串流中用CtrlAltShift组合键测试输入✅ 出问题先查 Troubleshooting 标签页的日志仓库资源入门指南docs/getting_started.md配置文档docs/configuration.md排障文档docs/troubleshooting.md源码结构src/测试用例tests/【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考