Как запустить свой сканер

Сканер Cheburcheck выполняет динамические проверки из вашей сети и передаёт результаты на сайт. Так можно добавить наблюдения из своего региона и от своего провайдера. Подробнее о проверках — в статье о динамическом сканировании.

Получите доступ

Для запуска нужны ID сканера (PROBE_ID) и токен (PROBE_TOKEN). Чтобы получить их, заполните форму. Не публикуйте токен и не добавляйте его в репозиторий.

Установите сканер

На Debian, Ubuntu и OpenWrt можно воспользоваться интерактивным мастером. Он предложит установить подходящий пакет и ввести полученные ID и токен. На Debian или Ubuntu выполните:

curl -fsSL https://cheburcheck.ru/install-probe.sh | sudo sh

На OpenWrt выполните от имени root:

wget -qO- https://cheburcheck.ru/install-probe.sh | sh

На OpenWrt мастер также установит интерфейс LuCI. После установки сканер можно настроить в разделе Службы → Cheburprobe. Готовые пакеты для ручной установки доступны на странице релизов.

Запуск в Docker

Для Linux на amd64 или arm64 доступен образ ghcr.io/lowderplay/cheburcheck-probe:latest. Создайте файл cheburprobe.env с выданными значениями и ограничьте доступ к нему:

PROBE_ID=ваш-id
PROBE_TOKEN=ваш-токен
chmod 600 cheburprobe.env

Запустите контейнер:

docker run -d \
  --name cheburprobe \
  --restart unless-stopped \
  --cap-add NET_RAW \
  --env-file cheburprobe.env \
  ghcr.io/lowderplay/cheburcheck-probe:latest

Проверьте работу

После запуска посмотрите состояние сервиса и его журнал:

  • Debian/Ubuntu: systemctl status cheburprobe.service и journalctl -u cheburprobe.service -f.
  • OpenWrt: /etc/init.d/cheburprobe status и logread -e cheburprobe.
  • Docker: docker logs -f cheburprobe.

Если сканер не подключается, проверьте ID и токен, а также доступность wss://cheburcheck.ru/mqtt из сети сканера. Дополнительные параметры и способы ручной установки описаны в документации сканера.