Ubuntu 20.10下免重装Bitnami迁移WordPress项目至其他计算机的实现方法

（适用场景：源端为Ubuntu 20.10环境下部署的Bitnami WordPress栈，目标端为同版本Ubuntu 20.10系统）

源端操作步骤 #

• 停掉源端所有Bitnami关联服务，避免迁移过程中数据库、文件处于写入状态导致数据不一致，执行命令：
  sudo /opt/bitnami/ctlscript.sh stop all
  若你的Bitnami栈不在默认/opt/bitnami路径，替换为实际的栈安装路径即可。
• 记录源端关键系统参数，后续新机器配置需要完全对齐：
  • 执行id bitnami、id daemon记录两个内置用户的UID、GID数值
  • 检查/opt/bitnami目录下的整体文件权限、核心目录的属主归属（如MySQL数据目录、WordPress站点根目录的属主）
• 对整个Bitnami栈目录做完整打包压缩，必须保留文件原始权限，执行命令：
  sudo tar -pczf bitnami-wordpress-migrate.tar.gz /opt/bitnami
  参数-p的作用是留存原文件的读、写、执行权限及属主信息，避免迁移后出现权限错位导致服务无法启动。

新机器前置准备 #

• 确保新机器的操作系统版本为Ubuntu 20.10，和源端完全一致。Bitnami栈内置的所有服务二进制文件是和系统glibc版本强绑定的，跨大版本系统启动会直接报二进制无法执行的错误。
• 不要在新机器上安装任何版本的Bitnami WordPress安装包，只需要安装系统层面的基础共享库依赖，执行命令：
  sudo apt install libapr1 libaprutil1 libmysqlclient20 libzip5 libpng16-16 libjpeg8 libfreetype6
  这些是栈内Apache、MySQL、PHP运行必须的系统级共享库，缺少任意一个都会导致服务启动失败。
• 在新机器上创建和源端记录的UID、GID完全一致的bitnami、daemon系统用户，避免解压后的文件属主和实际系统用户不匹配。

迁移落地操作 #

• 将源端生成的bitnami-wordpress-migrate.tar.gz压缩包拷贝到新机器的临时目录下。
• 在新机器上创建/opt/bitnami目标路径，执行解压命令将备份包还原到系统根路径：
  sudo tar -xzpzf bitnami-wordpress-migrate.tar.gz -C /
  解压完成后检查目录结构，确认所有文件完整落在/opt/bitnami路径下，不存在多层路径嵌套的问题。
• 按照之前源端记录的权限信息，对齐/opt/bitnami全目录的文件属主与权限：
  sudo chown -R bitnami:bitnami /opt/bitnami
  单独修正MySQL数据目录（默认/opt/bitnami/mysql/data）的属主为对应mysql运行用户，避免数据库因权限不足无法启动。

启动与校验 #

• 执行命令启动全栈服务：
  sudo /opt/bitnami/ctlscript.sh start all
  等待30秒后查看服务运行状态：
  sudo /opt/bitnami/ctlscript.sh status
  确认返回结果中Apache、MySQL、PHP-FPM三个核心服务均为running状态。
• 本地访问http://localhost，验证WordPress后台登录、文章列表加载、媒体库图片显示、链接跳转、表单提交等核心功能是否正常。因为是本地同环境迁移，wp-config.php内的数据库连接信息、站点域名地址均和原配置完全一致，不需要做额外修改。

常见问题排查提示

• 若Apache启动提示端口被占用，直接修改/opt/bitnami/apache/conf/httpd.conf内的监听端口为系统空闲端口即可
• 若MySQL启动失败，优先检查/opt/bitnami/mysql/data目录的权限，禁止出现root用户作为该目录属主的情况
• 若WordPress提示数据库连接失败，检查/opt/bitnami/apps/wordpress/htdocs/wp-config.php内的数据库主机地址，确认和栈内MySQL的实际监听地址匹配

内容的提问来源于stack exchange，提问作者Sourav Pal