Установка и настройка Strapi

Установка и настройка Strapi

Strapi устанавливается как Node.js приложение. В development mode — горячая перезагрузка, Content-Type Builder доступен. В production mode — Content-Type Builder отключён, конфигурация только из кода.

Требования

• Node.js 18 или 20 (LTS)
• npm 6+ / yarn 1.22+ / pnpm 6+
• PostgreSQL / MySQL / SQLite

Установка

npx create-strapi-app@latest my-strapi --dbclient=postgres

# Интерактивно укажет:
# Database: postgres
# Host: localhost
# Port: 5432
# Name: strapi_db
# Username: strapi
# Password: ...
# SSL: No (для локальной разработки)

cd my-strapi
npm run develop

Конфигурация

// config/database.js
module.exports = ({ env }) => ({
  connection: {
    client: 'postgres',
    connection: {
      connectionString: env('DATABASE_URL'),
      ssl: env.bool('DATABASE_SSL', false)
        ? { rejectUnauthorized: false }
        : false,
    },
    pool: { min: 2, max: 10 },
  },
})

// config/server.js
module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  url: env('PUBLIC_URL', 'http://localhost:1337'),
})

// config/middlewares.js
module.exports = [
  'strapi::logger',
  'strapi::errors',
  {
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        useDefaults: true,
        directives: {
          'img-src': ["'self'", 'data:', 'blob:', 'res.cloudinary.com'],
        },
      },
    },
  },
  { name: 'strapi::cors', config: { origin: [process.env.FRONTEND_URL] } },
  'strapi::poweredBy',
  'strapi::query',
  'strapi::body',
  'strapi::session',
  'strapi::favicon',
  'strapi::public',
]

API Token

# Создать через Admin: Settings → API Tokens → Create new API Token
# Type: Read-only / Full access / Custom
# Скопировать token — показывается один раз

.env фронтенда:

STRAPI_URL=http://localhost:1337
STRAPI_API_TOKEN=your-api-token-here

Production деплой

# Build
NODE_ENV=production npm run build
NODE_ENV=production npm start

# PM2
pm2 start ecosystem.config.js

// ecosystem.config.js
module.exports = {
  apps: [{
    name: 'strapi',
    script: 'npm',
    args: 'start',
    env: {
      NODE_ENV: 'production',
      DATABASE_URL: 'postgresql://...',
      APP_KEYS: '...',
      API_TOKEN_SALT: '...',
      JWT_SECRET: '...',
    },
  }],
}

Сроки

Установка с PostgreSQL, базовой конфигурацией и первым content type — 2–4 часа.