WireGuard exporter для мониторинга личного VPS в 2026 году

WireGuard exporter позволяет собирать метрики о состоянии защищённого канала WireGuard и передавать их в Prometheus для мониторинга. С личным VPS SANSARA вы можете развернуть его за несколько минут и отслеживать подключения клиентов, объём трафика и статус туннеля. После регистрации в кабинете SANSARA вы получаете готовую конфигурацию для импорта в клиент WireGuard на своём устройстве. Остаётся только установить wireguard-exporter на сервер и подключить его к Prometheus.

Коротко:

• WireGuard exporter — это небольшой демон, который читает состояние интерфейса WireGuard и отдаёт метрики в формате Prometheus.
• Подходит администраторам, которые хотят видеть статистику по клиентам, трафику и доступности туннеля в Grafana или Alertmanager.
• На личном VPS SANSARA он ставится из бинарного файла или через Docker, без сложных зависимостей.
• Совместим с клиентами WireGuard на iPhone, Android, Windows и macOS — метрики собираются на стороне сервера.
• В кабинете SANSARA вы выбираете локацию из 9+ стран, получаете конфиг и импортируете его в клиент за пару кликов.

Что это и кому подходит

WireGuard exporter — это приложение, которое периодически опрашивает интерфейс WireGuard на сервере и формирует метрики для Prometheus. Типичные метрики:

• Количество подключённых клиентов (пиров).
• Переданный и полученный трафик по каждому клиенту.
• Время последнего успешного рукопожатия (handshake).
• Общее состояние интерфейса (включён/выключен).

Такие данные полезны, если вы используете личный VPS SANSARA как шлюз для удалённого доступа или маршрутизации трафика и хотите:

• Видеть, кто и когда подключался к вашему выделенному узлу.
• Строить графики трафика по клиентам в Grafana.
• Настроить алерты, если клиент долго не появляется в сети.
• Сравнивать нагрузку между разными локациями SANSARA (например, Европа и другие узлы).

WireGuard exporter не требует изменений в конфигурации самого WireGuard. Он работает поверх уже настроенного туннеля и просто читает системную информацию.

Как настроить по шагам (с личным VPS SANSARA)

Предполагается, что у вас уже есть личный VPS SANSARA с работающим WireGuard. Если нет — регистрируетесь, выбираете локацию, получаете конфигурацию из кабинета и импортируете её в клиент WireGuard на своём устройстве. Серверная часть уже готова.

Шаг 1. Подключитесь к серверу по SSH

Используйте данные из кабинета SANSARA для подключения к вашему выделенному узлу. Обычно это IP-адрес, порт и ключ для SSH-клиента.

Шаг 2. Скачайте wireguard-exporter

Найдите актуальную версию wireguard-exporter для вашей архитектуры (чаще всего x86_64 или arm64). Например, можно взять готовый бинарник с GitHub-релизов проекта.

Распакуйте архив и переместите бинарный файл в /usr/local/bin/:

`bash sudo mv wg-exporter /usr/local/bin/ sudo chmod +x /usr/local/bin/wg-exporter `

Альтернативно — используйте Docker-образ, если на сервере уже настроен Docker.

Шаг 3. Создайте systemd-сервис

Чтобы exporter запускался автоматически, создайте файл /etc/systemd/system/wg-exporter.service:

`ini [Unit] Description=WireGuard Exporter After=network.target

[Service] Type=simple User=root ExecStart=/usr/local/bin/wg-exporter Restart=always

[Install] WantedBy=multi-user.target `

Затем включите и запустите сервис:

`bash sudo systemctl daemon-reload sudo systemctl enable wg-exporter sudo systemctl start wg-exporter `

Шаг 4. Проверьте, что метрики доступны

По умолчанию wireguard-exporter слушает порт 9586. Проверьте ответ:

`bash curl http://localhost:9586/metrics `

В выводе должны быть строки вида wireguard_peer_received_bytes, wireguard_peer_transmitted_bytes и другие.

Шаг 5. Настройте Prometheus

В конфигурации Prometheus добавьте новый job для сбора метрик с wireguard-exporter:

`yaml scrape_configs:

• job_name: 'wireguard'

static_configs:

• targets: ['your-server-ip:9586']

`

Замените your-server-ip на IP-адрес вашего личного VPS SANSARA. После перезагрузки Prometheus начнёт собирать метрики WireGuard.

Шаг 6. Настройте Grafana (опционально)

Импортируйте готовый дашборд для WireGuard или создайте свой на основе метрик:

• График трафика по клиентам (wireguard_peer_received_bytes, wireguard_peer_transmitted_bytes).
• Число активных пиров.
• Время с последнего хендшейка.

Если вы используете Telegram-бота SANSARA для уведомлений, можно настроить Alertmanager на отправку сообщений в Telegram при пропадании клиента или аномальном трафике.

Устройства: iPhone, Android, Windows, macOS

WireGuard exporter работает на стороне сервера, поэтому не зависит от типа клиентского устройства. Вы можете подключаться к личному VPS SANSARA с:

• iPhone — официальное приложение WireGuard из App Store.
• Android — приложение WireGuard из Google Play.
• Windows — десктопный клиент WireGuard.
• macOS — клиент из Mac App Store или с сайта WireGuard.

Во всех случаях метрики на сервере будут отражать активность каждого клиента. Например, если вы подключены с iPhone и ноутбука на Windows, в Prometheus появятся два разных пира с соответствующими метками.

Импорт конфигурации из кабинета SANSARA одинаково прост на всех платформах: скачиваете файл или копируете QR-код, открываете клиент WireGuard и добавляете туннель. Никакой ручной настройки ключей или IP-адресов.

Частые ошибки и как их избежать

Ошибка 1. Exporter не видит интерфейс WireGuard

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

Решение:

• Убедитесь, что имя интерфейса WireGuard совпадает с тем, которое ожидает exporter (чаще всего wg0). При необходимости укажите его через флаг --interface или переменную окружения.
• Проверьте, что интерфейс WireGuard поднят: sudo wg show.

Ошибка 2. Метрики есть, но Prometheus не может до них добраться

Симптом: в логах Prometheus ошибки соединения.

Решение:

• Убедитесь, что firewall на сервере разрешает входящие подключения на порт 9586.
• Проверьте, что в конфиге Prometheus указан правильный IP-адрес и порт.
• Если Prometheus работает на другом сервере, убедитесь, что он может обращаться к вашему личному VPS SANSARA.

Ошибка 3. Клиенты подключаются, но метрики не обновляются

Симптом: трафик идёт, но wireguard_peer_received_bytes не растёт.

Решение:

• Проверьте, что exporter запущен от root или имеет права на чтение состояния WireGuard.
• Убедитесь, что интерфейс WireGuard действительно передаёт трафик: sudo wg show должен показывать актуальные значения transferred.

Ошибка 4. После перезагрузки сервера exporter не запускается

Симптом: сервис не стартует автоматически.

Решение:

• Проверьте, что сервис включён: sudo systemctl is-enabled wg-exporter.
• Убедитесь, что в unit-файле указаны корректные пути и зависимости (After=network.target).

FAQ

Итог

• Разверните wireguard-exporter на личном VPS SANSARA из бинарника или через Docker, чтобы собирать метрики по клиентам и трафику WireGuard.
• Настройте Prometheus на сбор метрик с порта 9586 и постройте дашборды в Grafana для наглядного мониторинга.
• Используйте конфигурацию из кабинета SANSARA для быстрого подключения клиентов на iPhone, Android, Windows и macOS без ручного редактирования ключей.
• Настройте алерты на пропажу клиентов или аномальный трафик, чтобы оперативно реагировать на проблемы с защищённым каналом.
• Регулярно обновляйте wireguard-exporter до актуальных версий, чтобы использовать новые метрики и исправления.