From 0eb00d1ccdc96b086b2c93cc52018617eb575dc3 Mon Sep 17 00:00:00 2001 From: Gitea Actions Date: Wed, 19 Aug 2026 09:27:53 +0000 Subject: [PATCH] docs: Update Wiki from main repository --- Home.md | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/Home.md b/Home.md index f8d355b..8fd3dcd 100644 --- a/Home.md +++ b/Home.md @@ -25,6 +25,8 @@ Manage Cloudflare zones, DNS records, domain groups, and TLS certificate expiry | `HEALTH_DOWN_FAILURES` | Ошибок подряд до `down` (default `2`). То же в UI. | | `HEALTH_SUCCESS_RECOVERIES` | Успехов подряд для recovery `CHECKING → HEALTHY` (default `2`). То же в UI. | | `HEALTH_LATENCY_WARN_MS` | Латентность-порог для `degraded` (default `1000`). То же в UI. | +| `HEALTH_WORKER_URL` | URL Worker health-probe (fallback). Переопределяется в **Настройки → Health-check**. | +| `HEALTH_WORKER_TOKEN` | Bearer-токен Worker (fallback). В GET `/settings` не отдаётся целиком. | ## Load balancing & health checks @@ -48,8 +50,30 @@ health-check работают на двух уровнях: не попадает в пул, пока нет успешных проб; восстановление — `UNHEALTHY → CHECKING → HEALTHY` после `HEALTH_SUCCESS_RECOVERIES` (default 2). Пороги и cron движка задаются в **Настройки → Health-check** (env — fallback, пока значения не сохранены в UI). -Reconcile DNS запускается cron-задачей -`health-check`. Cloudflare Health Checks — официальный API зоны, Workers не используются. + +### Local XOR Cloudflare Worker + +Провайдер задаётся на привязке (`service_bindings.health_check_provider`): **local** +или **cloudflare**. Одновременно оба не работают. + +| | Local | Cloudflare Worker | +|---|---|---| +| Кто пробирует | процесс API CFDM | Worker на edge Cloudflare | +| Планировщик | глобальный cron CFDM | тот же cron вызывает Worker | +| Пороги Slow/Down | Настройки → Health-check | те же | +| Результат | SQLite `ip_health_status` | та же SQLite + `colo` | +| Регионы Health Checks | нет | нет (на Free продукта нет) | + +**Cloudflare в CFDM — это Worker**, не [Health Checks API](https://developers.cloudflare.com/api/resources/healthchecks). +Продукт Health Checks на Free-плане недоступен и **не используется**. Worker +stateless: конфиг и журнал (`health_probe_log`) живут в SQLite CFDM. + +Деплой Worker: [`workers/health-probe/README.md`](../workers/health-probe/README.md) +(`wrangler deploy`). URL и токен — **Настройки → Health-check**. Если Worker не +задан, cloudflare-цели **не** пробируются как Local. + +Reconcile DNS запускается cron-задачей `health-check`. Free Workers ≈ 100k +запросов/сутки; cron раз в 2 мин × число IP должен влезать. ## Docker