若要从Plesk for Linux、cPanel、Confixx或Pro Control Panel 迁移到 Plesk for Linux 服务器，请如下操作：

  1. 通过 SSH 登录到目的 Plesk 服务器。

  2. 请确保安装了 Plesk Migrator。若未安装，请根据 此处 的说明进行安装。

  3. 从 /usr/local/psa/admin/plib/modules/panel-migrator/backend/conf/samples/ 目录复制配置文件样本到 /usr/local/psa/var/modules/panel-migrator/conf/ 目录。请选择以下当中的一个样本文件：

    1. plesk-unix.simple.ini 、 cpanel.simple.ini 、 confixx.simple.ini 和 ppcpl.simple.ini 样本是基本的，只包含迁移所需的最少信息。

    2. plesk-unix.ini, cpanel.ini 、 confixx.ini 和 ppcpl.ini 是比较全面且较好注释的配置文件，能够配置更广泛的迁移选项。

    为了您的方便，可 在此 找到配置文件样本的内容。复制该文件后，将其重命名为 config.ini 。

  4. 编辑 config.ini 文件指定源和目的服务器的 IP 地址，以及源服务器 root 用户的 SSH 密码（迁移必需的最少量信息）。您还可以指定其它的设置 - 请参阅 编辑 Plesk Migrator 配置文件 主题了解更多详情。

  5. 运行以下命令生成迁移列表：

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list

    生成的文件将被命名为 migration-list 且被放置于 /usr/local/psa/var/modules/panel-migrator/sessions/migration-session/ 目录中。迁移列表包含要迁移的一系列对象（客户和代理商帐户、服务方案、域名，等等）。

  6. 编辑迁移列表。您可以移除您不想迁移的域名，分配您要迁移给服务方案的域名，或在客户帐户之间重新分配域名。

  7. 如果您想要手动分配地址，请指定网站应使用的新 IP 地址。默认会自动执行 IP 映射。您可以在 此处 了解有关 IP 映射的详情。

  8. 运行以下命令执行迁移前检查：

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator check

    运行命令将会引起一系列您在迁移过程中可能会遇到的潜在问题。每次更改迁移列表时都必须要执行 “check” 命令。

  9. 运行以下命令开始迁移：

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts

  10. （推荐）迁移完成后，运行以下命令检查目的服务器上迁移过来的对象的可操作性：

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator test-all

若要从Plesk for Windows 或 Helm 3 迁移到 Plesk for Windows 服务器：

  1. 通过 RDP 登录到目的 Plesk 服务器并打开命令提示。

  2. 请确保安装了 Plesk Migrator。若未安装，请根据 此处 的说明进行安装。

  3. 从 %plesk_dir%admin\plib\modules\panel-migrator\backend\conf\samples\ 目录复制配置文件样本到 <PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\conf\ 目录。若要在服务器上找到 <PLESK_DATA_DIRECTORY> 的位置，请运行以下命令：

    reg query "HKLM\SOFTWARE\Plesk\PSA Config\Config" /v PRODUCT_DATA_D /reg:32

    请选择以下当中的一个样本文件：

    1. The plesk-windows.simple.ini 样本是基础文件只包含迁移必需的最少量信息。

    2. The plesk-windows.ini 样本是全面且注释好的配置文件，能够配置不同的迁移选项。

    为了您的方便，可 在此 找到配置文件样本的内容。复制该文件后，将其重命名为 config.ini 。

  4. 编辑 config.ini 文件指定源和目的服务器的 IP 地址，以及源服务器管理员用户的密码（迁移必需的最少量信息）。您还可以指定其它的设置 - 请参阅 编辑 Plesk Migrator 配置文件 主题了解更多详情。

  5. 运行以下命令生成迁移列表：

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat generate-migration-list

    生成的文件将被命名为 migration-list 且被放置于 <PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\sessions\migration-session\ 目录中。迁移列表包含要迁移的一系列对象（客户和代理商帐户、服务方案、域名，等等）。

  6. 编辑迁移列表。您可以移除您不想迁移的域名，分配您要迁移给服务方案的域名，或在客户帐户之间重新分配域名。

  7. 如果您想要手动分配地址，请指定网站应使用的新 IP 地址。默认会自动执行 IP 映射。您可以在 此处 了解有关 IP 映射的详情。

  8. （推荐）运行以下命令执行迁移前检查：

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat check

    运行命令将会引起一系列您在迁移过程中可能会遇到的潜在问题。

  9. 运行以下命令开始迁移：

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat transfer-accounts

  10. （推荐）迁移完成后，运行以下命令检查目的服务器上迁移过来的对象的可操作性：

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat test-all

Using command‑line options with Plesk Migrator

When migrating via the command line, you can pass additional options to the plesk-migrator executable. These options allow you to control logging, profiling, data fetching, content transfer, licensing checks, and more.

To view all available options at any time, run:

plesk-migrator check --help

Common options:

Option

Description

-h, --help

Show help and exit.

--async

Run the command asynchronously.

--quiet

Hide log entries in console output.

--debug

Increase debug level.

--disable-profiling / --enable-profiling

Disable or enable writing the profiling report.

--stop-mark-file <file>

Path to a file whose creation triggers a safe shutdown.

--progress-task-id <id>

Use a specific progress task ID.

Migration behavior options:

Option

Description

--ignore-pre-migration-errors

Continue migration even if pre-migration errors occur (intended for Plesk Support only).

--allocate-only-required-resourcesc

Create new webspaces using only the resources required by the corresponding subscriptions.

--reload-source-data

Fetch data again from the source instead of using cached data.

--skip-services-checks

Do not check the source or target services for potential issues.

--skip-license-checks

Skip license validation on the target server.

Migration list options:

Option

Description

--migration-list-file <file>

Specify the migration list file (default: $session_dir/migration-list).

--migration-list-format <text|json>

Migration list format (text by default).

--ignore-migration-list-errors

Continue the migration even if the migration list contains errors.

IP mapping:

Option

Description

--ip-mapping-file <file>

Provide a file that maps source IPs to target IPs.

Content transfer options:

Option

Description

--skip-copy-web-content

Do not transfer web files.

--skip-copy-mail-content

Do not transfer email messages.

--skip-copy-db-content

Do not transfer database content.

Additional cCopy options:

Option

Description

--copy-mail-settings

Copy server-wide mail settings (supported on Plesk 12.0 and later).

--copy-admin-profile

Copy admin profiles (supported on Plesk 12.0 and later).

--install-extensions

Install missing extensions (supported on Plesk 17.0 and later).

--copy-extensions-settings

Copy server-wide extension settings (supported on Plesk 17.0 and later).