INTEGRITY Документация

← Cloudflare Workers / workers / configuration / routing

workers.dev

Учётные записи Cloudflare Workers включают workers.dev поддомен, который можно настроить в Cloudflare dashboard. Ваш workers.dev поддомен позволяет быстро начать работу, разворачивая Workers без предварительного подключения собственного домена к Cloudflare.

Рекомендуется запускать продакшен-Workers на Маршрут Workers или пользовательский домен, а не на вашем workers.dev поддомен. Ваш workers.dev поддомен рассматривается как Бесплатный веб-сайт ↗ и предназначен для личных или любительских проектов, не критичных для бизнеса.

Настройте workers.dev

workers.dev поддомены имеют формат: <YOUR_ACCOUNT_SUBDOMAIN>.workers.dev. Чтобы изменить workers.dev поддомен:

  1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

    Перейдите в Workers & Pages ↗

  2. Выберите Изменение рядом с Ваш поддомен.

Всем Workers присваивается workers.dev маршрут при их создании или переименовании по синтаксису <YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev. name поле в конфигурации Worker используется как поддомен для развёрнутого Worker.

Управление доступом к workers.dev

Если этот параметр включен, ваш workers.dev URL доступен публично. Чтобы требовать от посетителей входа в систему перед доступом к workers.dev URL используйте Cloudflare Access.

Access может защитить продакшен-версию одного Worker workers.dev URL, preview URL или оба варианта. Вы также можете защитить все Workers или все превью Worker в аккаунте.

Чтобы использовать данные о вошедшем пользователе в своём Worker, используйте ctx.access. Также можно прочитать личность пользователя из проверенного JWT или /cdn-cgi/access/get-identity конечная точка.

Отключение workers.dev

Отключение workers.dev в панели управления

Чтобы отключить workers.dev маршрут для Worker:

  1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

    Перейдите в Workers & Pages ↗

  2. В Обзор, выберите ваш Worker.

  3. Перейдите в Настройки > Domains & Routes.

  4. На workers.dev нажмите «Disable».

  5. Подтвердите, что хотите отключить.

Отключение workers.dev в файле конфигурации Wrangler

Чтобы отключить workers.dev маршрут для Worker, добавьте следующее в конфигурационный файл Wrangler:

{
	"workers_dev": false
}
workers_dev = false

Когда вы повторно развернёте Worker с этим изменением, workers.dev маршрут будет отключен. По умолчанию preview-URL соответствуют вашему workers_dev настройка, если она не задана явно. Если вы явно включили Preview URLs, отключить их по отдельности.

Если вы не укажете workers_dev = false но добавьте routes компонент в ваш конфигурационный файл Wrangler, значение workers_dev будет определён как false при следующем развёртывании.

Ограничения

При развертывании Worker с workers.dev поддомен включён, имя вашего Worker должно соответствовать следующим требованиям:

Эти ограничения действуют потому, что имя Worker используется как DNS-метка в вашем workers.dev URL. Максимальная длина DNS-метки составляет 63 символа, она не может начинаться или заканчиваться дефисом.