Документация
Ръководство за инсталация, конфигурация и поддръжка на Sofia.
Инсталация
Sofia се разпространява като един изпълним файл за Linux (amd64 и arm64). Изтеглете подходящата версия и я поставете в PATH:
curl -LO https://sofia.tetradexx.ru/dl/sofia-linux-amd64
install -m 0755 sofia-linux-amd64 /usr/local/bin/sofia
sofia version
Като systemd услуга
sofia service install
systemctl enable --now sofia
Конфигурация
Цялата конфигурация е във файл sofia.yaml. Пример:
interval: 30s
timeout: 10s
retries: 2
checks:
- name: уеб сайт
type: http
url: https://example.com
expect_status: 200
- name: база данни
type: tcp
address: db.internal:5432
alerts:
- type: telegram
token: "..."
chat_id: "..."
Видове проверки
| Тип | Описание | Основни полета |
|---|---|---|
http | HTTP/HTTPS заявка с очакван код | url, expect_status, method |
tcp | Проверка на отворен порт | address |
tls | Валидност и срок на сертификат | host, warn_days |
ping | ICMP наличност | host, count |
Известия
Поддържат се имейл (SMTP), Telegram и произволен webhook. Съобщенията се групират, за да не се получават повторни известия при един и същ инцидент. Канал се задава в секцията alerts.
REST API
Вграденият API връща текущото състояние на проверките:
| Път | Метод | Описание |
|---|---|---|
/api/v1/status | GET | Обобщено състояние на услугата |
/api/v1/checks | GET | Списък с проверки и резултати |
/api/v1/history | GET | История на наличността |
curl -s https://sofia.tetradexx.ru/api/v1/status
Поддръжка
- Дневниците се пишат в стандартния изход и се ротират от systemd.
- Базата с история се намира в
/var/lib/sofia/history.db. - За обновяване заменете изпълнимия файл и рестартирайте услугата.