Подтверждение хостнейма

Докажите контроль над доменом с помощью DNS TXT-записи или HTTPS-файла, чтобы получить возможность его прогревать.

9 мин чтения

Прежде чем Cache Rocket отправит одиночный запрос в домен, вы должны доказать, что контролируете его. На этой странице описаны оба метода проверки и то, что делать в случае сбоя.

Hostnames живут под Аккаунт → Hostnames.

Почему это необходимо

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

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

Note

Это также защищает вас. Никто другой не сможет создать ссылку warmer, указывающую на ваш домен, поскольку он не сможет пройти проверку.

Выбор метода

	DNS-запись TXT	HTTPS-файл или метатег
Вам нужен доступ	Ваш DNS-провайдер	Файлы или шаблоны вашего сайта
Типичное ожидание	От минут до часа для распространения	Как можно быстрее развернуть
Лучше всего	Вы управляете DNS и хотите, чтобы изменения выдерживали повторные развертывания.	Вы развертываете приложение, но не контролируете DNS
Подходит для	Традиционный хостинг, cPanel, самоуправляемые серверы	Next.js, Vercel, Netlify, статические хосты

Любой метод приводит к одному и тому же подтвержденному статусу. Выбирайте то, что вы можете сделать быстрее.

Как правильно поставить hostname

Это наиболее распространенный источник путаницы, поэтому стоит быть точным. hostname — это точная доменная часть ваших URL-адресов. Все они *разные* hostnames с точки зрения проверки:

text

example.com
www.example.com
shop.example.com
blog.example.com

Проверьте тот, который указан в URL-адресах записей, которые вы собираетесь использовать. Если ваш сайт перенаправляет example.com на www.example.com, ваш URL-адрес входа должен быть версии www, то есть это hostname для проверки.

У вас несколько поддоменов? Проверяйте каждый отдельно. Подстановочная проверка отсутствует.

Tip

Не знаете, какую форму использует ваш сайт? Откройте его в браузере и посмотрите на адресную строку после завершения загрузки. Что бы там ни было показано после любых перенаправлений, это hostname, требующий проверки.

Метод A — запись DNS TXT

1
Добавьте hostname
В разделе Учетная запись → Hostnames введите домен и выберите Запись DNS TXT в качестве метода проверки.
2
Начать проверку
Нажмите Начать проверку. Cache Rocket генерирует уникальный токен и показывает имя записи и точное значение для публикации.
3
Создайте запись у своего DNS-провайдера.
Войдите в систему, где бы вы ни управляли своим DNS — Cloudflare, у вашего регистратора, в панели управления вашего хоста — и добавьте новую запись TXT, используя указанное имя и значение. Скопируйте и вставьте значение; не вводите его повторно.
4
Подождите распространения
Изменения DNS не происходят мгновенно. Обычно несколько минут; до часа — это нормально, если ваш провайдер использует длинный TTL.
5
Нажмите «Подтвердить».
Вернувшись в Cache Rocket, нажмите Подтвердить рядом с hostname. Если это не помогло, подождите дольше и нажмите еще раз — повторная попытка бесплатна и ничего не сбрасывает.

Проверка записи самостоятельно

Если проверка продолжает завершаться неудачей, убедитесь, что запись действительно видна в общедоступном Интернете, прежде чем предполагать, что виноват Cache Rocket:

macOS и Linux

bash

dig +short TXT _cacherocket.example.com

Окна

powershell

Resolve-DnsName -Type TXT _cacherocket.example.com

Замените имя записи, которое вам показало Cache Rocket. Если команда ничего не возвращает, запись еще не распространилась или была сохранена неправильно.

Распространенные ошибки DNS

Поставщики различаются в зависимости от того, ожидают ли они полное имя записи или только часть поддомена — ввод _cacherocket.example.com там, где провайдер уже добавляет ваш домен, дает _cacherocket.example.com.example.com. Также следите за автоматическим добавлением кавычек и конечными пробелами при вставке.

Метод Б — файл HTTPS или метатег.

Выберите HTTPS-файл или метатег и нажмите Начать проверку. Затем Cache Rocket показывает три вещи: URL-адрес, который он будет проверять, точный контент, который URL-адрес должен вернуть, и эквивалентный тег <meta>. Вам необходимо опубликовать либо файл или метатег, но не то и другое.

Публикация файла

Создайте файл по указанному пути, содержащий именно показанный контент и ничего больше. В проекте Next.js это означает размещение его в каталоге public/:

Next.js, Vite, Astro и большинство статических хостов.

text

public/
  └── .well-known/
        └── cacherocket-verification.txt

Разверните, затем откройте URL-адрес проверки в браузере. Вы должны увидеть только токен. Если вы видите страницу 404 вашего сайта в стиле HTML или перенаправление, значит, она еще не опубликована правильно.

Или используя метатег

Если добавлять файлы неудобно, вместо этого поместите прилагаемый тег <meta> в <head> на вашей домашней странице. В App Router Next.js вы можете добавить его посредством экспорта метаданных:

приложение/layout.tsx

export const metadata = {
  other: {
    'cacherocket-site-verification': 'YOUR_TOKEN_HERE',
  },
};

Разверните, затем нажмите Проверить.

Файл должен быть общедоступным

Если ваш сайт защищен базовой аутентификацией HTTP, списком разрешенных IP-адресов, промежуточным паролем или страницей «скоро», Cache Rocket не сможет прочитать файл проверки. Либо разрешите публичный доступ к этому пути, либо вместо этого используйте метод DNS.

Я добавил запись DNS, но проверка по-прежнему не удалась.: Почти всегда распространение. Подтвердите, что запись общедоступна, с помощью команды dig выше. Если dig находит его, а Cache Rocket нет, проверьте наличие дублированного суффикса домена в имени записи или второй конфликтующей записи TXT с тем же именем.
Файл проверки нормально открывается в моем браузере, но Cache Rocket не может его прочитать.: Ваш браузер может быть аутентифицирован, а Cache Rocket — нет. Попробуйте URL-адрес в личном окне. Также убедитесь, что он обслуживается через https без перенаправления и что ответ представляет собой обычный текст, а не HTML-страницу, содержащую токен.
Какой hostname я должен проверить, перенаправляется ли мой сайт?: Пункт назначения — hostname, который появляется в адресной строке после завершения перенаправления. Это тот, который должны использовать ваши URL-адреса входа.
Нужно ли мне проверять каждый поддомен?: Да. Каждый hostname проверяется независимо, без подстановочного знака. shop.example.com требует собственной проверки, даже если example.com уже проверен.
Могу ли я подтвердить домен, которым я управляю, для клиента, но не являюсь его владельцем?: Да, при условии, что вы можете добавить запись DNS или опубликовать файл — именно это и проверяется в ходе испытания. Агентства обычно проверяют каждого клиента hostname внутри рабочего пространства этого клиента. См. Команды и роли.
Могу ли я согреть адрес localhost или только внутренний адрес?: Нет. Cache Rocket нагревается из общедоступного Интернета, поэтому hostname должен быть публично разрешимым и доступным.