背景
在一台已经部署了网站的 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
缺失或未能正常运行。按照本文流程,即可手动恢复服务,无需重装面板或中断现有网站运行。