数据传输 Data transfer

strapi transfer 命令将您的数据从一个 Strapi 实例传输到另一个 Strapi 实例。transfer 命令使用严格的架构匹配，这意味着您的两个 Strapi 实例需要是彼此的精确副本，但所包含的数据除外。默认的 transfer 命令会传输您的内容（实体和关系）、文件（资产）、项目配置和架构。该命令允许您传输数据：

• 从本地 Strapi 实例到远程 Strapi 实例
• 从远程 Strapi 实例到本地 Strapi 实例

CLI 命令由以下参数组成：

server {
    listen 80;
    server_name <yourdomain>;
    location / {
        proxy_pass http://localhost:1337;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        include proxy_params;
    }
}

生成传输令牌

strapi transfer 命令需要目标实例颁发的传输令牌。要在管理面板中生成传输令牌，请使用 用户指南 中的说明。

设置并运行数据传输

启动数据传输取决于您是要将数据推送到远程实例还是从远程提取数据：

将数据推送到远程

1. 启动目标实例的 Strapi 服务器。
2. 在新的终端窗口中，导航到源实例的根目录。
3. 运行以下最小命令来启动传输，确保 destinationURL 是管理面板的完整 URL（即 URL 包含 /admin 部分）：
   yarnnpm

   bash

   yarn

   bash

   yarn strapi transfer --to destinationURL
   

4. 出现提示时添加传输令牌。
5. 对 CLI 提示回答 是 或 否：“传输将删除所有远程 Strapi 资产及其数据库。您确定要继续吗？”

从远程提取数据

1. 启动源实例的 Strapi 服务器。
2. 在新的终端窗口中，导航到目标实例的根目录。
3. 运行以下最小命令来启动传输，确保 remoteURL 是管理面板的完整 URL（即 URL 包含 /admin 部分）：
   yarnnpm

   bash

   yarn

   bash

   yarn strapi transfer --from remoteURL
   

4. 出现提示时添加传输令牌。
5. 对 CLI 提示回答 是 或 否：“传输将删除所有本地 Strapi 资产及其数据库。您确定要继续吗？”。

绕过所有 transfer 命令行提示

使用 strapi transfer 命令时，您需要确认传输将删除现有数据库内容。--force 标志允许您绕过此提示。此选项对于以编程方式实现 strapi transfer 很有用。如果使用 --force 选项，则必须将 to-token 选项与转移令牌一起传递。

示例：使用 --force 绕过 transfer 命令行提示

yarn strapi transfer --to https://example.com/admin --to-token my-transfer-token --force

传输期间仅包含指定的数据类型

默认的 strapi transfer 命令会传输您的内容（实体和关系）、文件（资产）、项目配置和架构。--only 选项允许您通过传递逗号分隔的字符串（类型之间没有空格）来仅传输列出的项目。可用值为 content、files 和 config。架构始终会被传输，因为 strapi transfer 使用架构匹配。

示例：仅传输文件

yarn strapi transfer --to https://example.com/admin --only files

在传输过程中排除数据类型

默认的 strapi transfer 命令会传输您的内容（实体和关系）、文件（资产）、项目配置和架构。--exclude 选项允许您通过将这些项目传递到逗号分隔的字符串中（类型之间没有空格）来排除内容、文件和项目配置。您无法排除架构，因为 strapi transfer 使用架构匹配。

示例：从传输中排除文件

yarn strapi transfer --to https://example.com/admin --exclude files

使用环境变量管理数据传输

环境变量 STRAPI_DISABLE_REMOTE_DATA_TRANSFER 可用于禁用远程数据传输。除了管理面板中的 RBAC 权限 之外，这还可以帮助您保护 Strapi 应用程序。要使用 STRAPI_DISABLE_REMOTE_DATA_TRANSFER，您可以将其添加到 .env 文件中或在 start 脚本前添加。请参阅以下示例：

STRAPI_DISABLE_REMOTE_DATA_TRANSFER=true yarn start

有关在 Strapi 中使用环境变量的更多详细信息，请参阅 环境配置文档。

在本地测试传输命令

transfer 命令不用于在两个本地实例之间传输数据。export 和 import 命令就是为此目的而设计的。但是，您可能希望在测试实例上本地测试 transfer，以便在将其与远程实例一起使用之前更好地了解该功能。以下文档提供了 transfer 过程的完整示例。

创建并克隆新的 Strapi 项目

1. 使用安装命令创建一个新的 Strapi 项目：
   bash

   npx create-strapi-app@latest <project-name> --quickstart
   

2. 在项目中创建至少 1 个内容类型。如果您需要有关创建第一个内容类型的说明，请参阅 快速入门指南。

   在此步骤中，请勿向您的项目添加任何数据。

3. 将项目提交到 git 存储库：
   bash

   git init
   git add 。
   git commit -m "first commit"
   

4. 克隆项目存储库：
   bash

   cd .. # 移动到父目录
   git clone <path to created git storage>.git/ <new-instance-name>
   

向第一个 Strapi 实例添加数据

1. 返回第一个 Strapi 实例并将数据添加到内容类型。
2. 停止第一个实例上的服务器。

创建转移令牌

1. 导航到第二个 Strapi 实例并在根目录中运行 build 和 start 命令：
   yarnnpm

   bash

   yarn

   bash

   yarn build && yarn start
   

2. 注册管理员用户。
3. 创建并复制转移令牌。
4. 让服务器保持运行。

传输数据

1. 返回第一个 Strapi 实例。
2. 在终端中运行 strapi transfer 命令：
   yarnnpm

   bash

   yarn

   bash

   yarn strapi transfer --to http://localhost:1337/admin
   

3. 出现提示时，应用传输令牌。
4. 传输完成后，您可以返回第二个 Strapi 实例并查看内容是否已成功传输。