CloudPanel 监控无数据问题排查 & 手动恢复 clp-agent 完整实录

by

zhipeng

背景

在一台已经部署了网站的 CloudPanel 服务器中,发现控制面板中的 Monitoring 页面不显示任何数据
手动执行 systemctl restart clp-agent 报错:

Failed to restart clp-agent.service: Unit clp-agent.service not found.

同时也无法在系统中找到 clp-agent 可执行文件。

排查步骤

1. 检查 systemd 是否存在 clp-agent 服务

systemctl list-units | grep clp-agent

→ 没有找到,说明服务未注册。

2. 查找 clp-agent 可执行文件是否存在

which clp-agent
find / -type f -name "clp-agent" 2>/dev/null

→ 也未找到,初步判断是安装不完整或后续被意外删除。

解决方案:从 .deb 包中恢复 clp-agent

步骤 1:下载并解压 CloudPanel 安装包

apt download cloudpanel
dpkg-deb -x cloudpanel_*.deb clp-extracted

步骤 2:提取 clp-agent 可执行文件

找到路径:

clp-extracted/tmp/cloudpanel/data/clp-agent/bin/x86_64/clp-agent

复制到系统目录:

cp clp-extracted/tmp/cloudpanel/data/clp-agent/bin/x86_64/clp-agent /usr/bin/clp-agent
chmod +x /usr/bin/clp-agent

补充:恢复 systemd 服务文件

CloudPanel 包中也包含了官方的 .service 文件:

clp-extracted/tmp/cloudpanel/data/clp-agent/systemd/clp-agent.service

复制到系统目录:

cp clp-extracted/tmp/cloudpanel/data/clp-agent/systemd/clp-agent.service /lib/systemd/system/

修正执行路径(关键)

.service 中使用的是

ExecStart=/usr/sbin/clp-agent

我们之前放在 /usr/bin/,为了避免未来升级或兼容问题,采用 ✅ 官方标准路径方式

cp /usr/bin/clp-agent /usr/sbin/clp-agent
chmod +x /usr/sbin/clp-agent

启动服务

systemctl daemon-reload
systemctl enable clp-agent
systemctl start clp-agent
systemctl status clp-agent

确认运行状态无报错:

journalctl -u clp-agent -n 50 --no-pager

成功验证:监控数据恢复!

刷新 CloudPanel 的 Monitoring 页面,数据恢复显示,问题彻底解决。

如果你也遇到 CloudPanel Monitoring 无数据的问题,很有可能是 clp-agent 缺失或未能正常运行。按照本文流程,即可手动恢复服务,无需重装面板或中断现有网站运行。

相关文章

发表评论