游戏串流零中断：Sunshine配置备份与恢复全攻略
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine 你是否曾因系统重装丢失精心调试的串流参数？或在版本更新后发现控制器映射全部失效？作为自托管游戏流媒体服务器，Sunshine的配置文件包含了从视频编码参数到设备授权的关键数据。本文将通过三步备份策略，结合官方工具与自动化脚本，帮你实现配置数据的无缝迁移与永久保护。
一、核心配置文件定位
Sunshine的所有个性化设置分散在多个关键文件中，默认存储路径因操作系统而异：
| 操作系统 | 配置目录路径 |
|---|---|
| Windows | %ProgramFiles%\Sunshine\config |
| Linux | ~/.config/sunshine |
| macOS | ~/.config/sunshine |
| Docker | /config |
核心文件说明：
sunshine.conf：主配置文件，包含视频编码、音频设备等核心参数（配置参考文档）apps.json：游戏/应用列表及启动参数sunshine_state.json：设备配对状态与连接历史credentials/：存储客户端授权证书的敏感目录
二、手动备份三要素
1. 基础备份流程
通过文件管理器导航至配置目录，复制以下内容至外部存储介质：
# Linux/macOS示例
cp -r ~/.config/sunshine /mnt/backup/sunshine_config_$(date +%Y%m%d)
# Windows命令行示例
xcopy "%ProgramFiles%\Sunshine\config" D:\Backup\Sunshine /E /H
2. 版本间兼容性处理
不同版本配置文件格式可能变化，迁移时建议使用官方提供的迁移工具：
# Windows迁移脚本（[源码路径](https://link.gitcode.com/i/ff7c325fed98a304027e06e01c9f7ded)）
%ProgramFiles%\Sunshine\misc\migration\migrate-config.bat
该脚本会智能处理路径转换，例如将旧版covers/目录迁移至新路径并自动更新apps.json中的图片引用：
# 脚本核心处理逻辑
(Get-Content '%NEW_DIR%\apps.json').replace('.\/covers\/', '.\/config\/covers\/') | Set-Content '%NEW_DIR%\apps.json'
3. 敏感数据保护
credentials/目录存储加密的客户端授权信息，需确保备份文件权限安全：
# Linux权限设置示例
chmod 700 /path/to/backup/credentials
chown $USER:$USER -R /path/to/backup/credentials
三、自动化备份方案
1. Windows任务计划程序
创建批处理脚本backup-sunshine.bat：
@echo off
set "BACKUP_DIR=D:\SunshineBackups\%date:~0,4%%date:~5,2%%date:~8,2%"
mkdir "%BACKUP_DIR%"
xcopy "%ProgramFiles%\Sunshine\config" "%BACKUP_DIR%" /E /H /Y
通过任务计划程序设置每日凌晨3点执行，确保备份时效性。
2. Linux系统服务
创建systemd服务单元sunshine-backup.service：
[Unit]
Description=Sunshine配置自动备份
[Service]
Type=oneshot
ExecStart=/bin/bash -c 'cp -r ~/.config/sunshine /var/backups/sunshine_$(date +%%Y%%m%%d)'
配合定时器单元实现每周备份：
[Timer]
OnCalendar=weekly
Persistent=true
[Install]
WantedBy=timers.target
四、恢复策略与故障排除
标准恢复流程
- 停止Sunshine服务
- 将备份文件复制到对应配置目录
- 修复文件权限（Linux/macOS）：
sudo chown -R $USER:$USER ~/.config/sunshine
- 重启服务验证配置生效
常见问题解决
- 授权失效：删除
credentials/目录后重新配对客户端 - 视频卡顿：检查
sunshine.conf中的编码器设置是否匹配硬件 - 迁移失败：使用
migrate-config.bat工具时确保以管理员权限运行
五、备份实践建议
-
三级备份策略：
- 每日增量备份（保留7天）
- 每周完整备份（保留4周）
- 月度归档备份（保留12个月）
-
配置版本控制： 将备份目录纳入Git仓库，通过提交日志追踪配置变更历史：
git init /path/to/backup/repo git add . && git commit -m "2025-10-18: 添加HDR编码参数" -
跨平台迁移注意事项：
- Windows→Linux需转换行尾符（
dos2unix sunshine.conf） - 音频设备名称可能变化，需更新
audio_sink配置项
- Windows→Linux需转换行尾符（
通过这套备份方案，你可以在系统重装、硬件更换或软件升级时，5分钟内恢复完整的串流环境。建议定期测试恢复流程，确保备份文件的有效性。完整配置参数说明可参考官方文档，如有备份脚本改进需求可参与社区贡献。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
