通过 CLI 安装

页面摘要： Strapi CLI 是通过 npx create-strapi@latest 在本地安装 Strapi 的最快方式，可通过命令行标志配置 TypeScript、数据库（--dbclient、--dbhost 等）以及其他安装偏好。

Strapi CLI（命令行界面）安装脚本是在本地运行 Strapi 的最快方式。以下指南是 Strapi 最推荐的安裝选项。

准备安装

安装 Strapi 之前，你的电脑上必须安装以下依赖：

• Node.js：仅支持 Active LTS 或 Maintenance LTS 版本（当前为 v22、v24 和 v26）。Node 的奇数版本，即所谓的"current"版本，不受支持（如 v23、v25）。
• 你偏好的 Node.js 包管理器：
  • npm（v6 及以上）
  • pnpm（在 Strapi Cloud 上，Corepack 会匹配项目 package.json 的 packageManager 字段中固定的 pnpm 版本，若未固定则使用 Corepack 内置默认版本）
• Python（如果使用 SQLite 数据库）
• 受支持的 Web 浏览器：管理面板面向匹配默认 Browserslist 查询的浏览器：last 3 major versions、Firefox ESR、last 2 Opera versions、not dead。参见 browsersl.ist 了解当前覆盖矩阵。项目可以通过项目根目录的 Browserslist 配置覆盖这些默认值。 任何 Strapi 项目还需要一个受支持的数据库： | 数据库 | 推荐 | 最低 | |------------|-------------|---------| | MySQL | 8.4 | 8.0 | | MariaDB | 11.4 | 10.3 | | PostgreSQL | 17.0 | 14.0 | | SQLite | 3 | 3 |

Strapi 不支持 MongoDB（或任何 NoSQL 数据库），也不支持任何"云原生"数据库（如 Amazon Aurora、Google Cloud SQL 等）。

创建 Strapi 项目

按照以下步骤创建新的 Strapi 项目，务必使用与你所安装的包管理器相对应的命令：

1. 在终端中，运行以下命令：

   NPM

   npx create-strapi@latest
   

   该命令的补充说明：

   • npx 从 npm 包运行命令
   • create-strapi 是 Strapi 包
   • @latest 表示使用最新版本的 Strapi

   :::tip 较旧的 npx create-strapi-app@latest 命令仍然有效，并且会提供与较新的 npx create-strapi@latest 命令完全相同的体验。 :::

   除了 npx 之外，也可以使用传统的 npm 命令：npm create strapi@latest。

   请注意使用 npx 时 create 与 strapi 之间的额外短横线：npx create-strapi 与 npm create strapi 的对比。

   pnpm

   :::note 在 Strapi Cloud 上，pnpm 版本由 Corepack 管理：项目 package.json 的 packageManager 字段中固定的版本会被自动遵循；如果未固定任何版本，则使用 Corepack 附带的默认值。详情请参阅包管理器版本。 :::

   pnpm create strapi
   

2. 终端会询问你是否要 Login/Signup（登录/注册） 或 Skip（跳过） 此步骤。使用方向键并按下 Enter 做出选择。如果选择登录，你将获得 （Growth 计划） 套餐的 30 天试用，它会自动应用到你创建的项目。如果跳过此步骤，项目将回退到 CMS Free 套餐。

3. 终端会向你提出几个问题。对其中每一个，如果你按下 Enter 而不是输入内容，将使用默认答案（Yes）：

:::tip 你可以使用传给安装命令的各种选项跳过这些问题。完整可用选项列表请参阅表格。 :::

4. (可选) 如果你对默认（SQLite）数据库问题回答了 n（否），CLI 会询问更多关于数据库的问题：

   • 使用方向键选择你想要的数据库类型，然后按下 Enter。
   • 为数据库命名，定义数据库主机地址和端口，定义数据库管理员用户名和密码，并定义数据库是否使用 SSL 连接。 对于这些问题中的任何一个，如果你不输入任何内容直接按下 Enter，将使用默认值（在终端输出中以括号标示）。

一旦所有问题都已回答，脚本将开始创建 Strapi 项目。

CLI 安装选项

上述安装指南仅涵盖使用 CLI 的基本安装选项。在创建新的 Strapi 项目时还有其他可用的选项，例如：

• sqlite 表示 SQLite 数据库（默认）
• postgres 表示 PostgreSQL 数据库
• mysql 表示 MySQL 数据库 | | --dbhost <dbhost> | 通过将命令中的 <dbhost> 替换为你选择的值来定义要使用的数据库主机 | | --dbport <dbport> | 通过将命令中的 <dbport> 替换为你选择的值来定义要使用的数据库端口 | | --dbname <dbname> | 通过将命令中的 <dbname> 替换为你选择的值来定义要使用的数据库名称 | | --dbusername <dbusername> | 通过将命令中的 <dbusername> 替换为你选择的值来定义要使用的数据库用户名 | | --dbpassword <dbpassword> | 通过将命令中的 <dbpassword> 替换为你选择的值来定义要使用的数据库密码 | | --dbssl <dbssl> | 通过传递 --dbssl=true 定义数据库使用 SSL（默认不启用 SSL） | | --dbfile <dbfile> | 对于 SQLite 数据库，通过将命令中的 <dbclient> 替换为你选择的值来定义要使用的数据库文件路径 | | --quickstart | （Strapi 5 中已弃用） 直接在 quickstart 模式下创建项目。请改用 --non-interactive。 |

跳过 Strapi 登录步骤

当安装脚本运行时，终端会首先询问你是否要登录/注册。选择 Login/signup（登录/注册） 将为你提供 （Growth 计划） 的 30 天试用，它会自动应用到你创建的项目。这将使你能够访问高级 CMS 功能。

如果你希望跳过此 Strapi 登录部分，请使用方向键选择 Skip（跳过）。脚本将继续运行，并使用 CMS Free 套餐创建一个本地项目。

你之后可以通过查看我们的 定价页面 来购买 CMS 许可证。

托管你的项目

你可以将项目部署到 Strapi Cloud。要将其托管到线上，你可以选择：

• 自行托管：先将项目代码推送到仓库（例如 GitHub），然后遵循部署指南，
• 或使用 Cloud CLI 命令登录 Strapi Cloud，将本地项目链接到现有的 Strapi Cloud 项目，并将其部署到那里。

如果你想自行托管项目但还不熟悉 GitHub，以下可展开的内容可以帮助你入门👇。

将你的 Strapi 项目代码推送到 GitHub 的步骤：

1. 在终端中，确保你位于所创建的 Strapi 项目所在文件夹。
2. 运行 git init 命令为这个文件夹初始化 git。
3. 运行 git add . 命令将所有已修改文件添加到 git 索引。
4. 运行 git commit -m "Initial commit" 命令提交所有更改。
5. 登录你的 GitHub 账户并创建新仓库。为新仓库命名，例如 my-strapi-project，并记住该名称。
6. 回到终端，将本地仓库推送到 GitHub：

a. 运行类似下面的命令：git remote add origin git@github.com:yourname/my-strapi-project.git，请将 yourname 替换为你的 GitHub 个人资料名，将 my-strapi-project 替换为第 5 步中实际使用的名称。

b. 运行 git push --set-upstream origin main 命令，最终将提交推送到你的 GitHub 仓库。

更多关于在命令行使用 git 的信息，请参阅官方 GitHub 文档。

运行 Strapi

要启动 Strapi 应用，请在项目文件夹中运行以下命令：

NPM

npm run develop