安装、配置和部署

Strapi 旨在安装在您的本地机器上，然后进行配置，最后部署到远程环境。本文档部分描述了这些主题，单击以下任何卡片都会将您带到相应的部分：

部署

Strapi 为您的项目或应用程序提供了许多部署选项。您的 Strapi 应用程序可以部署在传统托管服务器或您首选的托管提供商上。

以下文档介绍了如何使用 Strapi 进行本地开发以及如何使用几种常见的托管选项部署 Strapi。

一般准则

硬件和软件要求

为了为 Strapi 提供最佳环境，以下要求适用于开发（本地）和暂存和生产工作流程。

在安装 Strapi 之前，必须在您的计算机上安装以下要求：

• Node.js：仅支持 活动 LTS 或维护 LTS 版本（当前为 v18 和 v20）。不支持 Node 的奇数版本（称为 Node.js 的“当前”版本）（例如 v19、v21）。
• 您首选的 Node.js 包管理器：
• npm（v6 及以上版本）
• yarn
• Python（如果使用 SQLite 数据库）
• 适用于您的操作系统的标准构建工具（大多数基于 Debian 的系统上的 build-essentials 包）
• 适用于您的服务器的硬件规格（CPU、RAM、存储）：

  硬件	推荐	最低
  CPU	2+ cores	1 core
  Memory	4GB+	2GB
  Disk	32GB+	8GB

• 支持的数据库版本:

  数据库	推荐	最低
  MySQL	8.0	5.7.8
  MariaDB	10.6	10.3
  PostgreSQL	14.0	11.0
  SQLite	3	3

  数据库部署

  数据库指南 介绍了如何与 Strapi 一起部署数据库。

• 支持的操作系统：

  操作系统	推荐	最低
  Ubuntu (LTS)	22.04	20.04
  Debian	11.x	10.x
  CentOS/RHEL	9.x	8.x
  macOS	11.0	10.15
  Windows Desktop	11	10
  Windows Server	2022	2019

应用程序配置

1. 配置

我们建议使用环境变量根据环境配置您的应用程序，例如：

module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
})

然后，您可以创建一个 .env 文件或直接在您选择的部署平台中设置环境变量：

HOST=10.0.0.1
PORT=1338

2. 启动服务器

在生产环境中运行服务器之前，您需要构建用于生产的管理面板：

NODE_ENV=production yarn build

使用production设置运行服务器：

NODE_ENV=production yarn start

如果您需要一个 server.js 文件来运行 node server.js 而不是 npm run start，请按如下方式创建一个 ./server.js 文件：

const strapi = require('@strapi/strapi')
strapi(/* {...} */).start()

高级配置

如果您希望在 API 之外的其他服务器上托管管理，请查看此专用部分。

部署指南

单击以下任意卡片即可阅读部署和可选软件的手动指南：