← Images / images / reference

Troubleshooting

Содержит ли ответ Cf-Resized заголовок? Если нет, изменение размера не выполнялось. Возможные причины:

• Эта функция не включена в Cloudflare Dashboard.
• На тот же запрос приходится еще один Worker. Как только один Worker вызывает другой, изменение размера «забывается». Не используйте Workers с областью действия на весь домен /*.
• Предпросмотр в разделе Editor в Cloudflare Dashboard не эмулирует изменение размера изображения. Разверните Worker и протестируйте его в другой вкладке браузера.

Если изменение размера завершается ошибкой, тело ответа содержит сообщение с описанием причины, а также Cf-Resized заголовок, содержащий err=code:

• 9401: обязательные аргументы в {cf:image{…}} параметры отсутствуют или недействительны. Повторите попытку. Подробнее см. Параметры получения для списка поддерживаемых аргументов.
• 9402: Изображение оказалось слишком большим, либо соединение было прервано. См. Поддерживаемые форматы и ограничения, где это описано подробнее.
• 9403: цикл запросов произошла из-за того, что изображение уже было изменено в размере, либо Worker обратился к собственному URL. Убедитесь, что путь Worker и путь к изображению на сервере не пересекаются.
• 9406 и 9419: URL изображения не использует HTTPS, либо содержит пробелы или неэкранированные символы Unicode. Проверьте URL и повторите попытку.
• 9407: Произошла ошибка при определении домена исходного сервера. Проверьте настройки DNS и повторите попытку.
• 9404: Изображение отсутствует на исходном сервере, либо URL, использованный для изменения размера изображения, указан неверно. Проверьте, что изображение существует, и проверьте URL.
• 9408: Исходный сервер вернул код состояния HTTP 4xx и, возможно, отказывает в доступе к изображению. Проверьте настройки изображения и повторите попытку.
• 9509: Исходный сервер вернул код состояния HTTP 5xx. Скорее всего, проблема связана с программным обеспечением исходного сервера, а не с изменением размера.
• 9412: Исходный сервер вернул не изображение, а, например, страницу HTML. Обычно это происходит при указании неверного URL либо когда серверное программное обеспечение вывело ошибку или показало страницу входа.
• 9413: Изображение превышает максимально допустимую площадь в 100 мегапикселей. Используйте изображение меньшего размера и повторите попытку.
• 9420: Исходный сервер выполнил перенаправление на недействительный URL. Проверьте настройки источника и повторите попытку.
• 9421: Исходный сервер выполнил слишком много перенаправлений. Проверьте настройки источника и повторите попытку.
• 9422: Запрос на преобразование отклонён, поскольку был достигнут лимит использования. Если вам требуется запрашивать более 5,000 уникальных преобразований, перейдите на тариф Images Paid.
• 9432: Привязка Images недоступна при устаревшей системе оплаты. Ваш аккаунт использует устаревшую подписку Image Resizing. Чтобы привязать Images к Worker, вам потребуется перейти на подписку Images в панели управления.
• 9504, 9505 и 9510: Не удалось связаться с исходным сервером, поскольку он может быть недоступен или перегружен. Повторите попытку позже.
• 9523: /cdn-cgi/image/ служба изменения размера не смогла изменить размер изображения. Это может произойти, если формат изображения некорректен. Используйте изображение в правильном формате и повторите попытку.
• 9524: /cdn-cgi/image/ служба изменения размера не смогла изменить размер изображения. Это может произойти, если URL изображения перехвачен Worker. В качестве альтернативы можно изменение размера внутри Worker. Это также может произойти при использовании pages.dev URL-адрес Cloudflare Pages проекте. В этом случае можно использовать Custom Domain взамен.
• 9520: Формат изображения не поддерживается. См. Поддерживаемые форматы и ограничения чтобы узнать о поддерживаемых форматах ввода и вывода.
• 9522: Изображение превысило лимит обработки. Это может ненадолго происходить после полной очистки кеша зоны или при запросе файлов с очень большими размерами. Если проблема не исчезает, обратитесь в службу поддержки.
• 9529: Превышено время ожидания при обработке изображения. Это может происходить при запросе файлов с очень большими размерами или при перегрузке сервера.
• 9424, 9516, 9517, 9518: Внутренние ошибки. Если вы столкнулись с этими ошибками, обратитесь в службу поддержки.

Ниже приведены ограничения для изображений, хранящихся вне Images:

• Максимальный размер изображения составляет 100 мегапикселей (например, 10,000×10,000 пикселей). Максимальный размер файла составляет 100 мегабайт (МБ). Анимации GIF/WebP ограничены суммарно 50 мегапикселями (сумма размеров всех кадров).
• Использование собственного IP (BYOIP) несовместим с Images при оптимизации удалённых изображений (преобразованиях).
• Когда Polish не может оптимизировать изображение, заголовок ответа Warning: cf-images 299 "original is smaller" возвращается.

Запросы изображений к источнику анонимизируются (без cookies, без auth и без пользовательских заголовков). Это связано с тем, что для изображений с изменённым размером используется единый публичный кэш, и было бы небезопасно предоставлять доступ к изображениям, персонализированным для отдельных посетителей.

Однако если клиенты соглашаются хранить такие изображения в публичном кэше, Cloudflare поддерживает изменение размера изображений через Workers на аутентифицированных источниках.

Изменения размеров изображения и других параметров изменения размера вступают в силу немедленно: очистка кеша не требуется.

Запрос изображения состоит из двух частей: выполнения кода Worker и обработки изображения. Код Worker выполняется всегда и не кэшируется. Результаты обработки изображения кэшируются в течение часа или дольше, если у исходного сервера Cache-Control заголовок допускает. Исходное изображение кешируется по обычным правилам кеширования. Изменение размера внутренне следует перенаправлениям, поэтому перенаправления также кешируются.

Поскольку ответы от самих Workers не кешируются на периферийной сети, очистка URL адреса Worker ничего не делает. Варианты изображений с изменённым размером кешируются вместе под URL исходного изображения. При очистке кеша используйте URL исходного изображения (полного размера), а не URL Worker, который запросил изменение размера.

Если исходный сервер отправляет Etag HTTP заголовок, изменённые изображения будут иметь Etag HTTP заголовок в формате cf-<gibberish>:<etag of the original image>. Вы можете сравнить вторую часть с Etag заголовок URL исходного изображения, чтобы проверить, актуально ли изображение с изменённым размером.