Решение проблем
Сервис не готов
Проверьте docker compose logs --tail=100 zorka, чтение конфигурации и ключа пользователем 10001, состояние лицензии на admin listener и доступность необходимых источников/хранилищ. Исправьте причину перед переключением трафика.
В защищённой поставке истечение разрешения лицензии останавливает выдачу новых изображений до успешного продления. Обход через YAML не предусмотрен.
Локальное изображение не находится
Проверьте соответствие UPLOAD_DIR и /mnt/upload, имя профиля и путь относительно его root. Не используйте symlink. Например, /upload/products/a.jpg при стандартном alias читает products/a.jpg внутри source root.
HTTPS-источник отклонён
Убедитесь, что хост точно указан в allowed_hosts, сертификат действителен, а DNS и все перенаправления ведут на публичные адреса. Разрешение исходного хоста не разрешает автоматически другой хост из redirect.
Параметры URL возвращают ошибку
В file-маршруте поддержан только необязательный v. Удалите w, h, q и другие параметры, добавленные сторонним loader. Качество меняется в профиле, размеры сохраняются.
Вес не уменьшился
Проверьте фактический Content-Type и fallback на оригинал. Сравнивайте одинаковые изображения при одинаковых параметрах; уже хорошо сжатый оригинал может не дать ожидаемого выигрыша. Настройте качество на репрезентативной выборке.
Нет ожидаемого cache hit
Проверьте X-Image-Cache, сроки хранения, лимиты размера записи и доступность backend. Большое изображение может не помещаться в быстрый кэш. Повторная обработка после истечения срока или изменения источника ожидаема.
Что приложить к обращению
- Версию или digest образа и выбранный профиль.
X-Request-ID, статус и безопасные заголовки ответа.- Минимальный пример источника без приватных данных.
- Фрагмент конфигурации без credentials и ключей.
Не публикуйте ключ активации, пароли registry, токены или исходники с персональными данными.