从 cPanel 迁移网站到 KapsuleHost

大多数人从 cPanel 迁移网站时无需手动操作任何文件：Kapsule 提供了一个引导式迁移功能，可以为您复制文件和数据库，同时保持旧网站持续运行。本指南涵盖三种迁移路径、如何选择以及手动迁移方案（适用于您希望自己操作的情况）。

每个计划上的迁移都是免费的。没有设置费用，也没有按网站计费。

开始之前

准备好以下内容：

• 该网站当前运行的域名。
• 对网站 WordPress 管理员界面、cPanel 或 FTP 登录的访问权限。
• 域名注册商登录凭证，用于最后一步。
• 带有免费网站槽位的 Kapsule 托管计划。

选择迁移路径

在 KPanel 左侧边栏打开迁移，点击进入网站迁移，然后输入您当前网站地址。Kapsule 会检查该网站、识别平台，并提供三条路径。

这三种方式都是免费的，您可以在向导的任何点切换。

插件路径

1. 选择 Kapsule Migrator Plugin。
2. 从屏幕上下载 kapsule-migrator.zip。
3. 在您当前的网站上，进入插件，然后安装插件，然后上传插件。上传 zip 文件并激活。
4. 在 WordPress 管理菜单中打开 Kapsule Migrate。
5. 从 KPanel 复制令牌，粘贴到插件中，然后单击开始迁移。

KPanel 会自动检测连接并将您移至实时进度屏幕。文件、数据库和上传内容会为您复制。令牌 24 小时后过期；如果需要，可从同一屏幕生成新令牌。

凭证路径

选择托管凭证并填写两个部分：FTP、SFTP 或 SSH 详情（主机名、用户名、密码）和数据库详情（主机、名称、用户名、密码）。有一个备注字段可供填写任何其他帮助信息，例如您的 cPanel 地址。

团队路径

告诉我们网站信息和您希望的时间。迁移工程师会在四个工作小时内回复一个计划，在您批准之前不会上线任何内容。

接下来会发生什么

无论您选择哪条路径，流程都是相同的：

1. 复制在后台运行。您现有网站始终保持在线且不变。
2. 您的新网站在临时地址上可供审查。
3. 您检查并批准。
4. 只有这样 DNS 才会更改。

Kapsule 会在迁移后 7 天内保留您的原始文件，因此如果几天后出现问题，可以回滚。

切换前的审查

这是值得认真对待的一步，因为 DNS 移动后，每个访问者都会看到您批准的内容。

加载临时地址并检查：

• 主页和两三个深层页面。
• 图像，包括滑块或图库中的任何内容。
• 任何联系或预订表单，进行真实提交。
• 登录管理员，并保存一次编辑。
• 在商店上：通过确认页面完成一整个测试订单。

如果某些 URL 仍指向旧域，运行搜索和替换：运行搜索和替换。

指向您的域名

审查完成后，移动域名。要么将您的名称服务器更改为 Kapsule 的（更简单的选项，将 DNS 管理带入 KPanel），要么保持现有 DNS 提供商并重新指向网站的记录。

完整说明请见更改您的名称服务器和将自定义域连接到您的网站。

DNS 更改从几分钟到几小时才能到达所有用户。在这个时间窗口内，一些访问者仍会登陆旧主机，这正是您保持旧托管运行的原因。

手动迁移

如果您想自己操作，或网站不在支持的平台上，手动路由仍然有效。

1. 创建网站

网站，然后添加网站，然后新网站。选择与您迁移的网站类型匹配的网站类型。该网站在您可以立即测试的临时地址上进行配置。参见创建您的第一个网站。

2. 从 cPanel 导出

下载网站文件，通过 cPanel 的文件管理器或 FTP。对于 WordPress，这是 public_html 下的所有内容，包括 wp-config.php。如果您愿意，cPanel 的备份向导可以将整个内容作为单个下载。

然后导出数据库：在 cPanel 中打开 phpMyAdmin，选择数据库，使用导出，然后快速，然后执行。

3. 上传文件

1. 在 KPanel 中，打开您的新网站，然后文件，然后SFTP。
2. 在SFTP 账户下，输入用户名并单击创建。
3. 复制显示的主机、端口、用户名和密码。密码仅显示一次，之后无法恢复。
4. 使用任何 SFTP 客户端连接并将您的文件上传到网站目录。

关于 SFTP 账户和本地 SSH 访问的详细信息，请参阅通过 SFTP 连接。

4. 导入数据库

1. 打开网站，然后文件，然后数据库。
2. 单击打开 phpMyAdmin。您会自动登录，无需单独密码。
3. 选择您的数据库，单击导入，选择 .sql 文件，然后单击执行。

有关导入限制和处理大型转储的方法，请参阅使用 phpMyAdmin 访问您的数据库。

5. 更新 wp-config.php

数据库标签列出新的连接详情。使用文件然后文件管理器将其复制到 wp-config.php 中：

define( 'DB_NAME', 'your-new-database-name' );
define( 'DB_USER', 'your-new-database-user' );
define( 'DB_PASSWORD', 'your-new-password' );
define( 'DB_HOST', '127.0.0.1' );

6. 测试，然后重新指向

加载临时地址，完成上面的审查列表，然后指向您的域。

故障排除

网站加载但没有样式。 数据库中的旧绝对 URL。运行从旧地址到新地址的搜索和替换。

"建立数据库连接错误"。 wp-config.php 中的凭证与数据库标签不匹配。检查 DB_HOST 是否为 127.0.0.1。

数据库导入中途失败。 转储大于 phpMyAdmin 的上传限制。将其压缩为 .sql.gz，拆分为较小的文件，或开一个工单，我们会为您导入。

迁移后某些页面出现 404。 刷新重写规则：WordPress，然后快速操作，然后刷新重写。参见修复 WordPress 永久链接问题。

挂锁丢失或显示警告。 数据库中仍有 HTTP URL 的混合内容：修复混合内容警告。