Sunshine游戏串流服务器完整部署指南

Sunshine游戏串流服务器完整部署指南

【免费下载链接】SunshineSunshine: Sunshine是一个自托管的游戏流媒体服务器，支持通过Moonlight在各种设备上进行低延迟的游戏串流。项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

Sunshine是一款自托管的游戏串流服务器，专为Moonlight客户端设计。它提供低延迟的云游戏服务器功能，支持AMD、Intel和NVIDIA GPU进行硬件编码，软件编码也可用。通过Sunshine，您可以从各种设备上的任何Moonlight客户端连接，Web UI允许从您喜欢的Web浏览器进行配置和客户端配对。

核心功能特性

硬件编码支持

• AMD GPU：支持AMF编码器
• Intel GPU：支持QuickSync视频技术
• NVIDIA GPU：支持NVENC编码器

虚拟手柄模拟

Sunshine支持多种游戏手柄的虚拟模拟：

• PlayStation 4手柄（DualShock 4）
• PlayStation 5手柄（DualSense 5）
• Nintendo Switch Pro手柄
• Xbox 360手柄
• Xbox One/Series手柄

系统要求

最低配置

• GPU：支持硬件编码的显卡
• CPU：AMD Ryzen 3或Intel Core i3及以上
• 内存：4GB或更多
• 操作系统：
  • FreeBSD 14.3+
  • Linux Ubuntu 22.04+
  • macOS 14+
  • Windows 11+

部署方案选择

Windows系统部署

推荐方案：安装程序

下载最新版安装程序，运行后自动完成：

• 服务注册与开机启动
• 防火墙规则添加
• 虚拟手柄驱动安装
• Web管理界面配置

便携版部署（高级用户）

如需手动部署便携版，可使用以下脚本：

# 添加防火墙规则 cd /d {解压目录} scripts/add-firewall-rule.bat # 安装虚拟手柄支持 scripts/install-gamepad.bat # 注册系统服务 scripts/install-service.bat scripts/autostart-service.bat

Linux系统部署

一键安装脚本

# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine # 运行构建脚本 chmod +x scripts/linux_build.sh ./scripts/linux_build.sh

发行版专用方案

Ubuntu/Debian

# 下载deb包 wget https://github.com/LizardByte/Sunshine/releases/latest/download/sunshine-ubuntu-22.04-amd64.deb # 安装 sudo dpkg -i ./sunshine-ubuntu-22.04-amd64.deb

Arch Linux

# 添加LizardByte仓库 curl -s https://lizardbyte.github.io/pacman-repo/install.sh | bash # 安装 sudo pacman -S sunshine

Fedora/OpenSUSE

# 添加COPR仓库 sudo dnf copr enable lizardbyte/stable # 安装 sudo dnf install Sunshine

服务管理

安装完成后配置系统服务自动启动：

# 启动服务 systemctl --user start sunshine # 设置开机启动 systemctl --user enable sunshine

Docker容器化部署

快速启动命令

docker run -d \ --device /dev/dri/ \ --name=sunshine \ --restart=unless-stopped \ --ipc=host \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Asia/Shanghai \ -v /path/to/data:/config \ -p 47984-47990:47984-47990/tcp \ -p 48010:48010 \ -p 47998-48000:47998-48000/udp \ lizardbyte/sunshine:latest-ubuntu-24.04

Docker Compose配置

创建docker-compose.yml文件：

version: '3' services: sunshine: image: lizardbyte/sunshine:latest-ubuntu-24.04 container_name: sunshine restart: unless-stopped volumes: - /path/to/data:/config environment: - PUID=1000 - PGID=1000 - TZ=Asia/Shanghai ipc: host ports: - "47984-47990:47984-47990/tcp" - "48010:48010" - "47998-48000:47998-48000/udp"

配置与优化

基础配置

音频配置

# 查找音频设备 pacmd list-sinks | grep "name:" # 或使用pipewire pactl info | grep Source

网络配置

确保以下端口可用：

• TCP：47984-47990
• UDP：47998-48000

性能优化

GPU编码设置

# NVIDIA GPU编码设置 encoder=hevc_nvenc quality=20 bitrate=15000

故障排查

常见问题解决

权限问题修复

Linux下权限问题可通过以下命令解决：

# 修复设备访问权限 sudo usermod -aG input $USER sudo usermod -aG video $USER

服务状态检查

# 检查服务运行状态 systemctl --user status sunshine # 查看日志 journalctl --user -u sunshine -f

高级功能

HDR支持

Sunshine支持HDR内容流传输：

• Windows：官方支持
• Linux：实验性支持

多用户环境管理

通过Web管理界面实现：

• 用户权限分级管理
• 会话监控和资源分配
• 使用统计和性能分析

部署验证

Web界面访问

打开浏览器访问https://localhost:47990，首次登录需创建管理员账户。

维护与更新

自动备份策略

# 创建配置备份脚本 cat > ~/backup-sunshine.sh << 'EOF' #!/bin/bash BACKUP_DIR="/var/backups/sunshine" mkdir -p $BACKUP_DIR TIMESTAMP=$(date +%Y%m%d_%H%M%S) tar -czf $BACKUP_DIR/sunshine_$TIMESTAMP.tar.gz ~/.config/sunshine/ EOF

通过本指南，您可以快速完成Sunshine游戏串流服务器的部署配置，享受低延迟的游戏串流体验。

【免费下载链接】SunshineSunshine: Sunshine是一个自托管的游戏流媒体服务器，支持通过Moonlight在各种设备上进行低延迟的游戏串流。项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine