🚀 Strapi 生产环境部署指南

在生产环境部署 Strapi 时，需要确保安全性、稳定性和性能。下面是详细的生产部署指南（以 Linux + Node.js + Nginx 为例）。

🧩 一、前置条件

在服务器上安装好以下环境：

软件	说明	检查命令
Node.js (LTS)	建议使用 v18+	node -v
npm 或 yarn	用于安装依赖	npm -v / yarn -v
数据库	PostgreSQL / MySQL / SQLite 等	—
PM2	Node 进程守护工具	npm i -g pm2
Nginx	用作反向代理和静态资源服务器	nginx -v

⚙️ 二、构建生产版本

1️⃣ 进入项目目录

cd /var/www/my-strapi

2️⃣ 安装依赖

```bash
npm install --production
# 或
yarn install --production
```

3️⃣ 构建管理面板（Admin UI）

```bash
npm run build
```

4️⃣ 启动测试

```bash
npm run start
```

访问 `http://localhost:1337` 确认运行正常。

## 🚀 三、使用 PM2 启动守护进程

创建 PM2 配置：

```bash
pm2 start npm --name "strapi" -- run start
pm2 save
pm2 startup
```

> 💡 PM2 会在系统重启后自动启动 Strapi。
> 你可以查看状态：
>
> ```bash
> pm2 list
> pm2 logs strapi
> ```

## 🌍 四、配置 Nginx 反向代理（推荐）

编辑配置文件：

```bash
sudo nano /etc/nginx/sites-available/strapi.conf
```

内容示例：

```nginx
server {
  listen 80;
  server_name your-domain.com;

  location / {
    proxy_pass http://127.0.0.1:1337;
    proxy_http_version 1.1;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

  # 可选：服务静态文件
  location /uploads/ {
    alias /var/www/my-strapi/public/uploads/;
  }
}
```

启用并重启：

```bash
sudo ln -s /etc/nginx/sites-available/strapi.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
```

## 🔐 五、环境变量配置

在生产中，不要在代码里写死配置，而是使用 `.env` 文件：

```bash
NODE_ENV=production
HOST=0.0.0.0
PORT=1337

APP_KEYS=your_app_keys
API_TOKEN_SALT=your_api_token_salt
ADMIN_JWT_SECRET=your_admin_jwt_secret
JWT_SECRET=your_jwt_secret

# 数据库连接
DATABASE_CLIENT=postgres
DATABASE_HOST=127.0.0.1
DATABASE_PORT=5432
DATABASE_NAME=strapi_db
DATABASE_USERNAME=strapi_user
DATABASE_PASSWORD=your_password
```

然后在 Strapi 的 `config/database.js`、`config/server.js` 使用 `env()` 读取。

## 📦 六、备份与升级建议

| 类型       | 建议                                    |
| ---------- | --------------------------------------- |
| 数据库备份 | 定期备份 PostgreSQL / MySQL             |
| 上传文件   | 同步 `/public/uploads/`                 |
| 安全更新   | 定期执行 `npm audit`、`pm2 update`      |
| HTTPS      | 使用 Let’s Encrypt 配置 SSL (`certbot`) |

## 🧠 七、可选优化

- **使用 Docker 部署**：通过 `Dockerfile + docker-compose.yml` 封装环境。
- **使用 CI/CD**：在 GitLab/Jenkins 中自动构建、发布。
- **集群部署**：结合 **PM2 Cluster Mode** 或 Kubernetes。

## ✅ 示例生产启动命令

```bash
NODE_ENV=production pm2 start npm --name strapi -- run start
```