Безопасность

Что проверить перед развертыванием Next.js Server Actions в Cloudflare Workers? 2026

В документации Next.js для Server Actions указан стандартный предел тела запроса в 1 МБ; его можно настроить через serverActions.bodySizeLimit (описание параметра). Этот предел не подтверждает ни совместимость загрузки с выбранным адаптером, ни безопасность развёртывания в Cloudflare Workers. Поэтому решение практично такое: не разрешайте выпуск только на основании слов «Server Actions поддерживаются». Сначала подтвердите текущий путь адаптации, затем проверьте доверие к заголовкам, права каждого действия, возможности среды выполнения и восстановление предыдущей версии; если любой обязательный контроль нельзя проверить в целевой цепочке, выпуск следует отложить.

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

Сначала зафиксируйте путь адаптации и границы поддержки

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

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

Для миграции составьте список функций, которые реально вызываются в production: Server Actions, загрузки, обработка форм, работа с файлами, обращение к Node.js API, фоновые задачи и зависимости от поведения сервера. Не отмечайте функцию как совместимую только потому, что компиляция завершилась без ошибки. Она должна пройти проверку на целевом runtime с тем адаптером, который будет применён при публикации.

В React документация описывает Server Functions как функции, вызываемые через сетевой запрос, а не как обычные локальные вызовы компонентов (модель Server Functions в React). Это важная граница для проектирования тестов: действие нужно считать доступной серверной точкой входа. Клиентский интерфейс может скрывать кнопку, но это само по себе не мешает сформировать запрос к серверному действию.

Путь принятия решения различается в зависимости от исходной ситуации:

  • Новый проект: выберите документированный Cloudflare путь до разработки, соберите минимальный вертикальный сценарий с формой и Server Action, а затем проверьте его на целевом runtime.
  • Миграция: инвентаризируйте использованные API и действия, выделите функции, зависящие от Node.js, и испытайте их по одной после сборки адаптером.
  • Неясная поддержка функции: не заменяйте пробел в документации предположением. Создайте воспроизводимый тестовый пример, зафиксируйте результат и запросите подтверждение совместимости до выпуска.

Условия о совместимости Node.js API проверяйте отдельно: Cloudflare публикует описание доступных API и их ограничений для Workers в документации Node.js compatibility. Сам факт наличия слоя совместимости не означает, что любая библиотека, рассчитанная на обычный Node.js-сервер, будет работать без изменений.

Проверьте доверие к Origin и Host через всю цепочку

Для Next.js Server Actions проверка источника запроса связана со сравнением Origin и Host либо X-Forwarded-Host; необходимые дополнительные источники настраиваются через allowedOrigins. Это поведение и параметры нужно сверять с официальной документацией по конфигурации Server Actions, а не воспроизводить по случайному примеру конфигурации из другого проекта.

За прокси или пользовательским доменом проверка в конфигурации ещё не доказывает, что заголовки надёжны. Команда должна установить, кто и на каком участке задаёт Host и X-Forwarded-Host, заменяет ли прокси переданные клиентом значения и какие значения в итоге получает приложение. Если приложение доверяет заголовку, который клиент может прислать или подменить, проверка может опираться на ложный источник.

Проведите проверку на staging, повторяя запрос через тот же маршрут, который планируется для production:

  • зафиксируйте ожидаемые Origin, Host и X-Forwarded-Host на входе и на стороне приложения;
  • проверьте запрос с разрешённого источника и сравните его с запросом с постороннего источника;
  • отдельно проверьте запросы без Origin, с некорректным значением и с неожиданным соотношением заголовков;
  • убедитесь, что приложение не принимает клиентский X-Forwarded-Host как доверенный только из-за его названия;
  • ограничьте allowedOrigins источниками, которые действительно нужны этому приложению, не превращая настройку в широкий список доменов «на всякий случай».

Не делайте вывод, что Workers обязательно удаляет или изменяет эти заголовки. В сообществах могут обсуждаться отдельные случаи обработки заголовков на периферии, но обсуждение само по себе не подтверждает дефект конкретной конфигурации. Важны наблюдения на выбранном адаптере, прокси и домене. У Next.js есть опубликованное уведомление о проблеме CSRF, связанной с Origin: null; оно подтверждает существование конкретного класса риска, но не доказывает, что все приложения на Workers уязвимы (официальное уведомление безопасности Next.js).

Проверьте полномочия внутри каждого чувствительного действия

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

Для каждого Server Action с изменением состояния составьте карточку: какие данные меняются, кто может вызвать операцию, какая роль необходима, как определяется владелец ресурса и где сервер повторно проверяет эти условия. Руководство Next.js отдельно рассматривает аутентификацию и авторизацию и рекомендует проверять права на серверной стороне (руководство Next.js по аутентификации). Проверка только в компоненте, скрытие кнопки или наличие middleware не заменяют проверки непосредственно в действии.

Минимальный набор безопасных отказных тестов должен включать следующие сценарии:

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

Результат теста — не только код ответа. Зафиксируйте, что сервер отклонил действие и в хранилище не возникло изменений. Для платежей, учётных записей и управления доступом используйте изолированные тестовые данные; не проверяйте отказные сценарии операциями над реальными пользовательскими данными. OWASP рекомендует применять защиту от CSRF с учётом архитектуры приложения и не считать один механизм универсальным решением (руководство OWASP по предотвращению CSRF).

React 19.2 и конкретная версия Next.js должны быть частью записи о тестовом окружении, но номер версии сам по себе не является свидетельством безопасности. Важнее, чтобы проверки выполнялись на той версии и той сборке, которые действительно планируется развернуть, а каждое действие проверяло идентичность пользователя, роль и принадлежность ресурса в момент вызова.

Разберите вопросы, которые чаще всего блокируют выпуск

Что проверить перед развертыванием Next.js в Cloudflare Workers?

Сначала сверьте адаптер и его поддерживаемые функции с текущей документацией Cloudflare, а затем соберите приложение так же, как для целевого окружения. Проверьте запросы к Server Actions через реальный домен и прокси, авторизацию каждого чувствительного действия, работу используемых API и сценарии загрузки. Успешный локальный запуск не подтверждает прохождение этих проверок в периферийном runtime.

Поддержка Server Actions платформой означает готовность к production?

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

Как установить, что прокси не ослабил проверку Origin и Host?

Сравните заголовки до и после прокси в контролируемой тестовой среде и выясните, какие компоненты могут задавать или перезаписывать каждое значение. Выполните запросы с ожидаемым источником, посторонним источником, отсутствующим Origin и противоречивыми Host-заголовками. Приложение должно доверять только тем значениям, которые устанавливает доверенная инфраструктура; включение дополнительного домена в allowedOrigins не должно маскировать проблему доверия к заголовкам.

Как доказать, что пользователь не может вызвать чужое действие?

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

Проверьте формы, загрузки и ограничения runtime на выбранном пути

Формы и файлы требуют отдельной проверки, потому что успешная обработка небольших текстовых данных не подтверждает работу крупного тела запроса, потоковой обработки или конкретной библиотеки. У Next.js параметр serverActions.bodySizeLimit описывает предел тела запроса для Server Actions; указанный стандартный предел в 1 МБ относится к настройке Next.js и не должен выдаваться за универсальный лимит Cloudflare Workers. Лимиты платформы опубликованы отдельно в документации ограничений Workers. Сопоставляйте обе стороны, учитывая выбранный план и путь адаптации, а не перенося значение одной настройки на все варианты развёртывания.

Для фактических сценариев приложения проверьте:

  • передаёт ли форма ожидаемые поля и корректно ли действие обрабатывает повторную отправку;
  • соответствует ли максимальный размер файла настройкам Next.js и ограничениям конкретного runtime;
  • не буферизует ли действие всё содержимое там, где приложение рассчитывает на потоковую обработку;
  • не использует ли библиотека API, отсутствующий или ограниченный в Workers;
  • сохраняются ли корректные отказы при слишком большом или некорректном запросе;
  • остаются ли журналы безопасными: без токенов, секретов и содержимого, которое не требуется для диагностики.

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

Сохраните доказательства и отрепетируйте возврат версии

После обновления Next.js, адаптера, конфигурации домена или прокси повторите не только сборку, но и проверки безопасности. Даже если изменения выглядят несвязанными с Server Actions, они могут повлиять на маршрут запроса и значения заголовков. Перед публикацией сопоставьте результаты с тем же commit или идентификатором сборки, который будет развёрнут.

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

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

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

Используйте матрицы приёмки, а не общее обещание поддержки

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

Ситуация Что установить до проверки Свидетельство для приёмки Причина остановить выпуск
Новый проект Документированный путь Cloudflare, версии Next.js и адаптера, необходимые функции Сборка и сценарии Server Actions на целевом runtime Используемая функция не подтверждена или не воспроизводится
Миграция Список API, библиотек и действий существующего приложения Проверка каждой зависимой от runtime функции после сборки Критичный сценарий работает только в локальной среде
Пользовательский домен или прокси Кто устанавливает Host и X-Forwarded-Host, какие Origin разрешены Наблюдение заголовков и результаты тестов с ожидаемым и посторонним источником Клиент может влиять на доверенное приложением значение
Формы и загрузки Ограничения Next.js и Workers для конкретной конфигурации Успешные и отказные тесты на целевом runtime Невозможно доказать безопасное поведение при превышении ограничений
Изменение адаптера или версии Новый идентификатор сборки и затронутые функции Повторная проверка безопасности и успешная репетиция отката Нет подтверждённого возврата к ранее принятой версии

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

Проверяемый случай Ожидаемое решение сервера Что сохранить
Нет действующей сессии Отказ до изменения данных Результат запроса и подтверждение неизменности тестовых данных
Роль не разрешает операцию Отказ независимо от состояния интерфейса Идентификатор тестового сценария и журнал авторизации
Ресурс принадлежит другому пользователю Отказ без раскрытия закрытых данных Подтверждение границы владельца и отсутствия записи
Запрос пришёл с постороннего источника Отказ согласно принятой политике источников Фактические Origin, Host и значения после прокси
Заголовок отсутствует или некорректен Предсказуемый отказ либо поведение, явно предусмотренное политикой Ответ приложения и сведения о том, как заголовки обработаны

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

  • [ ] Путь адаптации и поддерживаемые функции сверены с актуальной документацией Cloudflare.
  • [ ] Сборка соответствует целевой версии Next.js, адаптера и фактической конфигурации.
  • [ ] Заголовки Origin, Host и X-Forwarded-Host проверены по всей доверенной цепочке.
  • [ ] allowedOrigins содержит только необходимые источники; доверие к прокси подтверждено отдельно.
  • [ ] Каждое чувствительное действие проверяет пользователя, роль и принадлежность ресурса на сервере.
  • [ ] Отказные тесты не приводят к изменению данных и не раскрывают лишние сведения.
  • [ ] Формы, файлы и Node.js-зависимости проверены в целевом runtime.
  • [ ] Сохранены результаты наблюдения приложения и периферийного окружения без секретов.
  • [ ] Восстановление ранее принятой сборки отрепетировано и его результат зафиксирован.

Итоговое решение удобно свести к следующей таблице: она отделяет подтверждённые условия выпуска от ситуаций, в которых нужны владелец проверки и повторное испытание.

Статус Условия Решение
Можно выпускать Адаптер и используемые функции проверены; запросы и права испытаны; ограничения runtime известны; откат подтверждён Разрешить выпуск по утверждённой процедуре
Выпуск заблокирован Не проверен доверенный маршрут заголовков или нет доказательства авторизации хотя бы одного чувствительного действия Назначить ответственного, получить свидетельство и повторить приёмку
Выпуск заблокирован Критичная функция работает только вне целевого runtime либо ограничение платформы не учтено Изменить реализацию или путь адаптации, затем повторить функциональные и безопасностные проверки
Требуется повторная приёмка Изменены версия, адаптер, домен, прокси или правила маршрутизации Повторить затронутые проверки на новой сборке до публикации

Если цепочка Edge не даёт наблюдать значения заголовков, воспроизвести отказ авторизации или подтвердить безопасный откат, не следует компенсировать это самодельным middleware без отдельной модели угроз и тестов. Надёжнее остановить выпуск, зафиксировать неопределённость и назначить повторную проверку, чем считать неподтверждённую защиту работающей.

У Cloudflare-пути есть реальные эксплуатационные издержки: поведение зависит от адаптера и прокси, совместимость некоторых зависимостей нужно подтверждать на целевом runtime, а диагностика распределена между журналами приложения и периферийной платформы. Для Next.js Server Actions это означает дополнительную дисциплину выпуска, но не является доказательством общего дефекта Workers. Если команде нужно испытывать именно производственную цепочку, тестируйте её в контролируемом окружении; для браузерных проверок на Apple-платформах отдельно оцените, подходит ли удалённая среда KuzCloud. Такая среда может помочь с задачами, требующими Apple-платформы, но не заменяет приёмку Next.js на Cloudflare Workers и не нужна командам, которым достаточно локального окружения или обычного тестового сервера.

Проверьте проект на удалённом Mac до выпуска

Арендуйте выделенный Mac mini M4 в KuzCloud для проверки сборки и вспомогательных инструментов на реальном устройстве.

Подключайтесь по SSH или VNC и получайте полный root-доступ для настройки тестовой среды.