Установка и настройка Cachet на Ubuntu 18.04

Этот пошаговый гид показывает, как установить Cachet — OSS систему статуса — на Ubuntu 18.04 с PHP, Nginx, MySQL и Composer. Вы получите рабочую страницу статуса с HTTPS, автоматическим обновлением сертификатов и минимальной проверкой безопасности. Подойдёт для небольших команд и SaaS-проектов.

Что такое Cachet

Cachet — это красивая и функциональная open source система для страницы статуса, написанная на PHP. Она помогает ясно и своевременно сообщать о простоях и инцидентах пользователям, командам и заинтересованным сторонам. Коротко: предоставляет JSON API, отчёты об инцидентах, метрики, Markdown для сообщений и уведомления подписчиков.

Ключевые требования

• PHP 7.1 или выше
• Веб-сервер с поддержкой PHP (Nginx, Apache, Caddy и т. п.)
• Composer
• Поддерживаемая база данных: MySQL, PostgreSQL или SQLite
• Git

Окружение, использованное в руководстве

• Ubuntu 18.04 LTS
• Nginx
• MySQL (в примерах)
• PHP-FPM (php7.2)

Подготовка системы

• Наличие не-root пользователя с sudo-привилегиями.

Проверка версии Ubuntu:

lsb_release -ds  
# Ubuntu 18.04.1 LTS

Настройте часовой пояс:

sudo dpkg-reconfigure tzdata

Обновите пакеты системы:

sudo apt update && sudo apt upgrade -y

Установите вспомогательные утилиты:

sudo apt install -y curl wget vim git unzip socat bash-completion

Шаг 1 — Установка PHP

Установите PHP и необходимые расширения:

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-xml php7.2-gd php7.2-zip php7.2-mbstring php7.2-mysql php7.2-pgsql php7.2-sqlite3 php7.2-opcache php-apcu

Проверка загруженных модулей PHP:

php -m

ctype
curl
exif
fileinfo
. . .

Проверка версии PHP:

php --version

# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )

PHP-FPM обычно запускается и включается для автозапуска. Если нужно — проверьте статус:

sudo systemctl status php7.2-fpm

Шаг 2 — Установка MySQL и создание базы для Cachet

Cachet поддерживает MySQL, MariaDB, PostgreSQL и SQLite. В примере используется MySQL.

Установка MySQL:

sudo apt install -y mysql-server

Проверка версии:

mysql --version
# mysql  Ver 14.14 Distrib 5.7.25, for Linux (x86_64)

Укрепление безопасности и установка пароля для root:

sudo mysql_secure_installation

Примеры ответов (следуйте подсказкам):

Would you like to setup VALIDATE PASSWORD plugin? N
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Войдите в MySQL как root:

sudo mysql -u root -p
# введите пароль

Создайте базу данных и пользователя для Cachet (замените dbname/username/password):

mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;
mysql> exit

Важно: запишите credentials в безопасное место.

Шаг 3 — Установка acme.sh и получение сертификата Let’s Encrypt (опционально)

HTTPS не обязателен, но рекомендуется для защиты трафика. В примере используется acme.sh — простой shell-клиент для Let’s Encrypt.

Установка acme.sh:

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
./acme.sh --install --accountemail [email protected]
source ~/.bashrc
cd ~

Проверка версии:

acme.sh --version
# v2.8.0

Получаем RSA и ECDSA сертификаты (замените example.com на свой домен):

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Для тестирования используйте флаг –staging.

Файлы сертификатов будут в:

• RSA: /home/username/example.com
• ECDSA: /home/username/example.com_ecc

Установите каталог для сертификатов, например /etc/letsencrypt:

mkdir -p /etc/letsencrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Копирование/установка сертификатов и автоматическая перезагрузка nginx:

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

acme.sh будет автоматически обновлять сертификаты каждые ~60 дней.

После завершения выйдите из root и вернитесь к обычному sudo-пользователю:

exit

Шаг 4 — Установка и конфигурация Nginx

В примере выбран Nginx. Если вы предпочитаете Apache, смотрите официальную документацию Cachet.

Установите Nginx:

sudo apt install -y nginx

Проверка версии:

sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)

Создайте конфигурацию для Cachet:

sudo vim /etc/nginx/sites-available/cachet.conf

Пример содержимого (замените status.example.com и пути к сертификатам):

server {
  listen 80;
  listen [::]:80;
  listen 443 ssl;
  listen [::]:443 ssl;

  server_name status.example.com;

  root /var/www/cachet/public;

  index index.php;

  ssl_certificate /etc/letsencrypt/status.example.com/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/status.example.com/status.example.com.key;
  ssl_certificate /etc/letsencrypt/status.example.com_ecc/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/status.example.com_ecc/status.example.com.key;

  location / {
    try_files $uri /index.php$is_args$args;
  }

  location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_index index.php;
    fastcgi_keep_conn on;
  }

}

Активируйте конфигурацию:

sudo ln -s /etc/nginx/sites-available/cachet.conf /etc/nginx/sites-enabled/

Проверьте конфигурацию и перезагрузите Nginx:

sudo nginx -t
sudo systemctl reload nginx.service

Важно: проверьте права доступа к корню сайта и сокету php-fpm.

Шаг 5 — Установка Composer

Установите Composer глобально:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

php composer-setup.php

php -r "unlink('composer-setup.php');"

sudo mv composer.phar /usr/local/bin/composer

Проверка версии:

composer --version
# Composer version 1.8.3 2019-01-30 08:31:33

Шаг 6 — Установка Cachet

Создайте директорию сайта и назначьте владельца:

sudo mkdir -p /var/www/cachet
sudo chown -R {your_user}:{your_user} /var/www/cachet

Перейдите в корень сайта и загрузите исходники Cachet:

cd /var/www/cachet

git clone -b 2.4 --single-branch https://github.com/cachethq/Cachet.git .

Скопируйте пример .env и отредактируйте параметры базы и APP_URL:

cp .env.example .env
vim .env

Установите зависимости Composer:

composer install --no-dev -o

Сгенерируйте ключ приложения и выполните установку:

php artisan key:generate
php artisan cachet:install

Назначьте окончательно владельца www-data:

sudo chown -R www-data:www-data /var/www/cachet

Откройте сайт в браузере и завершите настройку через веб-интерфейс.

Шаг 7 — Завершение первоначальной настройки в веб-интерфейсе

Выберите драйверы кеша и сессий, настройте параметры почты для уведомлений.

Настройте общие параметры сайта: имя, домен, часовой пояс и язык.

Создайте административную учётную запись.

После успешной конфигурации вы увидите сообщение об успешной установке. Нажмите кнопку “Go to dashboard” или откройте /dashboard.

Проверки после установки

• Откройте https://status.example.com и убедитесь, что главное окно доступно.
• Перейдите в https://status.example.com/dashboard и выполните вход.
• Проверьте отправку тестового письма (если настроена почта).
• Убедитесь, что автоматическое обновление сертификатов работающее (acme.sh cron/job).

Безопасность и рекомендации

• Держите PHP и пакеты в актуальном состоянии.
• Отключите доступ по root и используйте железные пароли или ключи.
• Регулярно делайте бэкапы базы данных и /var/www/cachet
• Используйте firewall (ufw) и ограничьте доступ к админке по IP при возможности.

Когда этот подход не подходит

• Для высоконагруженных страниц статуса, где требуется миллионы запросов в минуту, рассмотрите CDN и кэширование на краю.
• Если у вас уже есть централизованная платформа мониторинга с функцией status page, возможно, не стоит дублировать систему.

Альтернативные подходы

• Apache вместо Nginx — официально поддерживается.
• SQLite для простых тестовых установок (менее надежно для продакшна).
• Облачные SaaS-решения статуса вместо хостинга своего Cachet.

Мини-методология установки (быстрый чеклист)

1. Обновить систему и установить зависимости.
2. Подготовить базу данных и пользователя.
3. Установить PHP и расширения.
4. Настроить веб-сервер (Nginx) и SSL.
5. Развернуть исходники Cachet и установить зависимости.
6. Сгенерировать ключ и выполнить установку.
7. Назначить права и проверить доступность сайта.

Ролевые чек-листы

Администратор (DevOps):

• Установить OS и базовые пакеты.
• Настроить бэкапы и мониторинг.
• Обеспечить безопасность сокета php-fpm.

Разработчик / Владелец продукта:

• Настроить APP_URL и почту.
• Проверить оформление шаблонов инцидентов.

DBA:

• Настроить резервирование и точки восстановления для MySQL.
• Следить за ростом таблиц логов/метрик.

Служба поддержки:

• Настроить уведомления подписчиков.
• Подготовить шаблоны сообщений для инцидентов.

Критерии приёмки

• Сайт статуса доступен по HTTPS.
• Админ может войти в /dashboard.
• Уведомления по почте отправляются корректно.
• Бэкапы базы данных выполняются по расписанию.

Решение при выборе БД и веб-сервера (диаграмма)

flowchart TD
  A[Нужен быстрый старт?] -->|Да| B[SQLite]
  A -->|Нет| C[Планируете рост/резервирование?]
  C -->|Да| D[MySQL или PostgreSQL]
  C -->|Нет| B
  E[Веб-сервер] --> F[Nginx]
  E --> G[Apache]
  click F 'https://nginx.org/' 'Nginx' 
  click G 'https://httpd.apache.org/' 'Apache'

Ошибки и способы решения (коротко)

• 502 Bad Gateway — проверьте статус php7.2-fpm и путь сокета.
• 500 Internal Server Error — проверьте логи storage/logs и права на файлы.
• Проблемы с SSL — проверьте пути к сертификатам и их формат.

Приватность и соответствие GDPR (общие замечания)

• Если вы сохраняете адреса электронной почты подписчиков, храните их в зашифрованном или ограниченном доступе.
• Обеспечьте возможность удаления данных пользователя по запросу.
• Документируйте, какие данные собираются и как долго хранятся.

Факт-бокс — ключевые числа

• Минимальная версия PHP: 7.1+
• Рекомендуемый веб-сервер: Nginx/Apache
• Интервал автоматического обновления certs acme.sh: ~60 дней
• Типичный путь установки: /var/www/cachet

Глоссарий (1 строка)

• Cachet: система страницы статуса с UI и API.
• acme.sh: shell-клиент для автоматического получения сертификатов Let’s Encrypt.
• Composer: менеджер зависимостей для PHP.

Резюме

Вы установили Cachet на Ubuntu 18.04 с MySQL, Nginx и PHP-FPM. Проверьте доступность сайта, настройте почту и бэкапы. Для продакшна включите автоматическое обновление сертификатов и базовые меры безопасности.

Полезные ссылки

• https://cachethq.io/
• https://github.com/CachetHQ/Cachet