DevOps / CI/CD

Next.js 16 Server Actions: междоменные запросы отклонены? Как проверить обратный прокси (2026)

Форма отправляется, но Server Action получает отказ после публикации через прокси.

Сначала сравните браузерный Origin, переданный прокси Host или X-Forwarded-Host и заголовки, которые фактически видит Next.js. Только если запрос легитимно приходит с другого источника и цепочка прокси проверена, добавляйте этот источник в serverActions.allowedOrigins; эта настройка не является универсальным переключателем CORS и не должна скрывать ошибку маршрутизации.

Материал предназначен для фронтенд-инженеров, сопровождающих приложения Next.js 16 за прокси, шлюзом или несколькими доменами.
Платформенные специалисты найдут порядок проверки заголовков и этапа, на котором теряется запрос.
Ответственные за безопасность смогут ограничить список разрешённых источников и проверить, что он не расширяет доверенную зону без необходимости.

Сначала определите, кто отклонил запрос

Сообщение о запрещённом источнике само по себе ещё не доказывает, что запрос остановил Next.js. Браузер мог не отправить запрос, шлюз — заблокировать или изменить его, а приложение — принять и отклонить уже внутри Action. Это разные неисправности, и устраняются они в разных местах.

Откройте вкладку Network в инструментах разработчика и найдите именно запрос вызова Server Action. Зафиксируйте адрес страницы, URL запроса, метод, статус ответа и заголовок Origin. Не сохраняйте в общедоступном отчёте cookie, токены авторизации, содержимое формы или значения заголовков, содержащие секреты. Для разбора достаточно обезличенного набора: домены можно заменить стабильными метками вроде app.example и proxy.example, сохранив различия между ними.

Параллельно сопоставьте браузерную запись с журналами шлюза и приложения. Важен не только текст ошибки, но и факт получения запроса конечным приложением. Руководство Next.js по вызову и обработке Server Actions описывает запрос как часть процесса изменения данных; поэтому проверяйте полный путь от отправки формы до серверной обработки, а не только состояние интерфейса.

Наблюдение Где вероятнее искать причину Что проверить дальше
Запрос отсутствует в Network Браузер, JavaScript или отправка формы Ошибки консоли, состояние формы, фактический адрес Action
Запрос есть в Network, но нет в журнале шлюза Клиентский маршрут, DNS, TLS или сетевой периметр URL, соединение и доступность входного адреса
Запрос виден в журнале шлюза, но отсутствует в журнале Next.js Шлюз или промежуточный прокси Правило блокировки, маршрут, upstream и передачу заголовков
Приложение зафиксировало запрос и отказ Проверка источника или логика Action Origin, Host, X-Forwarded-Host, затем код и авторизацию

Это помогает отличить отказ проверки источника от блокировки на периметре. Ошибка CORS в браузере тоже не равнозначна отказу Server Actions: CORS ограничивает доступ браузерного JavaScript к ответу, тогда как Next.js отдельно проверяет согласованность заголовков запроса. Смотрите, какой компонент сформировал ответ и дошёл ли запрос до сервера.

Проверьте страницу и запрос со стороны браузера

Заголовок Origin сообщает источник запроса: схема, хост и, если он задан, порт. Например, https://app.example и http://app.example — разные источники из-за схемы; адреса на разных поддоменах также не следует считать одним и тем же источником. Описание заголовка Origin в документации MDN полезно для интерпретации этой записи.

Почему Next.js 16 сообщает, что источник не разрешён?

Next.js использует проверку источника для защиты Server Actions: документация указывает, что Origin сравнивается с Host запроса или X-Forwarded-Host. Несовпадение может привести к отказу; само по себе оно не означает, что серверный кеш испорчен, интерфейс потерял клиентское состояние или запрос повторно записал данные. Сверьте фактические значения с описанием безопасности Server Actions и конфигурацией serverActions.

Проверьте следующие пункты:

  • [ ] Адрес открытой страницы и источник в Origin соответствуют ожидаемому публичному домену.
  • [ ] Схема страницы и запроса не различается неожиданно — например, из-за перехода между HTTP и HTTPS.
  • [ ] Форма или вызывающий код отправляет Action на ожидаемый адрес, а не на внутреннее имя сервиса.
  • [ ] В локальном, предварительном и производственном окружениях используются ожидаемые домены.
  • [ ] Время сбоя сопоставлено с журналами шлюза и приложения.

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

При разборе сохраните минимальное доказательство: время, путь запроса, статус, обезличенный Origin, видимый браузеру адрес и соответствующую запись журнала. Не экспортируйте HAR-файл без проверки: в нём могут оказаться cookies, токены и данные формы.

Восстановите путь заголовков через прокси

Host и Origin связаны с адресацией, но это не одно и то же. Origin отражает источник браузерного запроса; Host показывает хост запроса, полученный сервером. Заголовок X-Forwarded-Host может передаваться прокси, чтобы сообщить исходный хост, который видел клиент. Справка MDN по X-Forwarded-Host описывает его назначение; наличие такого заголовка в запросе само по себе не доказывает, что он сформирован доверенным узлом.

Что делать, если после прокси Origin и Host не совпадают?

Составьте таблицу фактического пути: что отправил браузер, что записал внешний шлюз, что получил следующий прокси и что увидело приложение. В цепочке из нескольких промежуточных узлов проверьте каждую границу отдельно: заголовок мог быть заменён, удалён, добавлен с другим значением или передан как список, который конкретная настройка приложения интерпретирует не так, как ожидалось.

Для каждого узла выясните:

  • Какой публичный адрес принимает соединение и какой адрес передаётся дальше.
  • Сохраняется ли исходный Host либо прокси заменяет его внутренним именем upstream.
  • Передаётся ли X-Forwarded-Host, кем он установлен и можно ли доверять этому узлу.
  • Не отличается ли результат при обращении напрямую к приложению от результата через публичный адрес.
  • Не меняют ли правила шлюза Origin, путь или схему маршрутизации.

В рекомендациях Next.js по самостоятельному размещению обратный прокси рассматривается как часть схемы развёртывания. Поэтому сопоставляйте его настройки с наблюдаемыми заголовками, а не исходите из предположения, что приложение автоматически восстановит первоначальный адрес за любой конфигурацией прокси. В более общей формулировке HTTP, шлюз может переводить запросы между различными соединениями и протоколами; это ещё одна причина проверять границы передачи, а не полагаться только на браузерную запись.

Выполните безопасное сравнение прямого и проксированного пути в контролируемой среде. Если прямой запрос проходит, а через шлюз — нет, это не является окончательным доказательством ошибки прокси, но указывает, где нужно искать различия. Сравните заголовки и журналы на обоих маршрутах. Не отключайте проверку источника в производстве ради эксперимента.

Важно: значение X-Forwarded-Host имеет смысл только в контексте доверенной цепочки. Если внешний клиент может подставить заголовок, а прокси просто передаёт его без очистки или замены, настройка приложения на безусловное доверие к такому значению не решает проблему безопасности.

Настройте разрешённые источники только после проверки топологии

Как выбрать значение serverActions.allowedOrigins?

Сначала определите, почему штатное сопоставление источника и хоста не отражает реальный, допустимый маршрут запроса. Затем установите конкретное имя публичного прокси или домена, который действительно должен инициировать Action. В документации Next.js allowedOrigins предназначен для дополнительных разрешённых источников; в примерах конфигурации используются имена хостов и шаблоны поддоменов, например my-proxy.com и *.my-proxy.com. Сверьте формат с актуальной документацией настройки Server Actions, прежде чем переносить пример в конфигурацию конкретного приложения.

Не добавляйте внутренний адрес контейнера только потому, что он отображается в логах: сначала выясните, не должен ли прокси передавать публичный хост. Не включайте широкий шаблон для доменной зоны, если приложению нужен один конкретный вход. Шаблон поддоменов допустим лишь тогда, когда все подходящие поддомены контролируются и должны иметь одинаковое доверие. Для тестового и производственного доменов оцените необходимость отдельных записей, вместо того чтобы расширять правило для всех окружений.

После изменения перезапустите или пересоберите приложение в соответствии с принятой процедурой публикации и проверьте именно ту конфигурацию, которая работает за публичным входом. Настройка allowedOrigins не выдаёт пользователю права на изменение данных: проверку подлинности и авторизации для каждого действия нужно выполнять отдельно. Это соответствует рекомендациям Next.js по аутентификации и защите данных.

Проведите проверку по ролям перед выпуском

Для инженера браузерной части

  • [ ] Воспроизведите отказ и сохраните URL страницы, URL Action, статус и обезличенный Origin.
  • [ ] Сравните локальную, предварительную и производственную точки входа; убедитесь, что тестируете один и тот же сценарий отправки.
  • [ ] Проверьте, не вызывает ли клиент код или форма другой адрес после смены домена.
  • [ ] Отдельно проверьте состояние интерфейса и ответ сервера: отображение ошибки формы не устанавливает, что запрос был отклонён браузером.

Для платформенной команды

  • [ ] Найдите запрос в журналах всех доступных промежуточных компонентов и приложения.
  • [ ] Запишите значения Host и X-Forwarded-Host на границах, которые можно наблюдать, не раскрывая секреты.
  • [ ] Сверьте правила передачи заголовков и маршрутизации с реальным публичным доменом.
  • [ ] Сопоставьте прямое обращение и обращение через прокси в тестовой среде; зафиксируйте, на каком участке меняется значение.

Для ответственного за безопасность

  • [ ] Обоснуйте каждый добавляемый источник конкретным публичным маршрутом и сценарием.
  • [ ] Уберите тестовые или временные имена, если после публикации они не нужны.
  • [ ] Проверьте границу доверия прокси и возможность подстановки X-Forwarded-Host.
  • [ ] Убедитесь, что логика Action проверяет права пользователя независимо от прохождения проверки источника.

Для тестирования выпуска

  • [ ] Проверьте успешную отправку с ожидаемого домена после изменения.
  • [ ] Проверьте, что запрос с неразрешённого источника по-прежнему отклоняется.
  • [ ] Повторите проверку при переключении между предварительным и производственным адресом.
  • [ ] Сохраните обезличенные заголовки до и после прокси, итоговый статус и соответствующую запись приложения.

Последний пункт принципиален: единственный успешный ответ подтверждает работоспособность проверенного маршрута, но не показывает, не стало ли приложение принимать запросы с лишних источников. Для выпуска нужны оба результата — разрешённый сценарий работает, а неожиданный источник не получил доступ.

Сравните варианты исправления перед публикацией

Вариант Когда выбирать Основной риск или ограничение
Исправить передачу Host или X-Forwarded-Host Публичный домен известен, но прокси теряет или заменяет ожидаемый хост Изменение прокси затрагивает и другие маршруты; нужна проверка всей цепочки
Добавить точный хост в serverActions.allowedOrigins Междоменный маршрут намеренный, цепочка прокси проверена, дополнительный источник необходим Ошибка в перечне или слишком широкий шаблон расширяет доверенную границу
Оставить конфигурацию без изменений и исправить адрес вызова Action отправляется на неверный хост либо окружение настроено с ошибкой Не устранит проблему, если промежуточный прокси всё равно переписывает заголовки
Проверка до публикации Приемлемый результат Что делать при несовпадении
Ожидаемый домен отправляет Action Запрос доходит до приложения и проходит предусмотренную проверку Вернуться к журналам и сопоставить заголовки на каждом участке
Неожиданный источник обращается к Action Запрос не получает разрешение на выполнение Пересмотреть список разрешений и границы доверия
Переход между предварительным и производственным адресом Для каждого входа используется намеренная схема доменов Исправить адреса окружения или обосновать точный дополнительный хост
Журналы позволяют проследить запрос Обезличенные записи связывают браузер, прокси и приложение Добавить безопасное логирование без записи секретов и содержимого формы

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

Если для эксперимента нужна отдельная Mac-среда, KuzCloud можно рассмотреть как вариант аренды для разработки и тестирования; описание доступных условий находится на странице KuzCloud, а организационные вопросы можно уточнить в справочном разделе. Такая аренда уместна, когда тестовую работу нужно отделить от основной машины и инфраструктуры команды, но решение о прокси и allowedOrigins всё равно следует принимать по заголовкам и журналам того приложения, которое предстоит выпускать.

Проверьте Next.js на выделенном облачном Mac

Разверните тестовую среду на физическом Mac mini M4 от KuzCloud и проверьте настройки обратного прокси и Server Actions.

Подключайтесь к удалённой машине напрямую по SSH или через VNC и изучайте поведение приложения в контролируемой среде.