服务器端配置strapi教程#
准备工作#
Strapi 是一个基于 Node.js 的应用，因此您需要先安装 Node.js 和其包管理器 npm。Strapi 官方推荐使用 Node.js LTS 版本。
安装 Node.js 和 npm#
使用 curl 和 NodeSource 仓库来安装推荐的 LTS 版本（当前通常是 20.x 或最新 LTS）：
# 1. 更新包列表
sudo apt update
# 2. 安装 curl
sudo apt install curl -y
# 3. 添加 NodeSource 仓库 (以 Node.js 20 LTS 为例，您可以根据需要调整版本)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# 4. 安装 Node.js 和 npm
sudo apt install nodejs -y验证安装#
检查 Node.js 和 npm 的版本以确认安装成功：
node -v
npm -v您应该会看到对应的版本号。
安装数据库系统#
Strapi 支持多种数据库，包括 PostgreSQL、MySQL、MariaDB 和 SQLite。对于生产环境，PostgreSQL 或 MySQL 是更强大的选择。这里以安装 PostgreSQL 为例进行说明。
安装 PostgreSQL#
sudo apt install postgresql postgresql-contrib -y启动并检查服务状态#
sudo systemctl start postgresql
sudo systemctl enable postgresql
sudo systemctl status postgresql设置 PostgreSQL 用户和数据库#
默认情况下，PostgreSQL 会创建一个名为 postgres 的 Linux 用户和同名数据库用户。切换到 postgres 用户并进入 PostgreSQL 命令行界面:
sudo -u postgres psql创建一个新的 Strapi 数据库用户 (例如：strapiuser) 和密码 (请替换成您自己的强密码):
CREATE USER strapiuser WITH ENCRYPTED PASSWORD 'your_secure_password';创建一个新的数据库 (例如：strapidb) 并赋予新用户所有权限:
CREATE DATABASE strapidb OWNER strapiuser;创建完成后，检查数据库创建情况。
\l
# 检查数据库列表，前三列是默认系统自建，列出的以自定义用户名创建的就是刚刚创建的数据库。
\q
# 退出数据库命令行。注意： 记下您的 数据库名、用户名 和 密码，稍后在 Strapi 配置中使用。
创建和运行 Strapi 项目#
创建 Strapi 项目#
在您希望存放项目的目录下，使用 npx (Node.js 包执行器) 来创建 Strapi 项目。
# 进入您的项目目录 (例如：/var/www)
cd /var/www
# 创建一个名为 my-strapi-project 的新项目
# 使用 --dbclient=postgres 来指定数据库类型
npx create-strapi-app@latest my-strapi-project --quickstart配置数据库连接 (如果未使用 -quickstart)#
如果项目创建时没有使用 --quickstart，系统会提示您选择数据库类型和输入连接详情：
- Database type: 选择
PostgreSQL(或您安装的数据库类型)。 - Database name: 输入您创建的数据库名，例如
strapidb。 - Host:
127.0.0.1(或localhost) - Port: 默认
5432(PostgreSQL 默认端口) - Username:
strapiuser - Password:
your_secure_password
运行 Strapi#
创建完成后，进入项目目录并运行 Strapi：
cd my-strapi-project
# 启动开发服务器
npm run developStrapi 将开始编译并运行。
访问 Strapi 后台#
当您看到类似以下输出时，表示 Strapi 已经成功运行：
[2025-12-09 23:00:00.000] info: The server is running at http://localhost:1337- 访问地址： 在您的服务器浏览器或通过 SSH 端口转发，访问
http://服务器IP地址:1337。 - 首次设置： 首次访问时，您需要创建一个 管理员账户 来进入 Strapi 的内容管理系统 (CMS) 后台。
- 注意事项：确认你的服务器已经放行1337端口！没有的话，请自行添加规则！
生产环境额外步骤 (可选)#
对于生产环境，您通常还需要：
- **安装PM2。**用来守护 Strapi 进程，确保应用崩溃后能自动重启。
npm install pm2 -g- **使用 PM2 启动 Strapi：**Strapi 官方推荐使用
npm run start启动生产模式。PM2 运行npm脚本的方式如下：
# 语法：pm2 start npm --name "应用名称" -- run 脚本名称
pm2 start npm --name "strapi-app" -- run start-name "strapi-app": 给您的进程指定一个易于识别的名称。- run start: 告诉 PM2 运行项目package.json文件中定义的start脚本（Strapi 的生产启动脚本）。
注意： 如果您之前一直在使用 npm run develop，现在切换到 npm run start（生产环境模式），您可能需要先运行一次构建命令，因为生产模式运行的是优化后的构建版本：
npm run build
# 接着再运行 pm2 start ...
pm2 start npm --name "strapi-app" -- run start
# 保存
pm2 save