Типовые проблемы

Диагностика по схеме «симптом → вероятная причина → где смотреть в коде».

Симптом	Вероятная причина	Где смотреть
`Contour Node не настроен для данной компании`	у компании нет узла / неверный `companyId`	`ContourService`
`check-node` → `offline`	узел недоступен по Tailscale, неверный `networkIp`/`apiPort`, узел не запущен	`getHealth`, `HttpContourApiRepository`
`minio: bucket_missing`	бакет `nodeMinioBucket` не создан на узле	Развёртывание → health-check
Webhook → `403 unregistered Contour Node`	IP отправителя ≠ `networkIp` (или потерян `x-forwarded-for` за прокси)	`ContourWebhookController`
Запросы к узлу уходят в корпоративный прокси и не доходят	Tailscale-диапазон не в `NO_PROXY`	`.env.example`
Браузер не качает медиа по публичному URL	не настроен `MINIO_PROXY_BASE_URL` / nginx-блок	MinIO reverse-proxy
`Contour не вернул идентификатор задачи сжатия`	узел не отдал `task_id`/`compression_task_id` при `compress=true`	`HttpContourApiRepository`
`400` на webhook	`task_type` в теле не совпадает с эндпоинтом	`ContourWebhookController`
Ошибка подписи при скачивании через прокси	`proxy_set_header Host` не сохраняет `IP:port`	MinIO reverse-proxy

Типовые проблемы ​