如何将Cpanel站点根目录从public_html指向/var/www/html

前置说明 #

cPanel默认站点根目录为/home/[你的cPanel用户名]/public_html，要修改为/var/www/html可根据是否有服务器root权限选择对应操作：

方法1：持有服务器root权限（适用于VPS、独立服务器） #

操作全程在SSH终端执行：

• 进入cPanel用户站点配置目录，将下方[cPanel用户名]、[你的站点域名]替换为实际值：

  cd /var/cpanel/userdata/[cPanel用户名]/
  

• 编辑域名对应的配置文件：

  vi [你的站点域名]
  

  找到以下参数修改为目标路径：

  documentroot: /var/www/html
  scriptalias:
    - path: /cgi-bin/
      uri: /var/www/html/cgi-bin/
  

• 保存文件后重建Apache配置：

  /scripts/rebuildhttpdconf
  

• 重启Apache服务生效：

  /scripts/restartsrv_httpd
  

• 配置目录权限，避免出现403、文件无法执行问题：

  chown -R [cPanel用户名]:[cPanel用户名] /var/www/html
  find /var/www/html -type d -exec chmod 755 {} \;
  find /var/www/html -type f -exec chmod 644 {} \;
  

方法2：无服务器root权限（适用于虚拟主机用户） #

附加域/子域名修改 #

直接在cPanel面板操作即可：

• 登录cPanel后台，进入「域」板块的「附加域」或「子域名」管理页
• 找到需要修改的域名，点击编辑按钮
• 在文档根目录输入框填写/var/www/html，保存即可生效

主域名修改 #

cPanel默认不支持面板直接修改主域名根目录，可通过软链接映射实现：

• 进入cPanel的「终端」工具，或者通过SSH登录到用户目录，执行命令：

  rm -rf ~/public_html
  ln -s /var/www/html ~/public_html
  

• 编辑/var/www/html目录下的.htaccess文件，添加以下配置开启软链接支持：

  Options +FollowSymLinks
  

注意：该方法需要主机商开放了cPanel用户对/var/www/html目录的访问权限，否则会出现权限错误。

原有public_html文件无法执行问题排查 #

如果改回原路径仍有执行问题，按以下顺序排查：

• 检查文件权限是否为777，cPanel安全规则会拦截权限过高的文件执行，修改为644即可
• 检查文件所有者是否为当前cPanel用户，若为root所有者需修改为对应用户
• 检查cPanel的PHP版本配置是否和程序要求匹配，不兼容的PHP版本会导致脚本无法执行

内容的提问来源于stack exchange，提问作者Swift Solutions