Sunshine游戏串流服务器完整部署指南
Sunshine游戏串流服务器完整部署指南
【免费下载链接】Sunshine Sunshine: 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游戏串流服务器的部署配置,享受低延迟的游戏串流体验。
【免费下载链接】Sunshine Sunshine: Sunshine是一个自托管的游戏流媒体服务器,支持通过Moonlight在各种设备上进行低延迟的游戏串流。 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine









