Встановлення та налаштування Strapi

Встановлення та налаштування Strapi

Strapi встановлюється як додаток Node.js. У режимі розробки доступна гаряча перезавантаження та Content-Type Builder. У режимі production 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
# Скопіювати токен — показується тільки один раз

Фронтенд .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, базовою конфігурацією та першим типом контенту займає 2–4 години.