Установка · 5 min read · Oct 18, 2025

Как установить систему страницы состояния Cachet на Debian 9

Cachet — это красивая и мощная система страницы состояния с открытым исходным кодом, написанная на PHP, которая позволяет вам лучше сообщать о простоях и сбоях системы вашим клиентам, командам и акционерам. Приложение предоставляет вам множество функций, среди которых: мощный JSON API, отчеты о происшествиях, метрики, поддержка markdown для сообщений о происшествиях, уведомления для подписчиков по электронной почте, двухфакторная аутентификация. В этом руководстве мы установим систему страницы состояния Cachet, используя PHP, Nginx, MariaDB и Composer.

Требования

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

Предварительные условия

  • Сервер с установленным Debian 9.
    Пользователь без прав root с привилегиями sudo.

Начальные шаги

Проверьте версию Debian:

lsb_release -ds  
# Debian GNU/Linux 9.5 (stretch)

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

timedatectl list-timezones  
sudo timedatectl set-timezone 'Region/City'

Обновите пакеты вашей операционной системы:

sudo apt update && sudo apt upgrade -y

Установите пакеты vim, git и socat:

sudo apt install -y vim git socat sudo

Шаг 1 - Установите PHP

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

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

Проверьте версию PHP:

php --version  
# PHP 7.0.30-0+deb9u1 (cli) (built: Jun 14 2018 13:50:25) ( NTS )

Шаг 2 - Установите MariaDB и создайте базу данных для Cachet

Cachet поддерживает базы данных MySQL/MariaDB, PostgreSQL и SQLite3. В этом руководстве мы будем использовать MariaDB в качестве сервера базы данных.

Установите сервер базы данных MariaDB:

sudo apt install -y mariadb-server

Проверьте версию MariaDB:

mysql --version  
# mysql  Ver 15.1 Distrib 10.1.26-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

Запустите скрипт mysql_secure_installation, чтобы улучшить безопасность MariaDB и установить пароль для пользователя MySQL root:

sudo mysql_secure_installation

Ответьте на каждый из вопросов:

Enter current password for root (enter for none): Нажмите Enter  
Set root password? [Y/n] Y  
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:

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

Создайте пустую базу данных MariaDB и пользователя для Cachet и запомните учетные данные:

MariaDB [(none)]> CREATE DATABASE dbname;  
MariaDB [(none)]> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
MariaDB [(none)]> FLUSH PRIVILEGES;

Выйдите из MariaDB:

MariaDB [(none)]> exit

Замените dbname, username и password на ваши собственные имена.

Шаг 3 - Установите клиент Acme.sh и получите сертификат Let’s Encrypt (по желанию)

Защита вашей страницы состояния с помощью HTTPS не является обязательной, но это хорошая практика для защиты трафика вашего сайта. Чтобы получить SSL-сертификат от Let’s Encrypt, мы будем использовать клиент Acme.sh. Acme.sh — это чистое программное обеспечение Unix shell для получения SSL-сертификатов от Let’s Encrypt без зависимостей.

Скачайте и установите Acme.sh:

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh   
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

Проверьте версию Acme.sh:

/etc/letsencrypt/acme.sh --version  
# v2.8.0

Получите RSA и ECC/ECDSA сертификаты для вашего домена/имени хоста:

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d status.example.com --ocsp-must-staple --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d status.example.com --ocsp-must-staple --keylength ec-256

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

  • Для RSA: директория /etc/letsencrypt/status.example.com.
  • Для ECC/ECDSA: директория /etc/letsencrypt/status.example.com_ecc.

Шаг 4 - Установите и настройте Nginx

Cachet может хорошо работать со многими веб-серверами. В этом руководстве мы выбрали Nginx.

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

sudo apt install -y nginx

Проверьте версию Nginx:

sudo nginx -v  
# nginx version: nginx/1.10.3

Настройте Nginx для Cachet, выполнив:

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

И заполните файл следующей конфигурацией:

server {  
  
  listen 80;  
  listen [::]:80;  
  
  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.0-fpm.sock;  
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    fastcgi_index index.php;  
    fastcgi_keep_conn on;  
  }  
  
}

Активируйте новую конфигурацию cachet.conf, связав файл с директорией sites-enabled:

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

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

sudo nginx -t

Перезагрузите Nginx:

sudo systemctl reload nginx.service

Шаг 5 - Установите Composer

Установите Composer, менеджер зависимостей PHP, глобально:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"  
  
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { 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:

composer --version  
# Composer version 1.7.2 2018-08-16 16:57:12

Шаг 6 - Установите Cachet

Создайте директорию корня документа, где должен находиться Cachet:

sudo mkdir -p /var/www/cachet

Перейдите в директорию корня документа:

cd /var/www/cachet

Скачайте исходный код Cachet с помощью Git и переключитесь на последнюю отмеченную версию:

git clone https://github.com/cachethq/Cachet.git .  
git tag -l  
git checkout v2.3.15

Скопируйте .env.example в файл .env и настройте параметры базы данных и APP_URL в файле .env:

cp .env.example .env  
vim .env

Установите зависимости Cachet с помощью Composer:

composer install --no-dev -o

Настройте ключ приложения, выполнив:

php artisan key:generate

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

php artisan app:install

Измените владельца директории /var/www/cachet на www-data:

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

Откройте ваш сайт в веб-браузере и следуйте инструкциям на экране, чтобы завершить установку Cachet.

Шаг 7 - Завершите настройку Cachet

Выберите драйверы кэша и сессии и настройте параметры электронной почты:

Завершите настройку cachet

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

Общие настройки Cachet

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

Добавить учетную запись администратора

После этого вы должны получить сообщение о том, что Cachet был успешно настроен. Вы можете открыть панель управления Cachet, нажав кнопку “Перейти к панели управления”:

Cachet был успешно установлен

Установка и настройка Cachet завершены.
Чтобы получить доступ к панели управления Cachet, добавьте /dashboard к URL вашего сайта.

Панель управления Cachet

Ссылки

Share: X/Twitter LinkedIn
#Установка

Get new posts in your inbox

No spam. Unsubscribe anytime.