先决条件
在安装 Medusa 之前,你需要确保已经安装了以下工具:
- Node.js: Medusa 需要 Node.js v16 或更高版本。你可以从 Node.js 官网下载并安装。
- Git: Git 用于从 GitHub 获取 Medusa 的源代码。你可以从 Git 官网下载并安装。
- PostgreSQL: Medusa 使用 PostgreSQL 作为数据库。你可以从 PostgreSQL 官网下载安装包,并按照指南进行安装。
安装步骤
安装并配置好上述工具后,你可以按照以下步骤部署 Medusa:
打开终端:你可以使用 Windows 的命令提示符或 PowerShell。
使用 npx 创建 Medusa 应用:
npx create-medusa-app@latest
这个命令会引导你通过一系列步骤来配置你的 Medusa 应用。
选择项目名称:你将被提示输入一个项目名称,这将创建一个包含 Medusa 后端的新目录。
设置管理员账户:系统会要求你输入管理员电子邮件地址,这将用于登录管理仪表板。
(可选)安装前端界面: 如果你想同时安装前端界面,可以选择安装 Next.js 的入门模板。如果选择这个选项,将会在
my-medusa-store-storefront
目录中安装前端。配置数据库:如果你没有提供数据库 URL,系统会尝试使用默认的 PostgreSQL 凭证连接到数据库,或提示你输入数据库凭据。
完成安装:完成以上步骤后,系统将自动完成安装,包括数据库的设置和管理员账户的创建。
启动项目:在项目目录中,使用以下命令启动 Medusa 服务器:
cd my-medusa-store npm start
如果是开发环境
-
yarn dev
这将启动 Medusa 后端服务,并且如果你安装了前端,也会启动前端服务。
访问 Medusa
安装完成并且服务启动后,你可以通过浏览器访问 Medusa 的管理仪表板,通常是在 http://localhost:7001
(或其他配置的端口)。
- Medusa 后端运行在
http://localhost:9000
- Medusa 管理后台运行在
http://localhost:7001
正确登录到管理后台: 打开浏览器,访问 http://localhost:7001
,你应该会看到登录界面。使用你在设置过程中提供的管理员邮箱和密码登录。例如:
http://localhost:7001/invite?token=<your_token>
常见命令
以下是一些有用的命令,可以帮助你进一步调试和管理 Medusa 项目:
重启 Medusa 后端:
npm run start
如果是开发环境
yarn dev
查看数据库连接: 确保 PostgreSQL 数据库正在运行,并且 Medusa 能够连接到它。