1. 安装 GetDropFlow

GetDropFlow 是装在你自己 Magento 商店里的插件。安装一次，之后所有操作都在 Magento 后台里完成。

开始之前

你需要：

• Magento 开源版 2.4.9 和 PHP 8.4 或更高。
• 一位会用服务器命令行的人（你的开发人员或主机商客服）。
• 你的商店后台必须是 https:// 开头（地址栏有小锁）。没有 https，连接速卖通后它无法跳回你的后台。
• Magento 的定时任务（cron）必须在运行（每个 Magento 商店都需要）。没有它，你发布的商品不会出现在前台。

如果你的服务器 MySQL 开了"二进制日志"，Magento 自己的安装程序可能会停在这句："You do not have the SUPER privilege and binary logging is enabled"。请让主机商允许它（设置名是 log_bin_trust_function_creators）。

第 1 步 — 把安装包放到服务器

你下载的 GetDropFlow 是一个装着多个 .zip 的文件夹。把整个文件夹上传到服务器，例如 /home/you/getdropflow-packages。

第 2 步 — 安装（由你的开发人员输入）

composer config repositories.getdropflow artifact /home/you/getdropflow-packages
composer require "dropshipkit/getdropflow:^X.Y.Z"
bin/magento module:enable DropshipKit_Catalog DropshipKit_Orders DropshipKit_Shipping DropshipKit_Core DropshipKit_Admin
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento deploy:mode:set production
bin/magento setup:static-content:deploy -f en_US es_ES zh_Hans_CN
bin/magento cache:flush

把 X.Y.Z 换成你下载的 zip 的版本号：就是 zip 文件名里的那个数字，也是 BUILD-INFO.txt 的第一行。不要照抄本页的版本号。 语言：请填写你的店铺视图实际使用的语言（en_US es_ES zh_Hans_CN 只是示例）。缺了某种语言，该语言的前台页面（商品页、结账页）会坏掉。 不用 Composer？下载里还有一个"手动安装"zip：在 Magento 目录里解压，再执行上面六行 bin/magento。 解压后，Magento 根目录（和 composer.json 放在一起）会多出三个文件：BUILD-INFO.txt、INSTALL.md、VERSION。这是正常的，没有程序读取它们。想知道装的是哪个版本，打开 BUILD-INFO.txt，第一行就是版本号。

第 3 步 — 检查是否成功

登录 Magento 后台，你应该看到：

• 目录下新增三项：选品、导入列表、定价规则。
• 新的顶层菜单 GetDropFlow，里面有 设置、风险设置、订单、日志。

升级到新版本

手动安装：必须先删除旧的五个模块文件夹（app/code/DropshipKit/Admin、Catalog、Core、Orders、Shipping），然后再解压新包。直接解压覆盖旧文件的话，新版本已经没有的旧文件会留在里面。完整步骤（包括 Composer 方式）见 INSTALL.md 的"升级"一节。

升级时，module:enable 可能会打印 generated/code/Magento cannot be deleted，可以忽略，不影响升级。

下一步

看第 2 篇：输入授权 Key，连接速卖通。

---

中文由 AI 直译起草，待母语审校。