关于 Medusa
Medusa 是用 Node.js 和 TypeScript 构建定制商城与电商服务的可组合电商平台。其 modules 与 workflows 覆盖商品、购物车、订单、促销、支付、履约和定制业务流程，但不强制指定前台。
Medusa 后端通常使用 Node.js 和 PostgreSQL，并在后端来源的 `/app` 提供 Admin。只有后端配置了 Redis 支持的基础设施时才需要 Redis；简单的 v2 开发可以使用本地 provider。定制 storefront 存在时才是独立应用；支付、履约、搜索和文件存储等 provider 应按当前开发的集成运行或模拟。
核心能力
- Commerce Modules
- Workflows
- Store APIs
- Admin APIs
- 促销引擎
- Provider Interfaces
常见使用场景
- 定制电商后端
- 无头商城前台
- 市场与多商户扩展
- 订阅或 B2B 电商
- 履约与支付集成
Medusa 本地开发协调电商服务与 providers
只有呈现选定的数据、缓存和 provider 边界时，商品流程才具有可信度。
- Node.js Medusa 后端
- 运行 Medusa CLI、商城 API 和项目定制 workflows。
- PostgreSQL
- 保存电商实体，是 Medusa 后端的标准依赖。
- Redis
- 只有后端配置 Redis 支持的基础设施时才运行；简单的 v2 开发可以使用本地 provider。
- 内置 Admin 与定制 storefront
- 使用后端的 `/app` Admin（例如 `localhost:9000/app`）；只有定制 storefront 才运行独立 Node.js 开发服务器。
- 电商 Providers
- 对支付、履约、搜索和文件 provider 使用 sandbox 或本地替代实现。
典型本地技术栈
具体服务取决于项目、发布版本及本地配置。这里展示的是常见配置，而非固定要求。
| 组件 | 典型作用 |
|---|---|
| Node.js | 用于本地 Medusa 环境的 Node.js 服务。 |
| PostgreSQL | 用于本地 Medusa 环境的 PostgreSQL 服务。 |
| Redis | 用于本地 Medusa 环境的 Redis 服务。 |
| NginxCaddy | 用于本地 Medusa 环境的 Nginx / Caddy 服务。 |
FlyEnv 如何提供帮助
匹配项目运行时
为 Medusa 选择项目所需的运行时版本。
管理本地服务
仅在项目需要时启动数据库、缓存和其他服务。
保持项目隔离
让不同项目使用各自的版本和服务配置。
配置本地域名
需要时可通过本地域名和 HTTPS 访问项目。
配置本地环境
项目安装请遵循上游官方文档；FlyEnv 负责管理其所需的运行时、数据库、Web 服务器和辅助服务。
- 1按照 Medusa 官方文档安装项目和依赖。
- 2在 FlyEnv 中选择项目需要的运行时版本。
- 3启动项目配置中指定的数据库服务。
- 4仅在项目需要时启动缓存、搜索或其他辅助服务。
- 5按需配置本地 Web 服务器、域名和 HTTPS。
- 6将相关服务加入启动组，方便重复启动。
准备好本地运行 Medusa 吗？
使用 FlyEnv 管理本地 Medusa 环境所需的运行时、数据库、Web 服务器和服务。