Сообщение `next/image Un-configured Host` обычно не означает, что домен недоступен. Его выдал сам Next.js, потому что абсолютный `src` не совпал с разрешённым шаблоном. Простое добавление hostname может не помочь: отличается протокол, поддомен, порт, путь или query string.
Не заменяйте проблему на `hostname: "**"`. Image Optimization API делает серверные запросы к разрешённым источникам, поэтому слишком широкий шаблон увеличивает поверхность злоупотребления. Сначала зафиксируйте один реальный URL и разрешите ровно его семейство.
URL разбирается на пять сравниваемых полей
| Часть URL | Фактическое значение | Частая ошибка |
|---|---|---|
| protocol | https | В конфиге указан http |
| hostname | img.cdn.example | Разрешён только cdn.example |
| port | пусто или 8443 | Нестандартный порт забыли |
| pathname | /catalog/42/a.webp | Шаблон заканчивается на /catalog/ |
| search | ?v=7 либо пусто | URL-конструктор запретил любой query |
Откройте Network и возьмите значение исходного `url` из запроса `/_next/image`. Не переписывайте его вручную: редирект CDN, подписанная строка и другой поддомен могут быть существенны. Затем проверьте прямой URL отдельным запросом и сравните статусы.
remotePatterns ограничивает хост и каталог
// next.config.js
module.exports = {
images: {
remotePatterns: [
{
protocol: 'https',
hostname: 'img.cdn.example',
port: '',
pathname: '/catalog/**',
search: '',
},
],
},
}Такой объект разрешает HTTPS без нестандартного порта, только заданный host и пути внутри `/catalog/`, без query string. `*` сопоставляет один сегмент, а `**` — несколько сегментов в допустимой позиции. Если версии действительно передаются в query, либо укажите точное значение search, либо осознанно опустите поле после оценки риска.
400 optimizer и 403 origin — разные поломки
| Ответ | Кто вероятнее ответил | Что открыть дальше |
|---|---|---|
| 400 + unconfigured host | Next.js optimizer | remotePatterns и полный src |
| 404 на /_next/image | Proxy/basePath | Маршрут до Next.js |
| 403 прямого URL | Внешнее хранилище | ACL, подпись, expiry |
| 200 не-image Content-Type | Origin/CDN error page | Headers и первые байты |
| 504/timeout | Optimizer или сеть до origin | Логи и latency upstream |
Проверяйте не только статус, но и `Content-Type`. CDN может вернуть HTML-страницу ошибки с кодом 200, которую декодер изображения отвергнет. При временных ссылках сохраните время сервера и срок действия подписи; расширять allowlist для исправления истёкшей подписи бессмысленно.
Закрытый источник требует другой доставки
Официальная документация предупреждает: стандартный optimizer не пересылает headers исходному `src`. Изображение, доступное только с пользовательской Cookie или Authorization, поэтому может работать в `<img>` у вошедшего пользователя и падать через `next/image`. Не встраивайте секрет в публичный URL.
- Для публичного каталога используйте отдельный read-only CDN origin.
- Для временного доступа выдавайте короткоживущий подписанный URL с подходящим кеш-контрактом.
- Для приватного прокси проверяйте авторизацию сервером и жёстко ограничивайте допустимый origin.
- Свойство unoptimized отключает встроенную оптимизацию; это осознанный компромисс, а не исправление ACL.
- Не разрешайте произвольный URL из пользовательского поля через wildcard.
Приёмочная матрица ловит соседние варианты
- Проверить изображение из разрешённого каталога без query string.
- Проверить допустимый URL с тем query, который реально используется.
- Убедиться, что другой host и соседний каталог отклоняются.
- Прогнать dev и production: конфигурация должна попасть в собранный artifact.
- Проверить narrow mobile layout, DPR и корректные width/height или fill-контейнер.
- Повторить после истечения подписанного URL и убедиться, что обновление ссылки контролируемое.
Готовый результат: разрешённый URL даёт 200 и image Content-Type через optimizer, запрещённые варианты остаются закрыты, а конфиг описывает ровно используемый origin. Для диагностики достаточно версии Next.js, фрагмента remotePatterns, полного обезличенного URL и двух ответов — optimizer и origin.