为什么做 Cloud Agent Cleaner？

很多云服务器创建完成后，系统里会预装远程运维、主机监控、安全防护、自动化执行等组件。 对于需要这些能力的用户，它们很方便；但如果你已经有自己的监控、安全、运维体系，或者希望减少后台常驻进程， 就可能希望把不需要的可选组件卸载掉。

真正麻烦的地方不是“删一个目录”，而是不同云厂商、不同系统镜像、不同历史版本的安装方式并不完全相同。 有的通过 systemd，有的通过软件包，有的还有厂商自己的卸载脚本；部分 Agent 卸载后还可能留下服务文件、静态目录或缓存。

目前支持哪些云平台？

cloud-init、qemu-guest-agent、VirtIO、ENA、NVMe 驱动以及脚本无法确认身份的未知软件也不会被处理。

一键使用

SSH 登录 Linux 服务器后执行：

curl -fsSLo /tmp/cloud-agent-cleaner.sh https://raw.githubusercontent.com/nljie1103/cloud-agent-cleaner/main/quick-run.sh && sudo bash /tmp/cloud-agent-cleaner.sh

程序首先只做检测，会把结果按组件列出来，例如：

aliyun.assistant   DETECTED
aliyun.monitor     DETECTED
aliyun.security    DETECTED

确认清除以上可选组件？输入 y 继续 [y/N]:

只有输入 y 后才会真正清理检测到的可选组件。执行前会保存一份本机检测清单，完成后再次做残留验证。

服务器访问不了 GitHub 怎么办？

当前一键入口本身来自 raw.githubusercontent.com，随后 quick-run.sh 还会从 GitHub 下载项目的 main.tar.gz。因此只要服务器到 GitHub Raw 或 GitHub 主站其中一段连接失败， 一键命令就可能无法完成。

方案 A：在自己电脑下载，再上传服务器

这是 GitHub 无法直连时最稳妥的方式。先在能够正常访问 GitHub 的电脑打开项目主页，下载仓库 ZIP，解压后把整个项目目录上传到服务器。

1. 电脑端下载项目：在 GitHub 项目页面选择 Code → Download ZIP。
2. 上传到服务器：可以使用 SFTP、FinalShell、WinSCP、Termius、scp 等你已经在使用的文件传输方式。
3. 进入目录执行：
   本地上传后运行 复制

   cd cloud-agent-cleaner-main
   sudo python3 cloud_agent_cleaner.py --quick

方案 B：自己搭建可信镜像

如果你有很多国内服务器，建议把项目压缩包同步到自己控制的对象存储、网站或 CDN。 服务器从你自己的域名下载，再核对 SHA-256 后运行。这样既解决 GitHub 连通性，又不需要把 root 权限交给陌生代理。

curl -fL "https://你的可信域名/cloud-agent-cleaner-main.tar.gz" -o /tmp/cloud-agent-cleaner.tar.gz
sha256sum /tmp/cloud-agent-cleaner.tar.gz
mkdir -p /tmp/cloud-agent-cleaner
tar -xzf /tmp/cloud-agent-cleaner.tar.gz -C /tmp/cloud-agent-cleaner
cd /tmp/cloud-agent-cleaner/cloud-agent-cleaner-main
sudo python3 cloud_agent_cleaner.py --quick

上面的 SHA-256 必须与你发布镜像时记录的值一致。不要为了“能下载”就跳过完整性校验。

方案 C：只检测，不执行卸载

如果已经把项目上传到服务器，但暂时只想看看装了什么：

python3 cloud_agent_cleaner.py --audit

脚本实际会做什么？

阿里云 ECS 实机测试中遇到的几个真实情况

这个项目不是只按文档“猜”路径，我在多台阿里云 ECS 上实际测试过不同镜像状态，遇到过几种很典型的情况。

这个脚本刻意不做什么？

• 不会看到“像云软件的名字”就直接批量 rm -rf。
• 不会默认删除 OCI、Azure、GCP 的关键 Guest Agent。
• 不会删除 cloud-init、qemu-guest-agent 和虚拟化/存储/网卡驱动。
• 不会把“目录存在”等同于“进程正在运行”。
• 不会因为官方卸载脚本报错就假装已经卸载成功。
• 不会使用类似 /usr/local/aegis* 这种过宽的通配符清理。

需要说明的是：删除 Guest OS 内的 Agent，并不意味着云厂商失去了对宿主机、VPC、云盘、实例控制面或基础监控的管理能力。 这个工具处理的是你虚拟机操作系统内部可以识别到的 Agent。

如何判断是否清理成功？

最理想的最终输出类似：

Post-action verification
[OK] aliyun.assistant: not detected.
[OK] aliyun.monitor: not detected.
[OK] aliyun.security: not detected.
[OK] Completed with 0 warning(s).

如果看到 residuals detected、still has active service/process evidence 或 uninstall incomplete，说明脚本检测到了残留，不应把这次操作当成成功。

想再次确认，可以重新运行同一条一键命令。已经清理干净的组件应该显示：

aliyun.assistant   not-found
aliyun.monitor     not-found
aliyun.security    not-found

常见问题