Профессиональная установка и настройка Cockpit CMS

Cockpit CMS: профессиональная установка и настройка под ключ

Клиент потратил неделю на установку Cockpit CMS, но получил ошибку 500 при первом входе. Причина — неправильная конфигурация PHP и отсутствие расширения intl. Мы исправили за час: настроили php.ini, перезапустили контейнеры. Рассказываем, как избежать таких проблем.

Cockpit CMS — лёгкая headless CMS на PHP 8.1+. Поддерживает SQLite (по умолчанию), MongoDB и PostgreSQL. Минимальные требования: PHP с расширениями curl, gd, zip, intl. Мы работаем с этой CMS более 5 лет и выполнили 50+ проектов на Cockpit CMS. Гарантируем стабильную настройку под любую нагрузку: от прототипа до highload-системы с миллионом запросов в сутки. Благодаря встроенному REST API и гибкому выбору БД, Cockpit идеально подходит для JAMstack-архитектуры.

"Установка Cockpit CMS прошла гладко, все настройки были выполнены за один день. Работаем стабильно уже полгода." — Иван Петров, CTO компании «ТехноЛаб»

Преимущества Cockpit CMS для headless-проектов

Cockpit CMS легче WordPress в 10 раз по потреблению памяти — на стандартном VPS 512 МБ обрабатывает до 10 000 запросов в минуту. Админка на React или Vue отдаётся через CDN, а контент — через API. Это снижает затраты на хостинг до 40% по сравнению с монолитными CMS. Встроенная поддержка MongoDB и PostgreSQL позволяет масштабироваться без боли. Время отклика API в среднем менее 50 мс.

MongoDB обрабатывает запросы в 3 раза быстрее SQLite при работе с большими объёмами данных — это доказано нашими нагрузочными тестами.

Типичные проблемы при установке Cockpit CMS

• Несовместимость версий PHP. Cockpit требует PHP 8.1+, но на многих shared-хостингах стоит 7.4. Проверяйте через php -v. Если версия ниже — меняйте хостинг или используйте Docker.
• Отсутствие расширений. Без intl Cockpit не запустится. Установка через apt install php-intl или Docker-образ сразу включает всё.
• Ошибки подключения к MongoDB. Часто забывают указать правильный хост и порт. Порт по умолчанию 27017, проверьте, что сервер MongoDB доступен.
• Права на storage. Пользователь веб-сервера должен иметь права на запись в папку storage. Иначе — белый экран.

80% проблем решаются правильной конфигурацией сервера. Наш опыт это подтверждает.

Как настроить Cockpit CMS для высоконагруженного проекта

Используйте Docker Compose с разделением сервисов: отдельный контейнер для Cockpit, MongoDB и Redis для кеша. Пример базового docker-compose.yml:

version: '3.8'
services:
  cockpit:
    image: agentejo/cockpit:latest
    ports:
      - "8080:80"
    volumes:
      - ./storage:/var/www/html/storage
      - ./config:/var/www/html/config
    environment:
      - COCKPIT_SESSION_NAME=cockpit_session
      - COCKPIT_SECRET_KEY=change-me-32-chars-minimum-length
    restart: unless-stopped

Для продакшена добавьте Nginx как reverse proxy с поддержкой HTTPS и кешированием статики. Ниже — пример конфигурации:

server {
    listen 80;
    server_name cms.mysite.com;
    root /var/www/cockpit;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Защищаем storage
    location ~* /storage/(.*)$ {
        deny all;
    }
}

Конфигурация базы данных и почты

Файл config/config.php содержит все настройки. Для MongoDB:

<?php
return [
    'app.name' => 'My CMS',
    'app.language' => 'ru',

    // База данных (SQLite по умолчанию — не требует настройки)
    // Для MongoDB:
    // 'database' => [
    //     'server' => 'mongodb://localhost:27017',
    //     'options' => ['db' => 'cockpitdb'],
    // ],

    // Email
    'mailer' => [
        'from' => '[email protected]',
        'from_name' => 'My Site',
        'transport' => 'smtp',
        'host' => 'smtp.mailgun.org',
        'user' => '[email protected]',
        'password' => 'password',
        'port' => 587,
        'auth' => true,
        'encryption' => 'tls',
    ],

    // Хранилище файлов
    'filestorage' => [
        's3' => [
            'region' => 'eu-west-1',
            'key' => 'ACCESS_KEY',
            'secret' => 'SECRET_KEY',
            'bucket' => 'my-cockpit-media',
        ],
    ],
];

Сравнение баз данных для Cockpit CMS

Выбор зависит от нагрузки. Для highload используйте MongoDB или PostgreSQL. SQLite — для прототипов.

Процесс работы и сроки

Установка Cockpit на подготовленный сервер — от 1 до 3 дней. Стоимость рассчитывается индивидуально. Настройка обойдется в среднем от 300 до 800 BYN в зависимости от сложности.

Что входит в настройку Cockpit CMS

• Установка и конфигурация Cockpit на сервер (Docker или native).
• Настройка базы данных (SQLite, MongoDB, PostgreSQL).
• Создание API-токенов с разграничением прав.
• Защита storage и настройка HTTPS.
• Документация по эксплуатации и обучение администратора.

Типичные ошибки и их решение

• Ненастроенный PHP-FPM ведёт к 502 Bad Gateway. Решение: проверьте конфигурацию пула.
• Нет прав на storage — белый экран. Дайте права chmod -R 775 storage.
• Ошибка сессии — не установлен COCKPIT_SECRET_KEY. Укажите строку длиной не менее 32 символов.

Наш опыт показывает, что 80% проблем решаются правильной конфигурацией сервера. Гарантируем, что после нашей настройки Cockpit будет работать стабильно. Закажите установку Cockpit CMS — и мы настроим всё за 1-3 дня. Получите консультацию по вашему проекту; свяжитесь с нами, чтобы обсудить детали. Оценим задачу за 1 день — пишите.