Розгортання Strapi Headless

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

Тепер, коли всі компоненти встановлені, настав час їх налаштувати для спільної роботи зі Strapi.

1. Створення бази даних PostgreSQL для Strapi

Спочатку створимо користувача та базу даних у PostgreSQL, до яких Strapi підключатиметься.

# Підключитися до PostgreSQL як користувач postgres
sudo -i -u postgres psql

Усередині консолі PostgreSQL виконайте такі команди:

CREATE USER strapiuser WITH PASSWORD 'ваш_очень_сложный_пароль';
CREATE DATABASE strapidb WITH OWNER strapiuser;
GRANT ALL PRIVILEGES ON DATABASE strapidb TO strapiuser;
\q

Замініть ваш_очень_сложный_пароль на надійний пароль. Вийдіть з консолі PostgreSQL (\q).

2. Створення Strapi-проєкту

Перейдіть до домашньої директорії вашого користувача (/home/strapiuser) або до іншої зручної директорії, наприклад /var/www. Ми будемо використовувати /var/www для веб-застосунків.

sudo mkdir -p /var/www/strapi
sudo chown -R strapiuser:strapiuser /var/www/strapi
cd /var/www/strapi

Створіть новий Strapi-проєкт. Ми використовуємо прапор --no-run, щоб він не запускався відразу.

npx create-strapi-app@latest my-strapi-project --quickstart --no-run

Під час встановлення вам буде запропоновано вибрати тип встановлення. Для цього посібника виберіть Custom (manual settings), а потім PostgreSQL як базу даних. Введіть дані для підключення до бази даних, які ви створили раніше (Host: 127.0.0.1, Port: 5432, Database: strapidb, Username: strapiuser, Password: ваш_очень_сложный_пароль).

Перейдіть до директорії проєкту:

cd my-strapi-project

3. Налаштування змінних оточення Strapi

Секрети та конфігураційні параметри краще зберігати у файлі .env. Створіть або відредагуйте файл .env у кореневій директорії вашого Strapi-проєкту.

nano .env

Додайте або оновіть наступні рядки:

HOST=0.0.0.0
PORT=1337
APP_KEYS=ваш_очень_сложный_и_длинный_ключ_для_приложения # Генерується автоматично при --quickstart, але краще перегенерувати
API_TOKEN_SALT=ваш_очень_сложный_и_длинный_ключ_для_api_токенов
ADMIN_JWT_SECRET=ваш_очень_сложный_и_длинный_ключ_для_админ_панели
JWT_SECRET=ваш_очень_сложный_и_длинный_ключ_для_jwt

DATABASE_CLIENT=pg
DATABASE_HOST=127.0.0.1
DATABASE_PORT=5432
DATABASE_NAME=strapidb
DATABASE_USERNAME=strapiuser
DATABASE_PASSWORD=ваш_очень_сложный_пароль
DATABASE_SSL=false

NODE_ENV=production

Для генерації сильних випадкових ключів для APP_KEYS, API_TOKEN_SALT, ADMIN_JWT_SECRET, JWT_SECRET ви можете використовувати команду:

node -e "console.log(crypto.randomBytes(32).toString('hex'))"

Виконайте її кілька разів, щоб отримати унікальні ключі для кожного параметра. Збережіть файл.

4. Запуск Strapi з PM2

Тепер запустимо Strapi в production-режимі за допомогою PM2.

# Переконайтеся, що ви знаходитесь у кореневій директорії вашого Strapi-проєкту (/var/www/strapi/my-strapi-project)
npm run build
pm2 start npm --name "strapi-app" -- run start
# Зберегти список процесів PM2 для автозапуску
pm2 save

Перевірте статус Strapi:

pm2 list
pm2 logs strapi-app

Strapi має бути запущений і слухати на порту 1337 (за замовчуванням).

5. Налаштування Nginx як зворотного проксі

Створимо конфігураційний файл Nginx для вашого домену (наприклад, api.yourdomain.com).

sudo nano /etc/nginx/sites-available/api.yourdomain.com

Вставте наступну конфігурацію, замінивши api.yourdomain.com на ваш домен:

server {
    listen 80;
    server_name api.yourdomain.com;

    location / {
        proxy_pass http://localhost:1337;
        proxy_http_version 1.1;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_cache_bypass $http_upgrade;
    }
}

Збережіть файл. Створіть символічне посилання на цей файл у sites-enabled та перевірте синтаксис Nginx:

sudo ln -s /etc/nginx/sites-available/api.yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t

Якщо синтаксис у порядку (syntax is ok), перезавантажте Nginx:

sudo systemctl restart nginx

На цьому етапі ваш Strapi має бути доступний по HTTP через Nginx за адресою http://api.yourdomain.com (переконайтеся, що DNS-запис для вашого домену вказує на IP вашого VPS).

6. Налаштування SSL з Certbot (Let's Encrypt)

Для забезпечення безпеки та довіри необхідно налаштувати HTTPS. Certbot автоматично отримає та встановить SSL-сертифікати від Let's Encrypt.

# Встановити Certbot та плагін Nginx
sudo apt install -y certbot python3-certbot-nginx
# Отримати та встановити сертифікат
sudo certbot --nginx -d api.yourdomain.com

Certbot поставить вам кілька запитань: адресу електронної пошти для сповіщень, згоду з умовами обслуговування та, можливо, запропонує перенаправляти HTTP-трафік на HTTPS (виберіть "2: Redirect"). Certbot автоматично оновить конфігурацію Nginx, додавши SSL-параметри.

Перевірте, що Certbot налаштував автоматичне оновлення сертифікатів:

sudo systemctl status certbot.timer

Таймер має бути активний. Якщо ні, увімкніть його: sudo systemctl enable certbot.timer. Тепер ваш Strapi доступний по HTTPS: https://api.yourdomain.com.

7. Перевірка працездатності

Відкрийте ваш домен (наприклад, https://api.yourdomain.com) у браузері. Ви маєте побачити сторінку привітання Strapi або сторінку входу до адмін-панелі. Якщо це перший запуск, вам буде запропоновано створити першого адміністратора.

Ви також можете перевірити доступність API через curl:

curl -I https://api.yourdomain.com/admin/

Ви маєте побачити HTTP-заголовки з кодом стану 200 OK або 302 Found (перенаправлення на сторінку входу).

Резервні копії та обслуговування

Регулярне резервне копіювання та своєчасне обслуговування — ключ до довгострокової стабільності та безпеки вашого Strapi-проєкту.

Що резервувати

Для повноцінного відновлення Strapi вам потрібно буде резервувати кілька типів даних:

• База даних PostgreSQL: Містить весь ваш контент, структуру колекцій та користувачів. Це найважливіший компонент.
• Файли Strapi-проєкту: Включають конфігураційні файли (особливо .env), плагіни, кастомні контролери та сервіси. Хоча більшість даних у БД, налаштування застосунку також важливі.
• Медіафайли: Зображення, відео та інші файли, завантажені через Strapi. За замовчуванням вони зберігаються в ./public/uploads всередині проєкту, якщо не налаштоване зовнішнє сховище (S3).

Простий скрипт авторезервування

Створимо простий скрипт для резервування бази даних та файлів, який запускатиметься за розкладом через cron.

Створіть директорію для резервних копій (наприклад, /var/backups/strapi):

sudo mkdir -p /var/backups/strapi
sudo chown -R strapiuser:strapiuser /var/backups/strapi

Створіть файл скрипта backup_strapi.sh у домашній директорії користувача strapiuser:

nano /home/strapiuser/backup_strapi.sh

Вставте наступний вміст:

#!/bin/bash

# --- Конфігурація ---
BACKUP_DIR="/var/backups/strapi"
DATE=$(date +%Y%m%d_%H%M%S)
DB_NAME="strapidb"
DB_USER="strapiuser"
STRAPI_PROJECT_PATH="/var/www/strapi/my-strapi-project"
RETENTION_DAYS=7 # Скільки днів зберігати резервні копії

# --- Створення директорії резервної копії для поточної дати ---
CURRENT_BACKUP_DIR="$BACKUP_DIR/$DATE"
mkdir -p "$CURRENT_BACKUP_DIR"

# --- Резервне копіювання PostgreSQL ---
echo "Дампування бази даних PostgreSQL '$DB_NAME'..."
PGPASSWORD='ваш_дуже_складний_пароль' pg_dump -U "$DB_USER" -h localhost "$DB_NAME" > "$CURRENT_BACKUP_DIR/$DB_NAME.sql"
if [ $? -eq 0 ]; then
    echo "Дамп PostgreSQL успішний."
else
    echo "Помилка дампування бази даних PostgreSQL!"
    exit 1
fi

# --- Резервне копіювання файлів проєкту Strapi та медіафайлів ---
echo "Архівування файлів проєкту Strapi..."
tar -czf "$CURRENT_BACKUP_DIR/strapi_project.tar.gz" -C "$(dirname "$STRAPI_PROJECT_PATH")" "$(basename "$STRAPI_PROJECT_PATH")"
if [ $? -eq 0 ]; then
    echo "Файли проєкту Strapi успішно заархівовано."
else
    echo "Помилка архівування файлів проєкту Strapi!"
    exit 1
fi

# --- Видалення старих резервних копій ---
echo "Очищення старих резервних копій (старших за $RETENTION_DAYS днів)..."
find "$BACKUP_DIR" -maxdepth 1 -type d -mtime +"$RETENTION_DAYS" -exec rm -rf {} \;
echo "Очищення завершено."

echo "Резервне копіювання завершено о $DATE"

Замініть ваш_дуже_складний_пароль на ваш пароль від користувача PostgreSQL. Зробіть скрипт виконуваним:

chmod +x /home/strapiuser/backup_strapi.sh

Додайте скрипт у cron для щоденного запуску (наприклад, о 3:00 ночі).

crontab -e

Додайте наступний рядок у кінець файлу, щоб скрипт запускався щодня о 03:00:

0 3   * /home/strapiuser/backup_strapi.sh >> /var/log/strapi_backup.log 2>&1

Ця команда перенаправлятиме вивід скрипта у файл /var/log/strapi_backup.log, що допоможе відстежувати його виконання.

Куди зберігати резервні копії

Вкрай важливо зберігати резервні копії ПОЗА основним сервером. Якщо сервер вийде з ладу, ви втратите і дані, і резервні копії. Рекомендовані варіанти:

• Зовнішнє S3-сумісне об'єктне сховище: Наприклад, Amazon S3, DigitalOcean Spaces, Backblaze B2. Це економічно та надійно. Ви можете використовувати утиліти типу s3cmd або rclone для автоматичної синхронізації директорії резервних копій з S3.
• Окремий VPS: Недорогий VPS в іншій локації, що використовується виключно для зберігання резервних копій. Можна синхронізувати за допомогою rsync або sftp.
• Локальне сховище на вашому комп'ютері: Для дуже маленьких проєктів, але це не автоматизовано і не масштабовано.

Оновлення: rolling vs maintenance window

Оновлення ПЗ на продакшн-сервері вимагає обережності.

• Оновлення ОС та базових пакетів (apt upgrade): Рекомендується виконувати регулярно (раз на місяць), але завжди у "вікно обслуговування" (maintenance window), коли навантаження мінімальне. Перед оновленням зробіть повну резервну копію. Після оновлення, особливо якщо оновлювалося ядро, потрібне перезавантаження.
• Оновлення Strapi: Оновлення Strapi (особливо між мажорними версіями, наприклад, з v4 на v5) можуть вимагати міграції бази даних та коду. Завжди тестуйте оновлення на стейджинг-сервері перед застосуванням на продакшні. Виконуйте у вікно обслуговування.
• Оновлення Node.js: Оновлення Node.js також може впливати на Strapi. Перевіряйте сумісність версій.

Завжди робіть резервну копію перед будь-яким великим оновленням!

Усунення несправностей + FAQ

У цьому розділі зібрані відповіді на поширені запитання та рішення типових проблем, з якими ви можете зіткнутися при розгортанні Strapi.

Nginx видає помилку 502 Bad Gateway

Що перевірити: Помилка 502 зазвичай означає, що Nginx не може зв'язатися з бекенд-сервісом (у нашому випадку Strapi). Переконайтеся, що Strapi запущено і він слухає на правильному порту (за замовчуванням 1337). Перевірте логи Nginx (sudo tail -f /var/log/nginx/error.log) та логи Strapi (pm2 logs strapi-app).

Як виправити: Переконайтеся, що процес PM2 Strapi активний (pm2 list). Якщо ні, спробуйте запустити його вручну (cd /var/www/strapi/my-strapi-project && npm run start) і подивіться на помилки. Перевірте, що proxy_pass http://localhost:1337; у конфігурації Nginx вказує на правильний порт.

Strapi не запускається, помилки підключення до бази даних

Що перевірити: Перевірте файл .env у корені Strapi-проєкту. Переконайтеся, що параметри DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USERNAME та DATABASE_PASSWORD правильні. Перевірте, що PostgreSQL запущено (sudo systemctl status postgresql) і що користувач strapiuser має права доступу до бази даних strapidb.

Як виправити: Скиньте пароль користувача PostgreSQL (sudo -i -u postgres psql -c "ALTER USER strapiuser WITH PASSWORD 'новий_пароль';") та оновіть його в .env. Переконайтеся, що локальний хост 127.0.0.1 дозволено для підключення у файлі /etc/postgresql/16/main/pg_hba.conf (має бути рядок host all all 127.0.0.1/32 md5 або scram-sha-256). Після змін у pg_hba.conf перезапустіть PostgreSQL: sudo systemctl restart postgresql.

Не можу отримати SSL-сертифікат з Certbot

Що перевірити: Переконайтеся, що ваш домен (наприклад, api.yourdomain.com) правильно вказує на IP-адресу вашого VPS через A-запис у DNS. Certbot повинен мати можливість зв'язатися з вашим сервером через порт 80 (HTTP) для перевірки володіння доменом. Перевірте, що Nginx запущено і коректно слухає порт 80.

Як виправити: Тимчасово вимкніть UFW (sudo ufw disable) і спробуйте знову. Якщо це допомогло, значить, фаєрвол блокує порти. Переконайтеся, що sudo ufw allow http та sudo ufw allow https увімкнено. Перевірте конфігурацію Nginx на наявність помилок (sudo nginx -t). Переконайтеся, що немає інших процесів, які займають порт 80 або 443.

Який VPS-конфіг мінімально підійде?

Для мінімального розгортання Strapi для невеликого проєкту або тестування можна почати з VPS з 2 ядрами CPU, 4 ГБ RAM та 80 ГБ SSD. Цього буде достатньо для роботи операційної системи, PostgreSQL та самого Strapi без високого навантаження. Однак, якщо ви плануєте активне використання, великий обсяг контенту або багато користувачів, рекомендується збільшити RAM до 8 ГБ і, можливо, розглянути більш продуктивні диски.

Що обрати — VPS чи dedicated для цього завдання?

Для більшості проєктів Strapi, особливо на початкових та середніх етапах розвитку, VPS є оптимальним вибором. Він пропонує відмінний баланс між продуктивністю, гнучкістю та вартістю. Виділений сервер (dedicated) стає виправданим лише за дуже високих навантажень (тисячі одночасних користувачів, інтенсивні операції з БД), необхідності максимальної ізоляції ресурсів, специфічних вимог до апаратного забезпечення або особливих регуляторних норм. Почніть з VPS і масштабуйтеся до dedicated, якщо і коли ваші потреби перевищать можливості віртуалізації.

Повільна робота адмін-панелі Strapi

Що перевірити: Повільна робота адмін-панелі може бути викликана нестачею ресурсів VPS (CPU або RAM), повільною базою даних або неоптимізованими запитами. Перевірте використання ресурсів сервера (htop або free -h).

Як виправити: Збільште обсяг RAM на VPS, якщо він близький до вичерпання. Оптимізуйте запити до бази даних, якщо у вас дуже складні структури контенту. Переконайтеся, що база даних знаходиться на SSD-диску. Для продакшн-оточення завжди запускайте Strapi в режимі NODE_ENV=production, оскільки в development-режимі він споживає більше ресурсів.

Висновки та наступні кроки

Вітаємо! Ви успішно розгорнули Strapi Headless CMS на вашому VPS, налаштувавши PostgreSQL, Nginx та SSL-сертифікати. Тепер у вас є потужна, безпечна та гнучка платформа для керування контентом, готова до інтеграції з будь-яким фронтенд-застосунком.

Ось кілька наступних кроків, які ви можете зробити для подальшого розвитку вашого Strapi-проєкту:

• Розробка фронтенду: Використовуйте ваш Strapi API для створення веб-сайтів (за допомогою React, Vue, Next.js, Nuxt.js), мобільних застосунків або інших цифрових продуктів.
• Розширення функціоналу Strapi: Вивчіть документацію Strapi для створення кастомних полів, плагінів, життєвих циклів та ролей користувачів.
• Моніторинг та оптимізація: Впровадьте інструменти моніторингу (наприклад, Prometheus + Grafana) для відстеження продуктивності сервера та Strapi, щоб своєчасно реагувати на потенційні проблеми та оптимізувати ресурси.