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
| База данных | Производительность | Простота настройки | Подходит для |
|---|---|---|---|
| SQLite | Низкая | Высокая | Разработка, 1-3 пользователя |
| MongoDB | Высокая | Средняя | Многопользовательские проекты, гибкие схемы |
| PostgreSQL | Высокая | Средняя | Крупные проекты, строгие схемы |
Выбор зависит от нагрузки. Для highload используйте MongoDB или PostgreSQL. SQLite — для прототипов.
Процесс работы и сроки
| Этап | Длительность | Результат |
|---|---|---|
| Аналитика | 1 день | Требования, нагрузка, стек |
| Проектирование | 1 день | Выбор БД, архитектура |
| Установка и настройка | 1-2 дня | Cockpit, окружение |
| Тестирование | 1 день | Производительность, безопасность |
| Документация и передача | 0.5 дня | Инструкция, обучение |
Установка 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 день — пишите.
Дополнительные рекомендации по безопасности
Для production используйте HTTPS, ограничьте доступ к /cockpit по IP, регулярно обновляйте ядро CMS. Подробнее в официальном репозитории Cockpit.







