Разберите входной адрес через URL и меняйте только нужную часть. До deploy задайте таблицу «вход — ожидаемый выход»: обычный путь, query, уже переписанный адрес и похожий префикс. Так видно, где ошибка маршрута, а где запрос доходит правильно и ломается уже в приложении.
Одна строковая замена затрагивает лишнее
| Условный вход | Ожидаемый путь после правила |
|---|---|
| /public/item?q=1 | /internal/item?q=1 |
| /public | /internal |
| /publicity/item | Без изменения |
| /internal/item | Без повторного префикса |
| /public/a%2Fb | Без самовольного декодирования сегмента |
В примере правило меняет только начальный сегмент public на internal. Это условный контракт приложения, а не стандарт Cloudflare. Замена слова public во всей строке способна затронуть значение query или похожую часть имени. Отдельно решите, что делать с корнем, завершающим слешем и уже преобразованным путём.
// Только функция преобразования URL, без сетевого вызова
function rewrite(input) {
const url = new URL(input);
if (url.pathname === '/public') {
url.pathname = '/internal';
} else if (url.pathname.startsWith('/public/')) {
url.pathname = '/internal/' + url.pathname.slice(8);
}
return url;
}Функция сохраняет остальные компоненты URL, поскольку присваивает только pathname. Прогоните таблицу в окружении проекта и сравните сериализованный результат. Не применяйте decodeURIComponent ко всему пути ради удобства: закодированный разделитель может стать настоящим слешем и изменить то, какую сущность выбирает backend.
Новый URL требует нового Request
Официальный пример Cloudflare modify request property использует конструктор Request для нового URL и рекомендует брать исходный request, чтобы сохранить его атрибуты. После создания URL запроса неизменяем. Документация проверена 25 октября 2026 года. Одного изменения локального объекта URL недостаточно, если затем fetch получает прежний request.
При встраивании функции определите разрешённый upstream заранее. Не позволяйте входному query выбирать произвольный hostname, на который уйдут cookie или Authorization. Проверка пути и выбор доверенного назначения — разные части маршрутизатора; тестировать нужно обе.
Различайте внутренний fetch и ответ redirect браузеру. В первом случае Worker сам обращается к назначению, во втором клиент получает новый переход. Поэтому строка адреса в браузере не всегда показывает внутренний путь. Для диагностики сопоставьте обезличенные входной маршрут и маршрут origin по одному тестовому запросу.
POST проверяется отдельно от GET
- Прогнать функцию на всех строках таблицы без сети.
- Проверить GET с query на тестовом origin.
- Отправить искусственный POST и сравнить метод, тело и нужные заголовки.
- Повторить запрос с уже преобразованным путём.
- Вернуть предыдущую версию при расхождении маршрутов.
Не считывайте body для лога и затем бездумно передавайте уже использованный поток дальше. Выберите корректный для проекта способ диагностики запроса и не пишите секретные поля в журнал. Успешный GET не подтверждает, что загрузка файла или JSON POST сохранили содержимое.
Повторное применение самого правила желательно сделать предсказуемым: в приведённой схеме internal больше не подходит под public. Это помогает диагностике, но не гарантирует отсутствие сетевой петли. Проверьте всю цепочку Worker, правил маршрутизации и редиректов origin; они могут возвращать запрос на исходный публичный адрес.
Оставьте рядом с кодом таблицу маршрутов, версию Worker и тестовый ответ origin. Для приёмки достаточно доказать точное совпадение ожидаемого пути, query, метода и тела на нужных сценариях. Переход на главную страницу со статусом 200 не считается исправлением адреса конкретного ресурса.