Підтвердження хостнейму

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

9 хв читання

Перш ніж Cache Rocket надішле один запит до домену, ви повинні підтвердити, що ви ним керуєте. На цій сторінці описано як методи перевірки, так і те, що робити, якщо один не вдається.

Hostnames живе під Обліковий запис → Hostnames.

Чому це потрібно

Кеш warmer — це машина, яка дуже швидко надсилає багато запитів на сайт. Це корисно, коли спрямовано на ваш власний сервер, і вороже, коли спрямовано на чужий — це, функціонально, інструмент відмови в обслуговуванні.

Перевірка – це те, що розділяє ці два. Це означає, що кожен запит, який Cache Rocket надсилає від вашого імені, надсилається до інфраструктури, яку ви, як доведено, контролюєте. Немає можливості відмовитися від участі та немає плану, який скасовує цю вимогу.

Note

Це також захищає вас. Ніхто інший не може створити warmer, що вказує на ваш домен, оскільки вони не можуть пройти перевірку.

Вибір методу

TXT-запис DNSФайл 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 — TXT-запис DNS

  1. 1

    Додайте hostname

    У Обліковий запис → Hostnames введіть домен і виберіть Запис DNS TXT як метод перевірки.

  2. 2

    Почніть перевірку

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

  3. 3

    Створіть запис у свого постачальника DNS

    Увійдіть будь-де, де керується ваш DNS — Cloudflare, ваш реєстратор, панель керування хостом — і додайте новий запис TXT, використовуючи вказане ім’я та значення. Скопіюйте та вставте значення; не вводьте його повторно.

  4. 4

    Дочекайтеся розповсюдження

    Зміни DNS не відбуваються миттєво. Типовим є кілька хвилин; до години – це нормально, якщо ваш провайдер використовує довгий TTL.

  5. 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> вашої домашньої сторінки. У Next.js App Router ви можете додати його через експорт метаданих:

app/layout.tsx
ts
export const metadata = {
  other: {
    'cacherocket-site-verification': 'YOUR_TOKEN_HERE',
  },
};

Розгорніть, а потім натисніть Перевірити.

Файл має бути загальнодоступним

Якщо ваш сайт підтримує базову автентифікацію HTTP, список дозволених IP-адрес, проміжний пароль або сторінку «незабаром», Cache Rocket не зможе прочитати файл підтвердження. Або дозвольте публічний доступ до цього одного шляху, або замість цього скористайтеся методом DNS.

Після перевірки

hostname показує Перевірено у вашому списку, і його можна негайно використовувати в URL-адресах входу як у кеші warmers, так і в API warmers.

Ви можете безпечно видалити запис TXT або файл перевірки пізніше, хоча залишити їх на місці простіше — це означає, що повторна перевірка миттєва, якщо вона колись знадобиться.

Видалення hostname

Видалення hostname порушує його warmers

Будь-який warmer з URL-адресами входу на цьому hostname почне видавати збій, оскільки його URL-адреси більше не вказують на перевірену інфраструктуру. Спочатку перемістіть або видаліть ці warmers або повторно перевірте hostname, щоб відновити їх.

Перевірка постійно не вдається

Я додав запис DNS, але перевірка все ще не вдається.
Майже завжди поширення. Підтвердьте, що запис є загальнодоступним за допомогою команди dig вище. Якщо dig знаходить його, а Cache Rocket – ні, перевірте наявність повторюваного суфікса домену в назві запису або другий конфліктний запис TXT для того самого імені.
Файл перевірки добре відкривається в моєму браузері, але Cache Rocket не може його прочитати.
Ваш браузер може бути автентифікованим, а Cache Rocket – ні. Спробуйте URL-адресу в приватному вікні. Також переконайтеся, що він обслуговується через https без перенаправлення, і що відповідь є звичайним текстом, а не сторінкою HTML, яка містить маркер.
Який hostname мені перевірити, якщо мій сайт переспрямовує?
Пункт призначення — hostname, який з’являється в адресному рядку після завершення переспрямування. Це той, який мають використовувати ваші URL-адреси входу.
Чи потрібно підтверджувати кожен субдомен?
так Кожен hostname перевіряється незалежно, і немає жодного варіанта підстановки. shop.example.com потребує власної перевірки, навіть якщо example.com вже перевірено.
Чи можу я підтвердити домен, яким я керую для клієнта, але не володію ним?
Так, за умови, що ви можете додати запис DNS або опублікувати файл — це саме те, що перевіряє завдання. Агентства зазвичай перевіряють кожного клієнта hostname в робочому просторі цього клієнта. Див. [Команди та ролі] (/documentation/teams-and-roles).
Чи можу я нагріти localhost або внутрішню адресу?
Номер Cache Rocket нагрівається з публічного Інтернету, тому hostname має бути загальнодоступним і доступним.