Sunshine卸载清理：完全移除指南
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine 概述
Sunshine作为一款自托管的游戏流媒体服务器，在提供强大功能的同时，也可能需要完全卸载清理。本文将详细介绍在不同操作系统下如何彻底移除Sunshine及其相关组件，确保系统干净整洁。
卸载前准备
在开始卸载前，请确保：
- 备份重要数据：配置文件、游戏列表等
- 停止Sunshine服务：确保所有相关进程已终止
- 记录配置信息：如有需要重新安装时的参考
Windows系统卸载
方法一：通过安装程序卸载（推荐）
标准卸载步骤
- 打开Windows设置 → 应用 → 应用和功能
- 在应用列表中找到"Sunshine"
- 点击"卸载"按钮，按照提示完成卸载
手动清理残留文件
如果标准卸载不彻底，需要手动清理以下目录：
| 目录类型 | 路径 | 内容描述 |
|---|---|---|
| 程序文件 | C:\Program Files\Sunshine\ | 主程序文件 |
| 应用数据 | %APPDATA%\Sunshine\ | 用户配置文件 |
| 本地数据 | %LOCALAPPDATA%\Sunshine\ | 缓存和临时文件 |
| 注册表 | HKEY_CURRENT_USER\Software\Sunshine | 用户设置 |
| 注册表 | HKEY_LOCAL_MACHINE\SOFTWARE\Sunshine | 系统设置 |
方法二：便携版清理
如果使用的是便携版，需要执行以下清理脚本：
:: 清理防火墙规则
scripts\delete-firewall-rule.bat
:: 卸载虚拟游戏手柄驱动
powershell -ExecutionPolicy Bypass -File scripts\uninstall-gamepad.ps1
:: 卸载Windows服务
scripts\uninstall-service.bat
虚拟游戏手柄驱动卸载
# 使用PowerShell卸载ViGEm驱动
$product = Get-CimInstance -ClassName Win32_Product -Filter "Name='ViGEm Bus Driver'"
if ($product) {
Invoke-CimMethod -InputObject $product -MethodName Uninstall
Write-Information "ViGEm Bus Driver卸载成功"
}
Linux系统卸载
不同发行版的卸载方法
| 发行版 | 安装方式 | 卸载命令 | 备注 |
|---|---|---|---|
| Debian/Ubuntu | .deb包 | sudo apt remove sunshine | 自动清理依赖 |
| Arch Linux | pacman | sudo pacman -R sunshine | 保留配置文件 |
| Fedora | copr仓库 | sudo dnf remove Sunshine | 注意大小写 |
| AppImage | 直接运行 | ./sunshine.AppImage --remove | 清理用户目录文件 |
| Flatpak | flatpak包 | 见下方详细步骤 | 需要额外清理 |
Flatpak完全卸载
# 停止并移除用户服务
systemctl --user stop sunshine
rm "$HOME/.config/systemd/user/sunshine.service"
systemctl --user daemon-reload
# 移除输入设备规则
sudo rm /etc/udev/rules.d/60-sunshine.rules
# 卸载Flatpak包
flatpak uninstall --delete-data dev.lizardbyte.app.Sunshine
手动清理残留文件
# 清理配置文件
rm -rf ~/.config/sunshine/
rm -rf ~/.cache/sunshine/
rm -rf ~/.local/share/sunshine/
# 清理系统服务文件（如存在）
sudo rm /etc/systemd/system/sunshine.service
sudo rm /usr/lib/systemd/system/sunshine.service
# 重新加载系统服务
sudo systemctl daemon-reload
macOS系统卸载
Homebrew安装的卸载
# 卸载Sunshine
brew uninstall sunshine
# 清理残留文件
rm -rf ~/Library/Application\ Support/Sunshine/
rm -rf ~/Library/Caches/Sunshine/
rm -rf ~/Library/Preferences/dev.lizardbyte.sunshine.plist
权限清理
由于macOS的安全机制，还需要清理屏幕录制和音频输入权限：
- 打开"系统设置" → "隐私与安全性"
- 在"屏幕录制"中移除Sunshine
- 在"麦克风"中移除Sunshine的访问权限
配置文件清理
通用配置文件位置
重要配置文件说明
| 文件 | 路径 | 作用 | 是否建议保留 |
|---|---|---|---|
| sunshine.conf | 各系统配置目录 | 主配置文件 | 如需重装可保留 |
| apps.json | 各系统配置目录 | 应用列表配置 | 建议备份 |
| ssl证书 | 各系统配置目录 | HTTPS加密证书 | 不建议保留 |
| 日志文件 | 各系统缓存目录 | 运行日志 | 可安全删除 |
服务清理
Windows服务清理
:: 停止并删除服务
net stop SunshineService
sc delete SunshineService
:: 清理旧版本服务（如存在）
net stop sunshinesvc
sc delete sunshinesvc
Linux系统服务清理
# 停止服务
systemctl --user stop sunshine
# 禁用开机启动
systemctl --user disable sunshine
# 移除服务文件
rm ~/.config/systemd/user/sunshine.service
# 重新加载配置
systemctl --user daemon-reload
网络配置清理
防火墙规则清理
Windows:
netsh advfirewall firewall delete rule name="Sunshine"
Linux (iptables):
sudo iptables -D INPUT -p tcp --dport 47989 -j ACCEPT
sudo iptables -D INPUT -p tcp --dport 47990 -j ACCEPT
sudo iptables -D INPUT -p udp --dport 47998 -j ACCEPT
sudo iptables -D INPUT -p udp --dport 47999 -j ACCEPT
sudo iptables -D INPUT -p udp --dport 48000 -j ACCEPT
sudo iptables -D INPUT -p udp --dport 48010 -j ACCEPT
Linux (ufw):
sudo ufw delete allow 47989/tcp
sudo ufw delete allow 47990/tcp
sudo ufw delete allow 47998/udp
sudo ufw delete allow 47999/udp
sudo ufw delete allow 48000/udp
sudo ufw delete allow 48010/udp
彻底清理检查清单
清理完成后的验证步骤
-
进程检查：确保无Sunshine相关进程运行
# Linux/Mac ps aux | grep sunshine # Windows tasklist | findstr sunshine -
端口检查：确认相关端口已释放
# 检查端口占用 netstat -an | grep 47989 netstat -an | grep 47990 -
文件清理验证：确认所有相关目录已删除
-
服务状态检查：确认系统服务已完全移除
常见问题解决
卸载过程中可能遇到的问题
| 问题现象 | 解决方案 | 严重程度 |
|---|---|---|
| 文件被占用 | 先停止所有Sunshine进程再删除 | ⭐⭐ |
| 权限不足 | 使用管理员/root权限运行 | ⭐ |
| 服务删除失败 | 手动使用sc delete命令 | ⭐⭐⭐ |
| 注册表残留 | 使用注册表编辑器手动清理 | ⭐⭐⭐⭐ |
无法完全卸载的处理方法
如果遇到无法正常卸载的情况，可以尝试：
- 安全模式卸载：在安全模式下进行卸载操作
- 专用卸载工具：使用第三方卸载工具辅助清理
- 手动注册表清理：谨慎操作Windows注册表
- 系统还原：如问题严重，考虑使用系统还原点
总结
彻底卸载Sunshine需要从多个层面进行清理，包括程序文件、配置文件、系统服务、网络设置等。本文提供了全面的卸载指南，涵盖了Windows、Linux、macOS三大操作系统，确保您能够完全移除Sunshine及其所有相关组件。
记住，在卸载前做好重要数据的备份，按照步骤有序操作，遇到问题时参考常见问题解决方案。保持系统整洁不仅有助于提升性能，也为后续可能的重新安装做好准备。
最后提醒：卸载操作涉及系统文件和设置，请谨慎操作，特别是在处理注册表和系统服务时。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
