CentOS 7 VPS安装cPanel提示需纯净系统报错问题咨询

问题场景 #

在CentOS 7 VPS上执行cPanel官方安装脚本：
cd /home && curl -o latest -L https://securedownloads.cpanel.net/latest && sh latest
运行后返回报错：

2022-06-23 10:31:17  367 [3558] (ERROR): The installation process found evidence that the following control panels were installed on this server:
2022-06-23 10:31:17  368 [3558] (ERROR): cPanel & WHM
2022-06-23 10:31:17   44 [3558] ( INFO): cPanel is here to help! Our Technical Support team is just a click away at https://support.cpanel.net/ or you can contact Customer Service via email cs@cpanel.net
2022-06-23 10:31:17  369 [3558] (FATAL): You must install cPanel & WHM on a clean server.

重装纯净操作系统、确认无预装内容后，再次运行脚本仍然触发相同报错。

故障根因 #

cPanel安装程序的残留检测逻辑不止扫描系统已装软件列表，还会校验三类标记：

• 本地目录下的cPanel残留文件
• 主机名、网卡MAC地址绑定的历史cPanel安装记录
• 未格式化的数据分区内留存的旧cPanel标识
  大部分VPS服务商重装系统时仅格式化系统根分区，不会清空单独挂载的/home等数据分区，部分服务商提供的默认镜像还会残留cPanel相关yum源配置，这些都会触发安装程序的误判。

修复步骤 #

按顺序执行以下操作后重启服务器，再重新运行安装脚本即可：

• 更换全新主机名，不要使用历史上绑定过cPanel实例的名称，也不要使用默认localhost，执行命令：
  hostnamectl set-hostname 自定义全新主机名
• 删除本地所有cPanel残留目录，执行命令：

  rm -rf /var/cpanel
  rm -rf /usr/local/cpanel
  rm -rf /home/cpanel*
  

• 检查分区挂载情况，如果/home为单独挂载的数据分区，先备份分区内有效数据后格式化该分区，再重新挂载，清除分区内留存的旧安装文件。
• 清理yum源内的cPanel残留配置，执行命令：
  yum clean all && rm -rf /etc/yum.repos.d/cpanel*

注意：所有删除、格式化操作前请确认服务器内无需要留存的业务数据，避免操作造成数据丢失。

内容的提问来源于stack exchange，提问作者Adnan Shaikh