Развёртывание Cachet на VPS для создания публичной страницы статуса сервисов

Что мы настраиваем и зачем

В современном мире стабильность и доступность онлайн-сервисов имеют критическое значение. Будь то SaaS-платформа, игровой сервер или личный проект, пользователи ожидают бесперебойной работы. Однако инциденты, плановые работы или непредвиденные сбои неизбежны. В таких ситуациях крайне важно иметь эффективный способ информирования вашей аудитории. Именно для этого и предназначен Cachet.

Cachet — это элегантное и мощное open-source решение для создания публичной страницы статуса (status page). Оно позволяет вам прозрачно сообщать о состоянии ваших сервисов, публиковать уведомления о плановых работах, регистрировать инциденты и показывать историю их устранения. Используя Cachet, вы повышаете доверие пользователей, снижаете нагрузку на службу поддержки во время сбоев и демонстрируете профессиональный подход к управлению инфраструктурой.

В итоге, по завершении этого руководства, вы получите полностью функциональную, безопасную и поддерживаемую страницу статуса, размещенную на вашем собственном VPS. Вы сможете создавать компоненты (например, "Веб-сервер", "База данных", "API"), связывать их с метриками, публиковать инциденты с обновлениями в реальном времени и информировать подписчиков через различные каналы.

Существуют различные подходы к созданию страниц статуса. Некоторые предпочитают использовать облачные управляемые сервисы, такие как Statuspage.io (Atlassian), Instatus, Better Uptime или Atlassian Opsgenie. Эти решения предлагают удобство, готовые интеграции и минимальные затраты на настройку, но часто сопровождаются ежемесячными платежами, ограничениями на количество компонентов или подписчиков, а также меньшим контролем над данными и кастомизацией. Для многих проектов, особенно на ранних стадиях или с ограниченным бюджетом, эти затраты могут быть значительными.

Альтернативный подход — self-hosted решение на собственном VPS. Это дает вам полный контроль над инфраструктурой, данными и возможностями кастомизации. Вы платите только за VPS, что часто оказывается значительно дешевле в долгосрочной перспективе, особенно если у вас уже есть сервер. Это также обеспечивает большую конфиденциальность, поскольку все данные хранятся на вашей машине. Cachet является одним из лучших open-source решений для self-hosting, предлагая богатый функционал и активное сообщество. Именно этот путь мы и выберем в данном руководстве, развернув Cachet на VPS.

Какой VPS-конфиг нужен под эту задачу

Выбор подходящего VPS для Cachet зависит от ожидаемой нагрузки, количества компонентов, инцидентов и числа подписчиков. Cachet не является ресурсоемким приложением для большинства сценариев, но важно обеспечить стабильную работу веб-сервера, PHP-FPM и базы данных.

Минимальные требования для Cachet (актуально для 2026 года):

• Процессор (CPU): 1-2 vCPU. Для Cachet достаточно одного ядра современного процессора (например, Intel Xeon E-series или AMD EPYC). Если вы планируете запускать другие сервисы на том же VPS или ожидаете очень высокий трафик, можно рассмотреть 2 vCPU.
• Оперативная память (RAM): 2 GB. Этого объема будет достаточно для операционной системы (Ubuntu 24.04 LTS), веб-сервера Nginx, PHP-FPM, MySQL 8.0 и самого приложения Cachet. При активном использовании или большом количестве посетителей страницы статуса, 4 GB RAM обеспечат более комфортную работу.
• Диск (Storage): 40 GB SSD. Основное пространство займет операционная система (около 10-15 GB), файлы Cachet (несколько сотен мегабайт) и база данных. SSD-накопитель критичен для хорошей производительности базы данных. Для долгосрочной перспективы и хранения бэкапов рекомендуется 60-80 GB. NVMe SSD будет идеальным выбором для максимальной производительности.
• Сеть (Network): 100 Mbps - 1 Gbps. Для страницы статуса, которая в основном отдает статический контент и небольшие объемы данных из БД, 100 Mbps обычно достаточно. Однако, современные VPS часто предлагают 1 Gbps порты, что является предпочтительным для общей производительности и масштабируемости.
• Операционная система: Ubuntu Server 24.04 LTS (или другая современная LTS-версия Debian-based дистрибутива).

Конкретный VPS-план под задачу:

Для типовой установки Cachet, способной обслуживать несколько тысяч посетителей в день и отслеживать до 20-30 компонентов, подойдёт VPS со следующими характеристиками: 2 vCPU, 4 GB RAM, 80 GB NVMe SSD, 1 Gbps порт. Такой конфигурации хватит с запасом для стабильной работы Cachet и потенциального расширения функционала.

Можно рассмотреть VPS с указанными характеристиками или аналогичные предложения от других провайдеров.

Когда нужен dedicated сервер, а не VPS:

Dedicated серверы обычно требуются для гораздо более масштабных задач, чем просто страница статуса Cachet. Рассмотрите dedicated сервер, если:

• Вы планируете размещать Cachet вместе с десятками других высоконагруженных сервисов на одной машине.
• Требуется очень высокая производительность ввода/вывода (I/O) или специфическое аппаратное обеспечение, недоступное на VPS.
• У вас тысячи или десятки тысяч активных подписчиков, и вы ожидаете очень высокий трафик на страницу статуса во время крупных инцидентов.
• Вам нужны строгие требования к соответствию нормативным актам, которые требуют физической изоляции оборудования.
• Вы хотите полный контроль над аппаратным обеспечением, включая выбор конкретных моделей CPU, RAM, RAID-контроллеров и сетевых карт.

Для большинства пользователей, развертывающих Cachet, VPS будет более чем достаточным и экономически выгодным решением.

Локация: на что влияет

Выбор локации VPS имеет значение по нескольким причинам:

• Задержка (Latency): Размещайте сервер как можно ближе к вашей основной аудитории или к серверам, статус которых вы отслеживаете. Меньшая задержка означает более быстрый доступ к странице статуса для ваших пользователей.
• Законодательство о данных: В зависимости от юрисдикции вашей компании и ваших пользователей, могут быть требования к хранению данных в определенной стране или регионе (например, GDPR в Европе). Убедитесь, что выбранная локация соответствует этим требованиям.
• Цена: Стоимость VPS может незначительно отличаться в разных регионах.
• Геополитические риски: В некоторых случаях выбор локации может быть продиктован стремлением избежать определенных геополитических рисков.

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

Подготовка сервера

Перед тем как приступить к установке Cachet, необходимо выполнить базовую подготовку вашего свежего VPS. Мы будем использовать Ubuntu Server 24.04 LTS, так как это актуальная и стабильная версия операционной системы, поддерживаемая до 2029 года.

1. Подключение по SSH и создание пользователя

После получения данных для доступа к VPS (IP-адрес, root-пароль), подключитесь к нему через SSH. Рекомендуется не использовать пользователя root для повседневной работы. Создайте нового пользователя с правами sudo и настройте аутентификацию по SSH-ключам.

ssh root@ВАШ_IP_АДРЕС # Подключаемся как root
adduser имя_пользователя # Создаем нового пользователя
usermod -aG sudo имя_пользователя # Добавляем пользователя в группу sudo

Теперь скопируйте ваш публичный SSH-ключ на сервер для нового пользователя. Если у вас нет SSH-ключа, создайте его на локальной машине с помощью ssh-keygen.

# На локальной машине:
ssh-copy-id имя_пользователя@ВАШ_IP_АДРЕС

После этого выйдите из сессии root и войдите под новым пользователем:

exit
ssh имя_пользователя@ВАШ_IP_АДРЕС

2. Отключение аутентификации по паролю для root и SSH-пароля (опционально, но рекомендуется)

Для повышения безопасности рекомендуется отключить вход по паролю для root и, возможно, для всех пользователей, разрешая только аутентификацию по SSH-ключам. Отредактируйте файл /etc/ssh/sshd_config.

sudo nano /etc/ssh/sshd_config

Найдите и измените следующие строки:

# PermitRootLogin yes # Закомментируйте или установите no
PermitRootLogin no
PasswordAuthentication no # Отключаем вход по паролю для всех пользователей
ChallengeResponseAuthentication no

Перезапустите SSH-сервис:

sudo systemctl restart sshd

ВАЖНО: Убедитесь, что вы можете войти под новым пользователем по SSH-ключу, прежде чем отключать PasswordAuthentication. В противном случае вы потеряете доступ к серверу.

3. Обновление системы и установка базовых утилит

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

sudo apt update # Обновляем список доступных пакетов
sudo apt upgrade -y # Устанавливаем обновления для всех пакетов
sudo apt install -y curl wget git unzip htop # Устанавливаем полезные утилиты

4. Настройка фаервола (UFW)

Uncomplicated Firewall (UFW) — это простой в использовании интерфейс для netfilter. Настройте его для разрешения только необходимых подключений: SSH (порт 22), HTTP (порт 80) и HTTPS (порт 443).

sudo ufw allow OpenSSH # Разрешаем SSH-подключение
sudo ufw allow http # Разрешаем HTTP (порт 80)
sudo ufw allow https # Разрешаем HTTPS (порт 443)
sudo ufw enable # Включаем фаервол (подтвердите 'y')
sudo ufw status # Проверяем статус фаервола

5. Установка Fail2Ban

Fail2Ban сканирует логи сервера (например, логи SSH) на предмет подозрительной активности (многочисленные неудачные попытки входа) и временно блокирует IP-адреса злоумышленников. Это значительно повышает безопасность вашего сервера.

sudo apt install -y fail2ban # Устанавливаем Fail2Ban
sudo systemctl enable fail2ban # Включаем автозапуск при загрузке
sudo systemctl start fail2ban # Запускаем сервис
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local # Создаем локальную копию для настроек
sudo nano /etc/fail2ban/jail.local # Редактируем конфигурацию

В файле jail.local убедитесь, что секция [sshd] активна (enabled = true). Вы также можете настроить bantime (время блокировки) и findtime (период для обнаружения попыток) по своему усмотрению.

# Пример настройки в jail.local:
[DEFAULT]
bantime = 1h # Блокировать на 1 час
findtime = 10m # Сканировать за 10 минут
maxretry = 5 # Блокировать после 5 неудачных попыток

[sshd]
enabled = true
port = ssh
logpath = %(sshd_log)s
backend = %(sshd_backend)s

После изменений перезапустите Fail2Ban:

sudo systemctl restart fail2ban
sudo fail2ban-client status # Проверяем статус
sudo fail2ban-client status sshd # Проверяем статус для SSH

Теперь ваш сервер готов к установке основного программного обеспечения.

Установка ПО — пошагово

Cachet построен на фреймворке Laravel, поэтому нам потребуются веб-сервер (Nginx), интерпретатор PHP с необходимыми расширениями, менеджер зависимостей Composer и база данных (MySQL). Мы будем использовать актуальные версии ПО на 2026 год.

1. Установка Nginx 1.28.x

Nginx будет выступать в роли веб-сервера, обслуживающего запросы к Cachet.

sudo apt install -y nginx # Устанавливаем Nginx
sudo systemctl enable nginx # Включаем автозапуск Nginx
sudo systemctl start nginx # Запускаем Nginx
sudo systemctl status nginx # Проверяем статус Nginx

После установки Nginx должен быть доступен по IP-адресу вашего VPS (вы увидите страницу-заглушку Nginx).

2. Установка PHP 8.4 и необходимых расширений

Cachet требует PHP 8.1 или выше. Мы установим PHP 8.4, который будет актуален в 2026 году, вместе с PHP-FPM (FastCGI Process Manager) и всеми необходимыми расширениями.

sudo apt install -y software-properties-common # Устанавливаем утилиты для работы с репозиториями
sudo add-apt-repository ppa:ondrej/php -y # Добавляем репозиторий Ondrej PPA для актуальных версий PHP
sudo apt update # Обновляем список пакетов после добавления PPA
sudo apt install -y php8.4 php8.4-fpm php8.4-mysql php8.4-gd php8.4-mbstring php8.4-xml php8.4-bcmath php8.4-curl php8.4-zip php8.4-tokenizer php8.4-json # Устанавливаем PHP 8.4 и все нужные расширения
sudo systemctl enable php8.4-fpm # Включаем автозапуск PHP-FPM
sudo systemctl start php8.4-fpm # Запускаем PHP-FPM
sudo systemctl status php8.4-fpm # Проверяем статус PHP-FPM

Репозиторий Ondrej PPA обеспечивает доступ к самым свежим версиям PHP на Ubuntu.

3. Установка MySQL Server 8.0.x

Cachet использует базу данных для хранения всей информации о компонентах, инцидентах, подписчиках и настройках. Мы установим MySQL 8.0.

sudo apt install -y mysql-server # Устанавливаем MySQL Server
sudo systemctl enable mysql # Включаем автозапуск MySQL
sudo systemctl start mysql # Запускаем MySQL
sudo systemctl status mysql # Проверяем статус MySQL

После установки рекомендуется запустить скрипт безопасности MySQL для установки пароля root, удаления анонимных пользователей и тестовой базы данных.

sudo mysql_secure_installation # Запускаем скрипт безопасности MySQL

Следуйте инструкциям на экране: установите надежный пароль для пользователя root, удалите анонимных пользователей, запретите удаленный вход root и удалите тестовую базу данных.

4. Создание базы данных и пользователя для Cachet

Подключитесь к MySQL от имени root и создайте новую базу данных и пользователя для Cachet с соответствующими правами.

sudo mysql -u root -p # Подключаемся к MySQL от root (введите пароль, установленный ранее)

Внутри MySQL-консоли выполните следующие команды, заменив cachet_db, cachet_user и ВАШ_ПАРОЛЬ_ДЛЯ_БД на свои значения:

CREATE DATABASE cachet_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # Создаем базу данных
CREATE USER 'cachet_user'@'localhost' IDENTIFIED BY 'ВАШ_ПАРОЛЬ_ДЛЯ_БД'; # Создаем пользователя
GRANT ALL PRIVILEGES ON cachet_db. TO 'cachet_user'@'localhost'; # Выдаем права на базу данных
FLUSH PRIVILEGES; # Обновляем привилегии
EXIT; # Выходим из MySQL-консоли

curl -sS https://getcomposer.org/installer -o composer-setup.php # Скачиваем скрипт установки Composer
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer # Устанавливаем Composer глобально
rm composer-setup.php # Удаляем скрипт установки
composer --version # Проверяем установленную версию (должна быть 2.7.x или выше)

cd /var/www/ # Переходим в директорию для веб-сайтов
sudo git clone https://github.com/CachetHQ/Cachet.git cachet # Клонируем репозиторий Cachet
cd cachet # Переходим в директорию Cachet
sudo git checkout v2.4.0 # Переключаемся на последнюю стабильную версию (актуально на 2026, возможно v2.5.x)
sudo cp .env.example .env # Создаем файл .env из примера
sudo chown -R www-data:www-data /var/www/cachet # Устанавливаем владельца директории
sudo chmod -R 775 /var/www/cachet/storage # Устанавливаем права на директорию storage
sudo chmod -R 775 /var/www/cachet/bootstrap/cache # Устанавливаем права на директорию bootstrap/cache

sudo composer install --no-dev -o # Устанавливаем зависимости, оптимизируем автозагрузчик

sudo php artisan key:generate # Генерируем ключ приложения

sudo php artisan migrate --force # Запускаем миграции базы данных

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

После установки всех компонентов необходимо правильно их настроить, чтобы Cachet мог работать корректно и безопасно.

1. Настройка файла .env

Файл .env содержит все переменные окружения для приложения Laravel, включая настройки базы данных, URL приложения и другие важные параметры. Отредактируйте его, чтобы Cachet мог подключиться к вашей базе данных и правильно формировать ссылки.

sudo nano /var/www/cachet/.env

Найдите и измените следующие строки, используя данные, которые вы создали ранее:

APP_NAME="Cachet"
APP_ENV=production
APP_KEY=ВАШ_СГЕНЕРИРОВАННЫЙ_КЛЮЧ # Уже сгенерирован командой key:generate
APP_DEBUG=false # В production всегда false
APP_URL=https://status.yourdomain.com # Укажите ваш домен с HTTPS

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cachet_db # Имя вашей базы данных
DB_USERNAME=cachet_user # Имя пользователя базы данных
DB_PASSWORD=ВАШ_ПАРОЛЬ_ДЛЯ_БД # Пароль пользователя базы данных

CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=database # Используем базу данных для очередей

Сохраните изменения (Ctrl+O, Enter, Ctrl+X).

2. Настройка Nginx для Cachet

Создадим новый конфигурационный файл Nginx для вашего домена. Замените status.yourdomain.com на ваш реальный домен.

sudo nano /etc/nginx/sites-available/status.yourdomain.com.conf

Вставьте следующий блок конфигурации:

server {
    listen 80;
    listen [::]:80;
    server_name status.yourdomain.com; # Ваш домен

    root /var/www/cachet/public; # Путь к директории public Cachet

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";

    index index.php index.html index.htm;

    charset utf-8;

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

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.4-fpm.sock; # Указываем сокет PHP-FPM
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known). {
        deny all;
    }
}

Сохраните файл, затем создайте символическую ссылку на него в sites-enabled и проверьте конфигурацию Nginx.

sudo ln -s /etc/nginx/sites-available/status.yourdomain.com.conf /etc/nginx/sites-enabled/ # Создаем симлинк
sudo nginx -t # Проверяем синтаксис конфигурации Nginx
sudo systemctl reload nginx # Перезагружаем Nginx для применения изменений

3. Настройка HTTPS с помощью Caddy

Использование HTTPS является обязательным для любой публичной страницы. Caddy — это современный веб-сервер, который автоматически управляет сертификатами Let's Encrypt, что делает его идеальным для быстрой настройки HTTPS. Если вы предпочитаете Nginx + Certbot, вы можете пропустить этот шаг и перейти к следующему.

3.1. Установка Caddy:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https # Устанавливаем необходимые пакеты
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg # Добавляем GPG ключ
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list # Добавляем репозиторий Caddy
sudo apt update # Обновляем список пакетов
sudo apt install -y caddy # Устанавливаем Caddy
sudo systemctl stop nginx # Останавливаем Nginx, так как Caddy будет использовать 80 и 443 порты
sudo systemctl disable nginx # Отключаем автозапуск Nginx

3.2. Настройка Caddyfile:

sudo nano /etc/caddy/Caddyfile

Удалите существующее содержимое и вставьте следующее, заменив status.yourdomain.com на ваш домен:

status.yourdomain.com {
    root  /var/www/cachet/public
    file_server

    php_fastcgi unix//run/php/php8.4-fpm.sock

    # Обработка ошибок для Laravel
    handle_errors {
        rewrite  /index.php
    }

    # Включаем автоматическое HTTPS
    tls {
        dns cloudflare {env.CLOUDFLARE_API_TOKEN} # Пример для Cloudflare DNS, если ваш домен там.
                                                 # Если вы используете обычные A/AAAA записи, просто оставьте 'tls'
    }

    log {
        output file /var/log/caddy/cachet_access.log
        format json
    }

    # Дополнительные заголовки безопасности
    header {
        X-Frame-Options "SAMEORIGIN"
        X-XSS-Protection "1; mode=block"
        X-Content-Type-Options "nosniff"
        Referrer-Policy "strict-origin-when-cross-origin"
    }
}

Если вы используете Cloudflare для DNS, вам нужно будет создать токен API Cloudflare и добавить его в переменные окружения Caddy (например, через systemd override или /etc/environment) или использовать tls internal для самоподписанных сертификатов (не рекомендуется для публичных сервисов). Для большинства пользователей достаточно просто tls, и Caddy сам получит сертификат через HTTP-01 вызов.

sudo systemctl restart caddy # Перезапускаем Caddy
sudo systemctl status caddy # Проверяем статус Caddy

4. Настройка HTTPS с помощью Certbot (для Nginx)

Если вы решили использовать Nginx, то для HTTPS вам потребуется Certbot от Let's Encrypt.

sudo snap install core # Убедитесь, что snap установлен
sudo snap refresh core # Обновляем snap
sudo snap install --classic certbot # Устанавливаем Certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot # Создаем симлинк
sudo certbot --nginx -d status.yourdomain.com # Запускаем Certbot для Nginx

Certbot автоматически настроит Nginx для HTTPS и создаст задания cron для автоматического продления сертификатов. Следуйте инструкциям на экране.

5. Настройка Cron-заданий для Cachet

Cachet требует cron-задания для выполнения фоновых задач, таких как отправка уведомлений и обновление метрик.

sudo crontab -e -u www-data # Открываем crontab для пользователя www-data (или того, под кем работает PHP-FPM)

Добавьте следующую строку в конец файла:

     php /var/www/cachet/artisan schedule:run >> /dev/null 2>&1

sudo systemctl status php8.4-fpm # Проверяем PHP-FPM
sudo systemctl status mysql # Проверяем MySQL
sudo systemctl status nginx # Проверяем Nginx (если используете его)
sudo systemctl status caddy # Проверяем Caddy (если используете его)

curl -I https://status.yourdomain.com # Проверяем заголовки HTTP

Бэкапы и обслуживание

Резервное копирование — это критически важная часть любой инфраструктуры. Потеря данных может иметь катастрофические последствия. Для Cachet необходимо регулярно бэкапить базу данных и файлы приложения.

1. Что бэкапить

• База данных: Это самое важное. Содержит все компоненты, инциденты, метрики, подписчиков и настройки Cachet.
• Файлы приложения:
  • .env: Файл конфигурации Cachet с чувствительными данными (ключи, пароли БД).
  • storage/: Директория, где Cachet хранит различные файлы, такие как логи, кэш, сессии и загруженные файлы (если есть).
  • public/uploads/: Если вы разрешаете загрузку изображений или других файлов.
• Конфигурации веб-сервера: Файлы конфигурации Nginx (/etc/nginx/sites-available/status.yourdomain.com.conf) или Caddy (/etc/caddy/Caddyfile).

2. Простой скрипт автобэкапа

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

sudo mkdir -p /opt/backups/cachet # Создаем директорию для бэкапов
sudo chown имя_пользователя:имя_пользователя /opt/backups/cachet # Даем права вашему пользователю
nano /opt/backups/cachet/backup_cachet.sh

Вставьте следующий скрипт, заменив переменные на свои значения:

#!/bin/bash

# Настройки базы данных
DB_NAME="cachet_db"
DB_USER="cachet_user"
DB_PASS="ВАШ_ПАРОЛЬ_ДЛЯ_БД"

# Пути
BACKUP_DIR="/opt/backups/cachet"
CACHET_APP_DIR="/var/www/cachet"
NGINX_CONF_DIR="/etc/nginx/sites-available" # Или /etc/caddy для Caddy

DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_FILE="${BACKUP_DIR}/cachet_backup_${DATE}.tar.gz"
DB_DUMP_FILE="${BACKUP_DIR}/cachet_db_dump_${DATE}.sql"

# 1. Дамп базы данных
echo "Dumping database..."
mysqldump -u "${DB_USER}" -p"${DB_PASS}" "${DB_NAME}" > "${DB_DUMP_FILE}"
if [ $? -eq 0 ]; then
    echo "Database dump successful."
else
    echo "Database dump failed!"
    exit 1
fi

# 2. Архивирование файлов Cachet и конфигов
echo "Archiving Cachet files and configs..."
tar -czf "${BACKUP_FILE}" \
    "${CACHET_APP_DIR}/.env" \
    "${CACHET_APP_DIR}/storage" \
    "${CACHET_APP_DIR}/public/uploads" \
    "${NGINX_CONF_DIR}/status.yourdomain.com.conf" \ # Или /etc/caddy/Caddyfile
    "${DB_DUMP_FILE}"
if [ $? -eq 0 ]; then
    echo "File archiving successful."
else
    echo "File archiving failed!"
    exit 1
fi

# 3. Удаление старых бэкапов (например, старше 7 дней)
echo "Cleaning up old backups..."
find "${BACKUP_DIR}" -type f -name "cachet_backup_.tar.gz" -mtime +7 -delete
find "${BACKUP_DIR}" -type f -name "cachet_db_dump_.sql" -mtime +7 -delete
echo "Backup process finished."

sudo chmod +x /opt/backups/cachet/backup_cachet.sh

sudo crontab -e # Открываем crontab для вашего пользователя

0 3    /opt/backups/cachet/backup_cachet.sh >> /var/log/cachet_backup.log 2>&1

Эта команда будет запускать скрипт каждый день в 03:00 и записывать вывод в файл лога.

4. Куда складывать бэкапы

Хранение бэкапов на том же сервере, что и основной сервис, крайне рискованно. Если сервер выйдет из строя (отказ диска, пожар в ЦОД), вы потеряете и сервис, и бэкапы. Рекомендуется использовать удаленное хранилище:

• Облачное хранилище S3-совместимое: Amazon S3, DigitalOcean Spaces, Backblaze B2. Это надежный и относительно недорогой способ хранения. Используйте утилиты типа s3cmd, rclone или awscli для загрузки бэкапов.
• Отдельный VPS: Вы можете настроить второй, небольшой VPS и использовать rsync или scp для копирования бэкапов на него. Это обеспечивает географическое распределение.
• Локальное хранилище с синхронизацией: Если у вас есть NAS или другой сервер в вашей локальной сети, вы можете синхронизировать бэкапы туда.

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

5. Обновления: rolling vs maintenance window

Поддержание ПО в актуальном состоянии критично для безопасности и стабильности. Различают два основных подхода к обновлениям:

• Rolling updates (непрерывные обновления): Применяются к кластерам серверов, где обновление происходит поочередно, без общего простоя сервиса. Для одного VPS это не применимо.
• Maintenance Window (окно обслуживания): Запланированный период времени, когда сервис может быть недоступен или работать с ограничениями для проведения обновлений. Это наиболее реалистичный подход для Cachet на одном VPS.

Рекомендации по обновлению:

• Обновление ОС и пакетов: Регулярно (раз в месяц или квартал) запускайте sudo apt update && sudo apt upgrade -y. Планируйте это на время наименьшей нагрузки.
• Обновление Cachet: Отслеживайте релизы Cachet на GitHub. Для обновления обычно требуется:
  1. Перевести Cachet в режим обслуживания (php artisan down).
  2. Сделать бэкап.
  3. Выполнить git pull или скачать новую версию.
  4. Запустить composer install --no-dev -o.
  5. Выполнить миграции базы данных (php artisan migrate --force).
  6. Очистить кэш (php artisan cache:clear && php artisan config:clear).
  7. Вывести Cachet из режима обслуживания (php artisan up).
• Мониторинг: После любых обновлений тщательно проверьте работоспособность Cachet и всех его функций.

Всегда сообщайте своим пользователям о плановых работах через саму страницу статуса (если она еще работает) или по другим каналам связи.

Troubleshooting + FAQ

В процессе установки и эксплуатации Cachet могут возникнуть различные проблемы. Здесь мы рассмотрим типичные сценарии и предложим решения, а также ответим на часто задаваемые вопросы.

1. Cachet выдает ошибку 500 Internal Server Error

Что проверить: Это самая распространенная ошибка. Она указывает на проблему на стороне сервера или PHP.

1. Логи PHP-FPM: Проверьте логи PHP-FPM на наличие ошибок. Обычно они находятся в /var/log/php8.4-fpm.log или /var/log/nginx/error.log (если Nginx не может связаться с PHP-FPM).
2. Логи Laravel: Cachet как приложение Laravel записывает ошибки в /var/www/cachet/storage/logs/laravel.log. Это наиболее информативный источник.
3. Права доступа: Убедитесь, что пользователь www-data (или пользователь, под которым работает PHP-FPM) имеет права на чтение/запись в директории /var/www/cachet/storage и /var/www/cachet/bootstrap/cache.
4. .env файл: Проверьте правильность настроек базы данных и APP_KEY в файле /var/www/cachet/.env.
5. Расширения PHP: Убедитесь, что все необходимые PHP-расширения установлены и включены.

2. Страница не загружается, Nginx/Caddy выдает 403 Forbidden

Что проверить: Это означает, что веб-серверу отказано в доступе к файлам.

1. Права доступа к корневой директории: Убедитесь, что директория /var/www/cachet/public и ее содержимое принадлежат www-data и имеют правильные права.
2. Конфигурация Nginx/Caddy: Проверьте, что root в вашем server-блоке Nginx или Caddyfile указывает на /var/www/cachet/public.
3. SELinux/AppArmor: На некоторых системах эти модули безопасности могут блокировать доступ. На Ubuntu по умолчанию используется AppArmor. Проверьте логи (sudo journalctl -xe) на сообщения о блокировке. Обычно для Nginx или Caddy не требуется дополнительных настроек AppArmor.

3. Проблемы с подключением к базе данных

Что проверить: Если Cachet не может подключиться к MySQL.

1. Статус MySQL: Убедитесь, что MySQL запущен: sudo systemctl status mysql.
2. Настройки .env: Проверьте DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD в файле .env.
3. Пользователь и права: Убедитесь, что пользователь базы данных cachet_user существует и имеет права на базу данных cachet_db. Попробуйте подключиться к MySQL от имени этого пользователя из командной строки: mysql -u cachet_user -p cachet_db.
4. Фаервол: Убедитесь, что MySQL не блокируется фаерволом (по умолчанию MySQL слушает только localhost, что правильно).

4. Cachet не отправляет уведомления

Что проверить: Если подписчики не получают email или другие уведомления.

1. Настройки почты в .env: Проверьте секцию MAIL_DRIVER, MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_ENCRYPTION, MAIL_FROM_ADDRESS, MAIL_FROM_NAME в .env.
2. Cron-задание: Убедитесь, что cron-задание для планировщика Laravel (php artisan schedule:run) настроено и выполняется каждую минуту. Проверьте логи cron.
3. Очереди: Cachet использует очереди для отправки уведомлений. Убедитесь, что QUEUE_DRIVER=database в .env и таблица jobs в базе данных создана (php artisan migrate).
4. Логи Laravel: Проверьте laravel.log на ошибки, связанные с отправкой почты.

5. Какой VPS-конфиг минимально подойдёт?

Для минимальной установки Cachet, способной обслуживать небольшой проект или тестовую среду, достаточно VPS с 1 vCPU, 2 GB RAM, 40 GB SSD. Этой конфигурации хватит для работы операционной системы, веб-сервера (Nginx или Caddy), PHP-FPM и MySQL. Однако, для более стабильной работы и возможности масштабирования в будущем, рекомендуется использовать 2 vCPU, 4 GB RAM, 80 GB NVMe SSD, как описано в секции "Какой VPS-конфиг нужен под эту задачу".

6. Что выбрать — VPS или dedicated для этой задачи?

Для развертывания публичной страницы статуса Cachet в подавляющем большинстве случаев VPS является оптимальным выбором. Он предлагает достаточную производительность, гибкость и экономичность. Dedicated серверы избыточны для Cachet, если только вы не планируете размещать на нем множество других высоконагруженных сервисов, не имеете строгих требований к физической изоляции или не ожидаете чрезвычайно высокого трафика (десятки тысяч одновременных пользователей во время глобальных сбоев). Большинство проектов успешно используют Cachet на VPS средней конфигурации.

7. Как обновить Cachet до новой версии?

Процесс обновления Cachet включает несколько шагов. Во-первых, всегда делайте полный бэкап базы данных и файлов приложения. Затем переведите Cachet в режим обслуживания с помощью команды php artisan down. После этого перейдите в директорию Cachet (/var/www/cachet), получите последнюю версию кода (например, git pull или скачайте новый архив). Обновите зависимости Composer командой composer install --no-dev -o. Выполните миграции базы данных командой php artisan migrate --force, а также очистите кэш: php artisan cache:clear && php artisan config:clear. Наконец, выведите Cachet из режима обслуживания командой php artisan up и проверьте работоспособность.

8. Как настроить метрики и графики в Cachet?

Cachet позволяет добавлять метрики для отслеживания различных параметров сервисов, таких как время отклика, использование CPU или памяти. Для этого после входа в панель администратора перейдите в раздел "Метрики" (Metrics) и создайте новую метрику. Вы можете вручную вводить данные или использовать API Cachet для автоматической отправки данных из ваших систем мониторинга (например, Prometheus, Zabbix, Grafana). Cachet предоставляет API-токен в настройках, который можно использовать для POST-запросов с данными метрик. Например, можно написать небольшой скрипт, который будет парсить данные из вашей системы мониторинга и отправлять их в Cachet по расписанию.

Выводы и следующие шаги

Поздравляем! Вы успешно развернули и настроили Cachet на вашем VPS, создав надежную и профессиональную публичную страницу статуса для ваших сервисов. Теперь вы можете эффективно коммуницировать с вашей аудиторией, повышая прозрачность и доверие в случае инцидентов или плановых работ. Вы получили полный контроль над вашей страницей статуса, ее данными и возможностями кастомизации.

Дальнейшие шаги для оптимизации и расширения функционала вашей страницы статуса включают:

• Интеграция с системами мониторинга: Используйте API Cachet для автоматической публикации инцидентов и обновления метрик из ваших существующих систем мониторинга, таких как Prometheus, Zabbix или Grafana. Это позволит автоматизировать процесс информирования и сократить время реакции.
• Настройка уведомлений: Настройте различные каналы уведомлений (Slack, Telegram, Webhooks) для вашей команды, чтобы получать оперативные оповещения о новых инцидентах или изменениях статуса.
• Кастомизация внешнего вида: Изучите возможности кастомизации темы Cachet, чтобы страница статуса соответствовала брендингу вашего проекта. Вы можете изменить цвета, шрифты и добавить свой логотип.
• Регулярный аудит и обслуживание: Поддерживайте ваш VPS и Cachet в актуальном состоянии, регулярно применяя обновления безопасности и проводя резервное копирование. Это обеспечит долгосрочную стабильность и безопасность вашей страницы статуса.