RU

Приложения

Установка Prometheus и Grafana

Установите Prometheus, node_exporter и Grafana без Docker на Debian или Ubuntu: панели мониторинга, защищённый доступ по HTTPS, обновления и резервное копирование.

7 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство расскажет, как установить полноценную платформу мониторинга без Docker на VPS или выделенный сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04.

Компонент Назначение Порт Прослушивание
node_exporter Предоставляет системные метрики 9100 127.0.0.1
Prometheus Собирает и хранит метрики 9090 127.0.0.1
Grafana Отображает панели мониторинга 3000 127.0.0.1
Nginx Публикует Grafana по HTTPS 80, 443 Публичное

Публикуется только Grafana: за Nginx, по HTTPS и с учётной записью. Prometheus и node_exporter никогда не открываются в Интернет.

Заказать сервер

Для размещения системы мониторинга HostMyServers предлагает несколько вариантов:

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

  • Сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04 с архитектурой amd64 или arm64
  • SSH-доступ с пользователем, имеющим права sudo
  • Доменное имя с записью A: grafana.ваш-домен.com должно указывать на IP-адрес сервера
  • Для Grafana согласно её документации необходимо минимум 512 МБ ОЗУ и 1 ядро CPU — дополнительно к ресурсам, нужным Prometheus
  • Место на диске для метрик: оно зависит от числа собираемых рядов и срока хранения

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

Терминал
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget tar jq gnupg ufw nginx certbot python3-certbot-nginx apache2-utils

Настройте брандмауэр. Разрешите SSH до включения UFW и замените 22, если вы используете другой порт.

Терминал
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable

Порты 3000, 9090 и 9100 открывать нельзя.

Установка Prometheus

Создание пользователя и каталогов

Терминал
sudo useradd --system --no-create-home --shell /usr/sbin/nologin prometheus
sudo mkdir -p /etc/prometheus /var/lib/prometheus
sudo chown prometheus:prometheus /var/lib/prometheus

Загрузка и проверка архива

Терминал
VERSION=3.13.5
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/prometheus-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "prometheus-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "prometheus-${VERSION}.linux-${ARCH}/prometheus" "prometheus-${VERSION}.linux-${ARCH}/promtool" /usr/local/bin/
prometheus --version

Проверка должна вывести OK для загруженного архива.

Настройка сбора метрик

Терминал
sudo nano /etc/prometheus/prometheus.yml
YAML
global:
  scrape_interval: 15s
  evaluation_interval: 15s

scrape_configs:
  - job_name: prometheus
    static_configs:
      - targets: ["127.0.0.1:9090"]

  - job_name: node
    static_configs:
      - targets: ["127.0.0.1:9100"]

Проверьте файл:

Терминал
sudo chown -R root:prometheus /etc/prometheus
sudo chmod 750 /etc/prometheus
sudo chmod 640 /etc/prometheus/prometheus.yml
sudo promtool check config /etc/prometheus/prometheus.yml

Создание службы systemd

Терминал
sudo nano /etc/systemd/system/prometheus.service
Конфигурация
[Unit]
Description=Prometheus
Wants=network-online.target
After=network-online.target

[Service]
User=prometheus
Group=prometheus
Type=simple
ExecStart=/usr/local/bin/prometheus \
  --config.file=/etc/prometheus/prometheus.yml \
  --storage.tsdb.path=/var/lib/prometheus \
  --storage.tsdb.retention.time=30d \
  --web.listen-address=127.0.0.1:9090 \
  --web.enable-admin-api
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
NoNewPrivileges=true
ProtectSystem=full
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
Опция Действие
--storage.tsdb.retention.time=30d Хранит метрики 30 дней (по умолчанию — 15 дней)
--web.listen-address=127.0.0.1:9090 Слушает только локальный интерфейс
--web.enable-admin-api Включает API, используемый для резервного копирования через снимки

Запустите службу:

Терминал
sudo systemctl daemon-reload
sudo systemctl enable --now prometheus
sudo systemctl status prometheus --no-pager

Установка node_exporter

Терминал
sudo useradd --system --no-create-home --shell /usr/sbin/nologin node_exporter
VERSION=1.13.0
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "node_exporter-${VERSION}.linux-${ARCH}/node_exporter" /usr/local/bin/
sudo nano /etc/systemd/system/node_exporter.service
Конфигурация
[Unit]
Description=Prometheus Node Exporter
Wants=network-online.target
After=network-online.target

[Service]
User=node_exporter
Group=node_exporter
Type=simple
ExecStart=/usr/local/bin/node_exporter --web.listen-address=127.0.0.1:9100
Restart=on-failure
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target
Терминал
sudo systemctl daemon-reload
sudo systemctl enable --now node_exporter
curl -s http://127.0.0.1:9100/metrics | head -n 5

Убедитесь, что Prometheus собирает метрики с обеих целей. Подождите около пятнадцати секунд после запуска:

Терминал
curl -s http://127.0.0.1:9090/api/v1/targets | jq -r '.data.activeTargets[] | "\(.labels.job) \(.health)"'

Ожидаемый результат:

Текст
node up
prometheus up

Установка Grafana

Добавление официального репозитория

Терминал
sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt update
sudo apt install -y grafana

Ограничение Grafana локальным интерфейсом

Начальная учётная запись Grafana — admin / admin. Ограничьте прослушивание до первого запуска:

Терминал
sudo nano /etc/grafana/grafana.ini

В секции [server] раскомментируйте или добавьте:

Конфигурация
[server]
http_addr = 127.0.0.1
http_port = 3000

Запустите службу и убедитесь, что она отвечает:

Терминал
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server
sudo ss -tlnp | grep 3000
curl -s http://127.0.0.1:3000/api/health

Смена пароля администратора

Смените пароль до публикации Grafana. С вашего компьютера откройте SSH-туннель и не закрывайте эту сессию:

Терминал
ssh -L 3000:127.0.0.1:3000 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

Откройте http://localhost:3000, войдите с admin / admin, затем задайте надёжный пароль, когда Grafana об этом попросит. После этого туннель можно закрыть.

Добавление Prometheus как источника данных

Терминал
sudo nano /etc/grafana/provisioning/datasources/prometheus.yaml
YAML
apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://127.0.0.1:9090
    isDefault: true
    editable: false
Терминал
sudo chown root:grafana /etc/grafana/provisioning/datasources/prometheus.yaml
sudo chmod 640 /etc/grafana/provisioning/datasources/prometheus.yaml
sudo systemctl restart grafana-server

Публикация Grafana по HTTPS

Создание сайта Nginx

Терминал
sudo nano /etc/nginx/sites-available/grafana.conf
Nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

upstream grafana {
    server 127.0.0.1:3000;
}

server {
    listen 80;
    listen [::]:80;
    server_name grafana.ваш-домен.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://grafana;
    }

    location /api/live/ {
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_pass http://grafana;
    }
}
Терминал
sudo ln -s /etc/nginx/sites-available/grafana.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d grafana.ваш-домен.com -m admin@ваш-домен.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-run

Подробнее о сертификатах — в руководстве Установка SSL-сертификата с Let's Encrypt.

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

Терминал
sudo nano /etc/grafana/grafana.ini

Измените следующие секции:

Конфигурация
[server]
http_addr = 127.0.0.1
http_port = 3000
domain = grafana.ваш-домен.com
root_url = https://grafana.ваш-домен.com/

[security]
cookie_secure = true
cookie_samesite = lax
strict_transport_security = true

[users]
allow_sign_up = false
Терминал
sudo systemctl restart grafana-server

Импорт панели мониторинга

  1. Откройте https://grafana.ваш-домен.com и войдите.
  2. Нажмите Dashboards в главном меню.
  3. Нажмите New, затем Import dashboard.
  4. Введите идентификатор 1860 (Node Exporter Full) и нажмите Load.
  5. Выберите источник данных Prometheus, затем нажмите Import.

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

На сервере ни одна внутренняя служба не должна слушать публичный адрес:

Терминал
sudo ss -tlnp | grep -E ':(3000|9090|9100)\b'

Каждая строка должна начинаться с 127.0.0.1. С вашего компьютера эти команды должны завершаться ошибкой:

Терминал
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:3000/
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:9090/
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:9100/metrics

Наконец, https://grafana.ваш-домен.com должен показывать страницу входа с действительным сертификатом.

Чтобы открыть интерфейс Prometheus, воспользуйтесь SSH-туннелем, затем откройте http://localhost:9090:

Терминал
ssh -L 9090:127.0.0.1:9090 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

Защита Prometheus паролем (необязательно)

Локальное прослушивание уже исключает любой доступ из Интернета. Добавьте пароль, если к серверу имеют доступ другие пользователи или приложения.

Сначала сгенерируйте хеш пароля:

Терминал
htpasswd -nBC 12 "" | tr -d ':\n'; echo

Создайте /etc/prometheus/web.yml с помощью sudo nano и вставьте в него этот хеш:

YAML
basic_auth_users:
  admin: "ХЕШ_BCRYPT"

Сохраните также пароль в открытом виде: он нужен Prometheus для сбора собственных метрик:

Терминал
sudo install -o root -g prometheus -m 640 /dev/null /etc/prometheus/web-password
sudo nano /etc/prometheus/web-password
sudo chown root:prometheus /etc/prometheus/web.yml
sudo chmod 640 /etc/prometheus/web.yml
sudo promtool check web-config /etc/prometheus/web.yml

Затем внесите эти три изменения:

  1. В prometheus.service добавьте --web.config.file=/etc/prometheus/web.yml в команду ExecStart.

  2. В prometheus.yml дополните задание prometheus:

    YAML
    - job_name: prometheus
      basic_auth:
        username: admin
        password_file: /etc/prometheus/web-password
      static_configs:
        - targets: ["127.0.0.1:9090"]
  3. В источнике данных Grafana добавьте учётные данные:

    YAML
    basicAuth: true
    basicAuthUser: admin
    secureJsonData:
      basicAuthPassword: ВАШ_ПАРОЛЬ_PROMETHEUS

Перезагрузите конфигурацию и перезапустите службы:

Терминал
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl daemon-reload
sudo systemctl restart prometheus grafana-server

Теперь добавляйте -u admin к командам curl, обращающимся к порту 9090.

Мониторинг другого сервера

Установите node_exporter на второй сервер, указав в его службе --web.listen-address=0.0.0.0:9100. На этом втором сервере разрешите доступ только вашему серверу Prometheus:

Терминал
sudo ufw allow from IP_ВАШЕГО_СЕРВЕРА to any port 9100 proto tcp

Затем добавьте цель в /etc/prometheus/prometheus.yml и перезагрузите Prometheus:

YAML
  - job_name: node
    static_configs:
      - targets: ["127.0.0.1:9100", "IP_ВТОРОГО_СЕРВЕРА:9100"]
Терминал
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl reload prometheus

Обновление

Сначала сделайте резервную копию данных и прочитайте примечания к выпуску.

Prometheus: повторите блок загрузки с новым значением VERSION, затем выполните:

Терминал
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl restart prometheus
prometheus --version

node_exporter: аналогично повторите его загрузку и установку, затем выполните:

Терминал
sudo systemctl restart node_exporter
node_exporter --version

Grafana: пакет обновляется через APT.

Терминал
sudo apt update
sudo apt install --only-upgrade grafana
sudo systemctl restart grafana-server

Резервное копирование и восстановление

Prometheus

Документация Prometheus рекомендует снимки (snapshots):

Терминал
SNAPSHOT=$(curl -fsS -X POST http://127.0.0.1:9090/api/v1/admin/tsdb/snapshot | jq -r '.data.name')
sudo tar -czpf "/root/prometheus-${SNAPSHOT}.tar.gz" -C /var/lib/prometheus/snapshots "$SNAPSHOT"
sudo rm -rf "/var/lib/prometheus/snapshots/${SNAPSHOT}"
sudo tar -czpf "/root/prometheus-config-$(date +%F).tar.gz" /etc/prometheus /etc/systemd/system/prometheus.service

Чтобы восстановить снимок:

Терминал
sudo systemctl stop prometheus
sudo mv /var/lib/prometheus /var/lib/prometheus.old
sudo mkdir /var/lib/prometheus
sudo tar -xzpf /root/prometheus-ИМЯ_СНИМКА.tar.gz --strip-components=1 -C /var/lib/prometheus
sudo chown -R prometheus:prometheus /var/lib/prometheus
sudo systemctl start prometheus

Grafana

По умолчанию Grafana хранит учётные записи и панели мониторинга в базе SQLite /var/lib/grafana/grafana.db. Остановите службу на время копирования:

Терминал
sudo systemctl stop grafana-server
sudo tar -czpf "/root/grafana-$(date +%F).tar.gz" /var/lib/grafana /etc/grafana
sudo systemctl start grafana-server

Для восстановления:

Терминал
sudo systemctl stop grafana-server
sudo tar -xzpf /root/grafana-ГГГГ-ММ-ДД.tar.gz -C /
sudo chown -R grafana:grafana /var/lib/grafana
sudo systemctl start grafana-server

Эти архивы содержат секретные данные: ограничьте права на них командой sudo chmod 600 /root/*.tar.gz и скопируйте их за пределы сервера.

Если что-то не работает

Prometheus не запускается

Терминал
sudo journalctl -u prometheus -n 50 --no-pager
sudo promtool check config /etc/prometheus/prometheus.yml
sudo ls -ld /var/lib/prometheus

Ошибка permission denied для каталога данных исправляется командой sudo chown -R prometheus:prometheus /var/lib/prometheus. Ошибка address already in use означает, что порт 9090 занят другим процессом: найдите его командой sudo ss -tlnp | grep 9090.

Цель находится в состоянии down

Посмотрите поле lastError:

Терминал
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {job: .labels.job, health, lastError}'

connection refused означает, что экспортёр остановлен или слушает другой адрес. Ошибка context deadline exceeded при обращении к другому серверу скорее указывает на брандмауэр.

Ошибка 502 Bad Gateway в Grafana

Терминал
sudo systemctl status grafana-server --no-pager
sudo journalctl -u grafana-server -n 50 --no-pager
curl -s http://127.0.0.1:3000/api/health

Бесконечный цикл входа или сообщение «origin not allowed»

Убедитесь, что domain и root_url точно совпадают с адресом, который вы используете в браузере, и что Nginx передаёт заголовок Host. Параметр cookie_secure = true требует доступа по HTTPS.

На панели мониторинга нет данных

  • Убедитесь, что обе цели находятся в состоянии up.
  • Увеличьте отображаемый период до нескольких часов.
  • На панели мониторинга проверьте, что выбраны правильные источник данных, job и экземпляр.

Потерян пароль администратора Grafana

Сбросьте его на сервере, затем снова смените в интерфейсе:

Терминал
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password ВРЕМЕННЫЙ_ПАРОЛЬ

Диск заполняется

Уменьшите --storage.tsdb.retention.time или добавьте ограничение через --storage.tsdb.retention.size=10GB, затем выполните sudo systemctl daemon-reload и sudo systemctl restart prometheus. Руководство Проверка места на диске и использования в Linux поможет определить, что занимает место.

Что дальше

Если вам нужно более простое решение для одного сервера, обратитесь к руководству Мониторинг сервера с помощью Netdata.

Справочные материалы