Sunshine完全卸载指南：从游戏流媒体主机到系统净化的技术探险

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

你是否曾遇到过这样的场景：Sunshine游戏流媒体主机运行一段时间后，想要彻底清理却无从下手？或者重新安装时总是遇到奇怪的兼容性问题？作为一名技术探险家，我将带领你完成一次从游戏流媒体主机到系统净化的完整旅程。

启程前的准备：理解你的清理目标

在开始这次技术探险之前，我们需要先明确一个重要问题：为什么需要彻底卸载Sunshine？答案可能比你想象的更多样化：

1. 系统重置需求：计划重新安装最新版本，需要一个干净的起点
2. 故障排除：遇到无法解决的编码器错误或网络问题
3. 空间释放：释放被配置文件、缓存和日志占用的磁盘空间
4. 安全审计：确保没有残留的服务或端口暴露风险

让我们先来看看Sunshine的典型工作状态，这是我们的起点：

Sunshine初始设置界面 - 这是我们开始清理前的最后画面

清理工具箱：选择你的探险装备

在开始清理之前，让我们准备合适的工具。根据你的操作系统和安装方式，清理方法会有所不同：

快速参考卡片：清理路径选择器

🔧 包管理器安装

• 场景：通过系统包管理器安装的Sunshine
• 核心操作：使用包管理器的卸载命令
• 预期结果：自动移除程序文件和依赖关系

📦 独立包安装

• 场景：AppImage、Flatpak或便携版安装
• 核心操作：手动删除程序文件和相关配置
• 预期结果：完全移除所有相关文件

🔨 源码编译安装

• 场景：从源代码编译安装的Sunshine
• 核心操作：执行make uninstall（如果支持）
• 预期结果：清理编译产物和安装的文件

第一阶段：停止运行中的Sunshine进程

在开始清理之前，我们必须确保所有Sunshine相关进程都已停止。就像外科手术前需要麻醉一样，这是安全操作的前提。

跨平台进程终止命令

无论你使用哪个操作系统，第一步都是相同的：停止所有Sunshine进程。

Windows PowerShell命令：

# 强制终止Sunshine进程及其子进程 taskkill /F /IM sunshine.exe /T # 验证进程是否已停止 Get-Process -Name "sunshine" -ErrorAction SilentlyContinue

Linux/macOS终端命令：

# 终止所有Sunshine进程 pkill -f sunshine # 验证进程是否已停止 ps aux | grep sunshine | grep -v grep

为什么这很重要？如果Sunshine进程仍在运行，删除文件可能会导致系统错误，甚至损坏正在使用的配置文件。

服务状态检查

Sunshine可能以系统服务的形式运行，我们需要确认服务状态：

Windows服务检查：

# 检查Sunshine服务状态 sc query SunshineService # 如果服务正在运行，先停止它 sc stop SunshineService

Linux系统服务检查：

# 检查用户级服务状态 systemctl --user status sunshine # 停止服务 systemctl --user stop sunshine

macOS启动服务检查：

# 检查LaunchAgent状态 launchctl list | grep sunshine # 停止服务（如果正在运行） launchctl unload ~/Library/LaunchAgents/dev.lizardbyte.sunshine.plist

第二阶段：程序文件的彻底移除

现在Sunshine已经完全停止，我们可以开始移除程序文件了。这是清理过程中最直接的部分，但需要根据你的安装方式采用不同的方法。

包管理器卸载路径

如果你通过系统包管理器安装了Sunshine，卸载过程最为简单：

Windows (winget)：

winget uninstall lizardbyte.sunshine

Debian/Ubuntu (APT)：

sudo apt remove --purge sunshine

Fedora/RHEL (DNF)：

sudo dnf remove sunshine

Arch Linux (Pacman)：

sudo pacman -Rns sunshine

macOS (Homebrew)：

brew uninstall sunshine

验证卸载效果：

# 检查sunshine命令是否还存在 which sunshine # 或者尝试运行sunshine sunshine --version

如果命令返回"command not found"或类似错误，说明程序文件已成功移除。

独立包的清理方法

对于非包管理器安装的Sunshine，我们需要手动清理：

AppImage版本：

# 查找并删除AppImage文件 find ~/ -name "*sunshine*.AppImage" -type f -delete # 删除可能的启动器脚本 rm -f ~/.local/share/applications/sunshine.desktop

Flatpak版本：

# 卸载Flatpak包 flatpak uninstall dev.lizardbyte.app.Sunshine # 清理Flatpak运行时（如果不再需要） flatpak uninstall --unused

便携版/手动安装：

# 假设你安装在/opt/sunshine sudo rm -rf /opt/sunshine # 删除符号链接 sudo rm -f /usr/local/bin/sunshine

第三阶段：配置文件和用户数据的考古挖掘

配置文件和数据文件往往是最容易被忽视的残留部分。这些文件通常隐藏在用户目录中，需要像考古学家一样仔细挖掘。

配置文件位置地图

让我们创建一个视觉化的配置文件位置地图，帮助你理解需要清理的各个位置：

Sunshine配置界面 - 这里展示的配置选项都存储在配置文件中

Windows系统：

• %APPDATA%\Sunshine\- 用户配置和应用程序数据
• %LOCALAPPDATA%\Sunshine\- 本地缓存和临时文件
• C:\ProgramData\Sunshine\- 系统级配置文件（如果存在）

Linux系统：

• ~/.config/sunshine/- 用户配置文件
• ~/.cache/sunshine/- 缓存文件
• ~/.local/share/sunshine/- 应用程序数据
• /etc/sunshine/- 系统级配置文件（如果存在）

macOS系统：

• ~/Library/Application Support/Sunshine/- 应用程序支持文件
• ~/Library/Caches/Sunshine/- 缓存文件
• ~/Library/Preferences/dev.lizardbyte.sunshine.plist- 偏好设置

一键清理脚本

为了简化清理过程，我为你准备了跨平台的一键清理脚本：

Windows PowerShell脚本：

# 备份重要配置（可选） Copy-Item -Path "$env:APPDATA\Sunshine\sunshine.conf" -Destination "$env:USERPROFILE\Desktop\sunshine_backup.conf" -ErrorAction SilentlyContinue # 删除所有Sunshine相关目录 $paths = @( "$env:APPDATA\Sunshine", "$env:LOCALAPPDATA\Sunshine", "$env:PROGRAMDATA\Sunshine" ) foreach ($path in $paths) { if (Test-Path $path) { Remove-Item -Path $path -Recurse -Force -ErrorAction SilentlyContinue Write-Host "已删除: $path" } }

Linux/macOS Shell脚本：

#!/bin/bash # 备份重要配置（可选） cp ~/.config/sunshine/sunshine.conf ~/sunshine_backup.conf 2>/dev/null || true # 删除所有Sunshine相关目录 echo "正在清理Sunshine配置文件和数据..." rm -rf ~/.config/sunshine ~/.cache/sunshine ~/.local/share/sunshine # 检查并删除系统级配置 if [ -d "/etc/sunshine" ]; then echo "警告：发现系统级配置文件 /etc/sunshine" echo "需要管理员权限删除，使用: sudo rm -rf /etc/sunshine" fi echo "配置文件清理完成！"

第四阶段：系统服务与网络规则的深度清理

这是清理过程中最技术性的部分，涉及系统服务和网络配置。让我们像系统侦探一样，追踪并清除所有残留。

服务残留清理

Windows服务完全移除：

# 检查服务是否存在 $service = Get-Service -Name "SunshineService" -ErrorAction SilentlyContinue if ($service) { # 停止服务 Stop-Service -Name "SunshineService" -Force # 删除服务 sc.exe delete "SunshineService" Write-Host "Sunshine服务已成功移除" } else { Write-Host "未找到Sunshine服务" }

Linux系统服务清理：

# 停止并禁用用户级服务 systemctl --user stop sunshine systemctl --user disable sunshine # 删除服务文件 rm -f ~/.config/systemd/user/sunshine.service # 重新加载systemd配置 systemctl --user daemon-reload # 检查是否还有残留的服务文件 find /etc/systemd -name "*sunshine*" -type f

macOS启动代理清理：

# 停止并移除LaunchAgent launchctl unload ~/Library/LaunchAgents/dev.lizardbyte.sunshine.plist 2>/dev/null || true rm -f ~/Library/LaunchAgents/dev.lizardbyte.sunshine.plist # 检查全局LaunchDaemon（需要管理员权限） sudo launchctl list | grep sunshine

防火墙规则清理

Sunshine会创建防火墙规则以允许网络访问，我们需要清理这些规则：

Windows防火墙规则清理：

# 移除所有Sunshine相关的防火墙规则 Remove-NetFirewallRule -DisplayName "*Sunshine*" -ErrorAction SilentlyContinue Remove-NetFirewallRule -DisplayName "*Moonlight*" -ErrorAction SilentlyContinue # 验证规则已删除 Get-NetFirewallRule -DisplayName "*Sunshine*" | Select-Object DisplayName, Enabled

Linux UFW防火墙清理：

# Sunshine使用的典型端口 SUNSHINE_PORTS="47989/tcp 47990/tcp 47998:48010/udp" for port in $SUNSHINE_PORTS; do sudo ufw delete allow $port 2>/dev/null || true done # 重新加载防火墙配置 sudo ufw reload

macOS防火墙清理：

# 检查并移除Sunshine相关的防火墙规则 sudo /usr/libexec/ApplicationFirewall/socketfilterfw --remove /Applications/Sunshine.app 2>/dev/null || true # 列出当前规则确认 sudo /usr/libexec/ApplicationFirewall/socketfilterfw --listapps

第五阶段：验证清理效果的侦探工作

清理完成后，我们需要像侦探一样验证系统是否真的干净了。这是确保没有残留的关键步骤。

四步验证法

第一步：文件系统扫描

# Windows PowerShell Get-ChildItem -Path C:\ -Recurse -Filter "*sunshine*" -ErrorAction SilentlyContinue | Select-Object FullName, Length, LastWriteTime # Linux/macOS sudo find / -iname "*sunshine*" 2>/dev/null | grep -v "/proc/" | head -20

第二步：进程与服务检查

# 跨平台进程检查 # Windows tasklist | findstr sunshine # Linux/macOS ps aux | grep sunshine | grep -v grep # 预期结果：无任何输出

第三步：端口占用检查

# Sunshine使用的标准端口 SUNSHINE_PORTS="47989 47990 47998 47999 48000 48010" # Windows netstat -ano | findstr ":47989 :47990 :47998 :47999 :48000 :48010" # Linux/macOS for port in $SUNSHINE_PORTS; do echo "检查端口 $port:" netstat -tulpn | grep ":$port" || echo "端口 $port 未占用" done

第四步：注册表检查（仅Windows）

# 搜索注册表中的Sunshine残留 $regPaths = @( "HKLM:\SOFTWARE", "HKCU:\SOFTWARE", "HKLM:\SYSTEM\CurrentControlSet\Services" ) foreach ($path in $regPaths) { Get-ChildItem -Path $path -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.Name -match "sunshine" } | Select-Object Name, Property }

清理进度可视化

让我们创建一个清理进度条，帮助你直观了解清理的完成度：

清理进度：[██████████] 100% ├── 进程停止：[██████████] 100% ├── 程序文件：[██████████] 100% ├── 配置文件：[██████████] 100% ├── 系统服务：[██████████] 100% └── 网络规则：[██████████] 100%

第六阶段：解决顽固残留的进阶技巧

有时候，某些文件或服务可能特别顽固。别担心，我们有专门的工具和技巧来处理这些情况。

顽固文件删除技巧

Windows强制删除：

# 使用PowerShell的强制删除功能 Get-ChildItem -Path "C:\" -Recurse -Filter "*sunshine*" -ErrorAction SilentlyContinue | ForEach-Object { try { Remove-Item -Path $_.FullName -Recurse -Force -ErrorAction Stop Write-Host "已删除: $($_.FullName)" } catch { Write-Warning "无法删除: $($_.FullName) - $_" } }

Linux/macOS使用lsof查找占用进程：

# 查找哪些进程正在使用Sunshine文件 sudo lsof | grep sunshine # 如果找到占用进程，先终止它们 sudo pkill -9 -f sunshine # 然后再次尝试删除 sudo rm -rf /path/to/stubborn/sunshine/files

驱动清理（Windows专用）

如果你安装了ViGEmBus驱动用于虚拟手柄支持，可能需要单独清理：

# 列出所有ViGEm相关驱动 pnputil /enum-drivers | findstr "ViGEm" # 找到对应的oemXX.inf文件后执行（替换XX为实际数字） pnputil /delete-driver oemXX.inf /uninstall /force

第七阶段：系统优化与未来防护

完成Sunshine的彻底清理后，这是优化系统并防止未来出现类似问题的好时机。

系统垃圾清理

Windows磁盘清理：

# 运行磁盘清理工具 Cleanmgr /sagerun:1 # 清理临时文件 Remove-Item -Path "$env:TEMP\*" -Recurse -Force -ErrorAction SilentlyContinue Remove-Item -Path "C:\Windows\Temp\*" -Recurse -Force -ErrorAction SilentlyContinue

Linux包缓存清理：

# Debian/Ubuntu sudo apt autoremove sudo apt autoclean # Fedora/RHEL sudo dnf autoremove sudo dnf clean all # Arch Linux sudo pacman -Sc

macOS系统清理：

# 清理用户缓存 rm -rf ~/Library/Caches/* # 运行系统维护脚本 sudo periodic daily weekly monthly

启动项管理优化

Windows启动项管理：

1. 按Ctrl + Shift + Esc打开任务管理器
2. 切换到"启动"选项卡
3. 禁用不必要的启动程序

macOS登录项管理：

1. 打开"系统设置" → "通用" → "登录项"
2. 移除不需要自动启动的应用程序

Linux启动程序管理：

# 查看当前用户启动项 ls ~/.config/autostart/ # 禁用不需要的启动项 mv ~/.config/autostart/unwanted.desktop ~/.config/autostart/unwanted.desktop.disabled

磁盘空间分析

使用磁盘分析工具查看清理效果：

Windows推荐工具：WinDirStat、TreeSize FreemacOS推荐工具：DaisyDisk、OmniDiskSweeperLinux推荐工具：ncdu、Baobab

Sunshine应用程序界面 - 清理后你可以重新开始配置流媒体应用

清理成就清单：验证你的成功

完成所有清理步骤后，让我们检查一下你的成就：

✅基础清理成就

• 停止所有Sunshine进程
• 移除程序可执行文件
• 删除用户配置文件
• 清理缓存和临时文件

✅进阶清理成就

• 移除系统服务/启动项
• 清理防火墙规则
• 验证端口释放
• 检查注册表/系统配置

✅专家级清理成就

• 处理顽固文件残留
• 清理虚拟设备驱动
• 优化系统启动项
• 分析磁盘空间变化

✅系统优化成就

• 运行系统垃圾清理
• 更新系统组件
• 备份重要配置
• 创建系统还原点（Windows）

故障排查与日志分析

如果在清理过程中遇到问题，查看日志是定位问题的关键：

Sunshine日志界面 - 通过日志可以诊断清理过程中的问题

常见清理问题及解决方案：

1. "文件正在使用中"错误

   • 解决方案：使用lsof（Linux/macOS）或Process Explorer（Windows）查找占用进程

2. 服务无法删除

   • 解决方案：重启到安全模式再尝试删除，或使用sc delete命令

3. 权限不足

   • 解决方案：使用管理员/root权限运行命令

4. 配置文件备份失败

   • 解决方案：手动复制文件到安全位置

下一步行动建议

完成Sunshine的彻底清理后，你有几个选择：

🔄 重新安装Sunshine如果你计划重新安装，现在有了一个干净的系统环境：

# 从源码重新编译安装 git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine mkdir build && cd build cmake .. && make -j$(nproc) sudo make install

🔧 系统深度优化利用清理后的系统进行性能优化：

• 运行磁盘碎片整理（Windows）
• 清理软件包缓存（Linux/macOS）
• 更新系统驱动程序
• 检查系统安全性更新

📚 学习更多探索Sunshine的源代码和文档：

• 查看docs/troubleshooting.md了解更多故障排除技巧
• 研究src/目录下的源码结构
• 阅读docs/building.md了解编译和构建细节

总结：从清理到精通

通过这次完整的技术探险，你不仅彻底清除了Sunshine的所有痕迹，还掌握了系统清理的通用方法。记住这些关键收获：

1. 系统清理是一个系统性工程，需要按步骤进行
2. 配置文件往往比程序文件更难清理，需要仔细查找
3. 服务残留是常见问题，需要专门的工具和方法
4. 验证是清理过程的重要组成部分，不能省略

保持系统整洁不仅能释放存储空间，还能提升系统性能和安全性。如果未来需要重新安装Sunshine，你现在有了一个干净的系统环境，这将确保最佳的游戏流媒体体验。

现在，你的系统已经准备好迎接新的开始——无论是重新安装Sunshine，还是尝试其他游戏流媒体解决方案，你都有了完美的起点。祝你在游戏流媒体的世界里探索愉快！

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine