You need to enable JavaScript to run this app. 如何使用HostGator cPanel下载的备份文件在本地搭建WordPress站点
优惠活动
大模型
产品
解决方案
定价
更多

如何使用HostGator cPanel下载的备份文件在本地搭建WordPress站点

HostGator备份迁移到本地/树莓派托管WordPress的实操步骤

第一步:整理解压cPanel下载的两类备份文件

  • 分别解压你下载的cPanel完整备份、主目录单独备份,不要直接把cPanel完整备份整体导入本地环境。cPanel完整备份是整套虚拟主机的打包文件,需要从中提取两个核心内容:
    1. 站点文件:找到包内home/你的cPanel用户名/路径下的public_html文件夹全部内容,这部分和你单独下载的主目录备份内容完全一致,留一份即可,避免重复覆盖打乱文件权限
    2. 数据库导出文件:在完整备份包的mysql/路径下,找到对应站点的数据库导出文件。这是绝大多数迁移失败的核心原因:cPanel的主目录备份不会包含数据库内容,只拿站点文件肯定没法还原完整站点
  • 如果数据库导出文件是.mysql.gz或.sql.gz格式,先在本地解压成纯文本的.sql文件,不要等到导入环节再让环境自动解压,容易触发文件大小限制报错。

第二步:匹配本地已安装的WordPress环境

  • 打开你本地已装好的WordPress根目录:PC端一般为本地Web服务目录下的对应站点文件夹,比如www/站点名/;树莓派端一般为/var/www/html/站点名/。把目录里除了wp-config.php之外的所有文件、文件夹全部清空
  • 把之前从备份里提取的public_html内的所有文件,原封不动拷贝到这个本地WP根目录下
  • 核心注意点:绝对不要用HostGator备份里自带的wp-config.php覆盖你本地新建WP的配置文件。HostGator版本的配置文件里写的是远程主机的数据库连接参数,直接覆盖会导致本地数据库连接失败。只需要确认你本地原有的wp-config.php内的数据库名、账号、密码,和你提前在本地建好的空数据库参数完全匹配即可。

第三步:导入数据库并修正站点访问参数

  • 打开本地数据库管理面板(phpMyAdmin、MySQL/MariaDB命令行均可),找到给本地WP准备的空数据库,清空所有新装WP生成的默认数据表
  • 把解压好的.sql备份文件导入到这个空数据库。如果触发大文件导入限制,直接调整本地PHP配置里的upload_max_filesize、post_max_size参数,调到比你的sql文件大2倍即可,不需要折腾分卷导入的复杂操作,本地环境没有虚拟主机的资源限制。
  • 导入完成后打开wp_options表,找到siteurl和home两个字段,把原来存储的HostGator公网域名,修改为你现在本地/树莓派的实际访问地址:
    • PC本地访问:填写本地访问地址,比如http://localhost/站点名
    • 树莓派局域网托管:填写树莓派的局域网固定IP,比如http://192.168.1.100
      如果不修改这两个参数,打开站点会自动跳转到HostGator上的旧公网地址。
  • 最后批量替换数据库里的旧域名残留:遍历wp_posts、wp_postmeta、wp_options表内所有和旧公网域名匹配的字段值,统一替换为现在的新访问地址,否则站点内的图片、文章内链会全部出现404。注意不要用通用的字符串替换工具操作,避免弄坏WordPress存储的序列化数据。

第四步:常见故障快速排查

  • 打开站点提示数据库连接错误:优先检查wp-config.php里的数据库账号、密码权限是否和本地数据库匹配,排查是否不小心用HostGator的旧配置文件覆盖了本地配置
  • 站点样式完全错乱、图片无法加载:检查wp_options表内的siteurl和home参数是否修改正确,确认数据库内的旧域名替换没有遗漏
  • 后台管理员密码无法登录:旧数据库内存储的是你在HostGator上设置的账号密码,如果遗忘,直接在wp_users表内给对应管理员账号设置新的MD5加密密码即可,不需要从全新安装的WP里覆盖用户表
  • 树莓派上操作提示文件无写入权限:把所有站点文件的所有者修改为Web服务的运行用户www-data,不要保留SSH登录用户的默认权限。

内容的提问来源于stack exchange,提问作者Sid

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 18:27:01