Подключение Cloudflare или GoDaddy на странице DNS
Как подключить аккаунт Cloudflare или GoDaddy, чтобы управлять DNS-записями из панели.
На этой странице
Страница «DNS» (app.blackbox.md/dns, боковое меню → «Инфраструктура» → «DNS») связывает панель app.blackbox.md с вашим аккаунтом Cloudflare или GoDaddy: DNS-записи доменов можно менять, не заходя в панель провайдера. Под заголовком написано: «Подключите DNS-провайдера и управляйте записями для ваших доменов.»
Доступно: владельцу аккаунта blackbox.md в панели, открытой из личного кабинета (Вход в панель app.blackbox.md из аккаунта).
Как это работает
- BLACKBOX не размещает DNS-зоны. Зона домена остаётся у Cloudflare или GoDaddy, а панель читает и меняет записи через API провайдера с помощью токена или ключа, который вы укажете.
- Страница «DNS» бесплатна.
- Для каждого провайдера возможно только одно подключение: одно для Cloudflare и одно для GoDaddy. После подключения кнопка этого провайдера исчезает.
- Подключение относится к аккаунту, а не к конкретному серверу.
- Изменения действуют, только если домен использует серверы имён (NS) подключённого провайдера. Если DNS домена обслуживается в другом месте, меняйте записи там: Как направить домен на сервер.
Если вместо содержимого страницы появляется «Управление DNS сейчас недоступно.», сервис временно недоступен. Попробуйте зайти позже. Если сообщение не исчезает, напишите нам: Как связаться с поддержкой BLACKBOX.
Подготовьте токен Cloudflare
В форме подключения панель показывает подсказку: «Создайте токен на dash.cloudflare.com → My Profile → API Tokens с разрешениями Zone → Zone → Read и Zone → DNS → Edit. Появятся только те зоны, к которым у токена есть доступ.»
- Войдите на dash.cloudflare.com и откройте «My Profile» → «API Tokens».
- Нажмите «Create Token» и выберите пользовательский токен («Create Custom Token»).
- В разделе «Permissions» добавьте две строки: «Zone» → «Zone» → «Read» и «Zone» → «DNS» → «Edit».
- В разделе «Zone Resources» укажите домены, которыми хотите управлять из панели: конкретный домен или все.
- Оставьте пустым «Client IP Address Filtering». Проверка и изменения выполняются с серверов BLACKBOX, а не из вашего браузера, поэтому токен, ограниченный вашим IP, будет отклонён.
- Создайте токен и сразу скопируйте его: Cloudflare показывает токен только один раз.
Нужен именно API-токен, а не «Global API Key»: панель принимает только токены.
Подготовьте ключ GoDaddy
В форме подключения панель показывает подсказку: «Создайте production-ключ на developer.godaddy.com → API Keys. GoDaddy предоставляет доступ к API только аккаунтам, у которых есть хотя бы один домен.»
- Войдите на developer.godaddy.com под аккаунтом GoDaddy, в котором находятся домены, и откройте «API Keys».
- Создайте новый ключ («Create New API Key») и выберите среду «Production». Ключ «OTE» (тестовая среда GoDaddy) не подойдёт: панель работает только с рабочим API.
- GoDaddy покажет два значения — «Key» и «Secret». Скопируйте оба.
Как подключить провайдера
- Откройте «DNS» в панели. В разделе «Подключения» нажмите «Подключить Cloudflare» или «Подключить GoDaddy».
- Откроется форма с подсказкой для выбранного провайдера.
- В поле «Метка» при желании укажите название подключения, например «Домены компании».
- Для Cloudflare вставьте токен в поле «API-токен». Для GoDaddy заполните «API-ключ» (значение Key) и «API-секрет» (значение Secret).
- Нажмите «Подключить». Панель проверяет данные у провайдера ещё до сохранения.
- Если данные приняты, форма закроется, а в списке появится подключение со статусом «Активно». Панель сразу выберет его и загрузит ниже зоны и записи: Управление DNS-записями из панели.
При ошибке сообщение появится в форме, а введённые данные останутся в полях. Чтобы закрыть форму, ничего не подключая, нажмите «Отмена».
| Поле | Провайдер | Правило |
|---|---|---|
| «Метка» | оба | Необязательное, не более 120 символов. Без метки подключение отображается под названием провайдера. |
| «API-токен» | Cloudflare | Обязательное, не более 512 символов. При вводе символы скрыты. Вставляйте токен без пробелов в начале и в конце. |
| «API-ключ» и «API-секрет» | GoDaddy | Оба обязательные. «API-секрет» при вводе скрыт. |
Безопасность После сохранения токен и ключ хранятся в зашифрованном виде и больше никогда не показываются. Давайте токену только два разрешения, указанных выше, и только для нужных доменов.
Строка подключения
Каждое подключение показано отдельной строкой в разделе «Подключения». Если подключены оба провайдера, нажмите на строку, чтобы ниже увидеть зоны этого подключения; выбранная строка выделяется.
| Элемент | Что показывает |
|---|---|
| Значок провайдера | «Cloudflare» или «GoDaddy» |
| Название | Ваша метка или, если её нет, название провайдера |
| Аккаунт (подсказка «Аккаунт» при наведении курсора) | Cloudflare: идентификатор токена, а не сам токен. GoDaddy: godaddy:, затем первые 4 и последние 4 символа ключа. |
| Статус | «Активно» или «Требует внимания» |
| «Последняя проверка: …» | Дата и время последней успешной проверки |
| Последняя ошибка | Текст от провайдера (на английском), если провайдер отклонил данные |
| Статус | Что значит | Что делать |
|---|---|---|
| «Активно» | Данные приняты, и с тех пор провайдер их не отклонял | Ничего |
| «Требует внимания» | Провайдер отклонил токен или ключ: его удалили, срок действия истёк, его отключили или у него отозвали разрешения. Причина показана как последняя ошибка. | Создайте новый токен или ключ, нажмите «Отключить», затем подключите провайдера заново. Если вы устранили проблему у провайдера, не меняя токен или ключ, нажмите «Проверить». |
Кнопка «Проверить»
«Проверить» заново отправляет данные провайдеру. Если они приняты, статус становится «Активно», «Последняя проверка» обновляется, а последняя ошибка исчезает. Если провайдер их отклонит, в строке подключения появится сообщение об ошибке, а после обновления страницы у подключения будет статус «Требует внимания».
Для Cloudflare «Проверить» подтверждает лишь то, что токен активен. Если у токена не хватает разрешений, это проявится при загрузке зон или при сохранении записей.
Кнопка «Отключить»
- Нажмите «Отключить» в строке подключения.
- Подтвердите в окне «Отключить {name}? Вы сможете подключить его снова позже.», где {name} — метка подключения или название провайдера.
- Подключение исчезнет из списка, а кнопка «Подключить Cloudflare» или «Подключить GoDaddy» появится снова.
Отключение не меняет DNS-записи: они остаются у провайдера, просто панель больше не имеет к ним доступа. Чтобы подключиться снова, введите токен или ключ ещё раз.
Важно После «Отключить» удалите и сам токен в Cloudflare («My Profile» → «API Tokens») или ключ в GoDaddy («API Keys»). Только тогда этим токеном или ключом больше нельзя будет воспользоваться.
Сообщения об ошибках
| Сообщение | Что значит | Что делать |
|---|---|---|
| «Провайдер отклонил эти учётные данные.» и пояснение провайдера на английском | Токен или ключ неверный, удалён, просрочен или без нужных разрешений. Для GoDaddy также: ключ «OTE» или аккаунт без доступа к API. | Создайте новый токен или ключ по шагам выше и подключите провайдера заново |
| «Провайдер ограничивает количество запросов. Повторите попытку позже.» | Cloudflare или GoDaddy временно ограничил запросы | Подождите несколько минут и повторите |
| «Провайдер не ответил вовремя. Повторите попытку.» | Провайдер не ответил вовремя или с ним не удалось связаться | Повторите попытку |
| «Провайдер временно недоступен. Повторите попытку позже.» | Провайдер ответил ошибкой | Повторите позже |
| «Этот провайдер уже подключён.» | У вас уже есть подключение к этому провайдеру, например созданное в другой вкладке | Обновите страницу. Чтобы заменить токен или ключ, отключите старое подключение и подключите заново. |
| «Слишком много запросов. Повторите попытку позже.» | Превышен один из лимитов в таблице ниже, обычно 5 попыток подключения за 10 минут | Не повторяйте попытки и подождите: для подключения — до 10 минут после последней попытки. Каждая новая попытка в это время продлевает блокировку. |
| «Не удалось подключить провайдера.» | Обязательное поле пустое, текст слишком длинный («Метка» длиннее 120 символов, «API-токен» длиннее 512) или произошла другая ошибка | Проверьте поля и повторите |
| «Не удалось загрузить данные DNS.» | Список подключений или проверка не удались по другой причине | Обновите страницу и повторите |
| «Не удалось удалить.» | Отключить не удалось | Обновите страницу и повторите |
| «Not found» | Подключения уже нет, например вы отключили его в другой вкладке | Обновите страницу |
Лимиты
| Действие | Лимит |
|---|---|
| Подключение провайдера, включая неудачные попытки | 5 за 10 минут |
| «Проверить», «Отключить» и изменения записей вместе | 60 в минуту |
| Загрузка подключений, зон и записей | 120 в минуту |
Все лимиты аккаунта и панели: Сообщение «Слишком много попыток» и лимиты использования.
Частые вопросы
Можно ли подключить два аккаунта Cloudflare? Нет, панель допускает только одно подключение к каждому провайдеру. Зато один токен Cloudflare может охватывать несколько доменов: их выбирают в «Zone Resources». Чтобы перейти на другой аккаунт, нажмите «Отключить» и подключите токен нового аккаунта.
Моего домена нет в списке зон. Почему? Показываются только зоны, к которым у токена есть доступ. В Cloudflare зона должна быть активной, то есть домен уже должен использовать серверы имён Cloudflare; в GoDaddy показываются только активные домены. Исправьте токен или зону у провайдера, затем нажмите «Обновить» рядом с «Зона».
GoDaddy отклоняет ключ, хотя он скопирован правильно.
Проверьте, что ключ создан в среде «Production». Если в пояснении провайдера говорится об отказе в доступе (например, ACCESS_DENIED), у аккаунта GoDaddy нет доступа к API. Условия доступа определяет GoDaddy — уточните их на developer.godaddy.com. А пока меняйте записи прямо в аккаунте GoDaddy.
Как заменить сохранённый токен или ключ? Нажмите «Отключить» и подключите провайдера заново с новым токеном или ключом. Сохранённые данные нельзя посмотреть или отредактировать.
На странице написано «К вашему аккаунту пока не привязано ни одно DNS-подключение.», а кнопок подключения нет. Учётная запись панели, под которой вы вошли, не связана с аккаунтом на blackbox.md. Откройте панель из личного кабинета на blackbox.md. Если сообщение не исчезает, напишите нам.