Справка

Введение

HORiZONT cloud — платформа для управления поддоменами, DNS-записями, почтой и сайтами: конструктор с готовыми шаблонами, серверные скрипты PHP, базы данных, SSL-сертификаты Let's Encrypt, выбор версии PHP и установка библиотек. Через панель можно создавать поддомены на доменах ht-c.online и ht-c.online с автоматически развёрнутой почтой вида name@name.ht-c.online, делегировать свои домены, управлять всеми типами DNS-записей и заводить почтовые ящики.

Для интеграций с внешними проектами используйте API v1. Документация и примеры — в разделе «Для разработчиков» в левом меню.

Домены и поддомены

Как создать поддомен?
  1. Откройте панель управления и перейдите в раздел Домены.
  2. Нажмите Создать поддомен.
  3. Введите имя (латиница, цифры, дефис, подчёркивание).
  4. Выберите родительский домен.
  5. Нажмите Создать.
Как добавить свой домен от другого регистратора?
  1. В разделе Домены нажмите Добавить свой домен.
  2. Введите полное имя, например example.com.
  3. У регистратора укажите NS-серверы:
ns1.ht-c.ru ns2.ht-c.ru

Изменения вступят в силу через 1–24 часа.

Сколько поддоменов можно создать?

По умолчанию — 10 поддоменов на аккаунт. Лимит увеличивается по запросу у администратора.

Что делать, если поддомен занят?

Имена глобально уникальны. Если имя занято — выберите другое. Удалённый поддомен освобождает имя через несколько минут.

DNS-записи

Какие типы DNS-записей поддерживаются?
  • A — привязка домена к IPv4-адресу
  • AAAA — привязка к IPv6
  • CNAME — псевдоним для другого домена
  • MX — почтовый сервер
  • TXT — произвольный текст (SPF, DKIM, DMARC)
  • SRV — сервисы (Minecraft, VoIP)
  • NS — делегирование поддомена
Как добавить A-запись?
  1. В разделе Домены нажмите Управление у поддомена.
  2. Выберите тип A.
  3. Имя: @ или www.
  4. Значение — IPv4-адрес.
  5. Нажмите Добавить.

Проверка:

dig @8.8.8.8 myapp.ht-c.online A
Как настроить MX-запись?
Тип: MX Имя: @ Приоритет: 10 Целевой сервер: mail.ht-c.ru
Как быстро распространяются изменения DNS?

На нашем DNS — мгновенно. Внешние резолверы обновляются по TTL. При TTL 300 секунд — до 5 минут.

Как настроить SRV для Minecraft?
Тип: SRV Имя: _minecraft._tcp.play Приоритет: 0 Вес: 5 Порт: 25565 Цель: mc.example.com

Почта

Как создать почтовый ящик?
  1. Перейдите в раздел Почта.
  2. Нажмите Создать.
  3. Выберите поддомен.
  4. Введите имя ящика и пароль.
  5. Нажмите Создать.

Адрес: info@myapp.ht-c.online.

Сколько ящиков можно создать?

По умолчанию — 3 на аккаунт. Лимит увеличивается по запросу.

Как читать почту в браузере?

Откройте mailbox.ht-c.ru и войдите. Доступны папки Входящие, Отправленные, Черновики, Удалённые, Спам, Архив. Можно добавить несколько аккаунтов и переключаться между ними.

Как настроить почтовый клиент?

Входящая (IMAP):

Сервер: mail.ht-c.ru Порт: 993 Шифрование: SSL/TLS Логин: полный email

Исходящая (SMTP):

Сервер: mail.ht-c.ru Порт: 587 Шифрование: STARTTLS Логин: полный email
Как настроить SPF, DKIM и DMARC?

SPF:

Имя: @ Значение: v=spf1 mx ~all

DMARC:

Имя: _dmarc Значение: v=DMARC1; p=quarantine; rua=mailto:admin@вашдомен.ru
Что такое почта на поддоменах и доменах?

Это уникальная система HORiZONT cloud: вы создаёте собственный поддомен (например myapp.ht-c.online) или подключаете свой домен, и почта на нём разворачивается автоматически — без ручной настройки MX, SPF и DKIM. Адрес выглядит так: name@name.ht-c.online.

  • Поддомен на ht-c.online или ht-c.online даёт готовую почту сразу после создания.
  • Для своего домена делегируйте DNS на наши серверы — почтовые записи добавятся сами.
  • Ящики открываются в веб-почте mailbox.ht-c.ru и в любом почтовом клиенте.

Аккаунт и безопасность

Как сменить логин, email или пароль?

В панели откройте Настройки — там три формы: логин, email, пароль. Изменения применяются мгновенно.

Забыли пароль?
  1. На странице входа нажмите Забыли пароль?
  2. Введите email.
  3. Введите код из письма.
  4. Придумайте новый пароль.
Как работает реферальная программа?
  • Вы получаете +5 ₽ за каждого приглашённого
  • Плюс 10% от его платежей
  • Приглашённый получает +10 ₽
Как работает мультиаккаунт?

В сайдбаре панели внизу — блок «Аккаунты». Клик по аккаунту переключает без пароля. Крестик — выход из конкретного. «Выйти из всех» — очистка списка.

Как включить двухфакторную аутентификацию (TOTP)?
  1. Откройте Настройки → Двухфакторная аутентификация и нажмите Включить.
  2. Отсканируйте QR-код в приложении (Google Authenticator, Aegis, Яндекс Ключ и др.) или введите ключ вручную.
  3. Введите 6-значный код и подтвердите. Сохраните 8 резервных кодов — каждый действует один раз.

После включения вход требует пароль и код. В Telegram-боте привязка аккаунта выполняется командой /login логин пароль код. Отключить защиту можно в том же разделе: потребуются пароль и код.

Что делать, если нет доступа к приложению-аутентификатору?

Используйте один из резервных кодов вместо кода из приложения. После входа создайте новые коды в настройках. Если резервных кодов нет, обратитесь в поддержку на help.ht-c.online с почты аккаунта.

Как посмотреть активные сеансы и завершить один из них?

В Настройках есть блок Активные сеансы: устройство, IP-адрес, время входа и последней активности. Кнопка Завершить рядом с сеансом выходит из аккаунта только на этом устройстве. Текущий сеанс отмечен, его завершает кнопка «Выйти». Смена пароля и «Выйти на всех устройствах» завершают остальные сеансы автоматически.

Почему вход временно заблокирован?

Для защиты от подбора пароля действует ограничение попыток по IP-адресу: после 8 неудачных попыток входа (включая неверные коды 2FA) за 15 минут вход с этого адреса закрывается на оставшееся время. Подождите указанное в сообщении время и попробуйте снова.

Как подписаться на уведомления о статусе сервисов?

На странице ht-c.online/status в блоке «Уведомления о статусе» выберите способ:

  • По почте — введите адрес и подтвердите его по ссылке из письма. В каждом письме есть ссылка для отписки.
  • В Telegram — откройте бота по кнопке и нажмите «Запустить» либо отправьте /subscribe. Отписка: /unsubscribe.

Уведомления приходят при сбое и восстановлении сервисов, а также при публикации важного сообщения администраторами.

API: Аутентификация

Базовый URL: https://ht-c.online/cp-api/v1. Все запросы требуют токен, который передаётся одним из способов:

Authorization: Bearer <token> X-API-Key: <token> или параметр ?api_key=<token>

Токены создаются в панели управления: Настройки → API-токены. Каждый токен имеет права (scopes):

  • subdomains.read, subdomains.write
  • dns.read, dns.write
  • mailboxes.read, mailboxes.write
  • account.read
  • * — полный доступ

Лимит: 60 запросов в минуту на токен.

API: Поддомены

GET /cp-api/v1/subdomains
Список поддоменов с количеством DNS-записей
curl -H "Authorization: Bearer TOKEN" \ https://ht-c.online/cp-api/v1/subdomains
POST /cp-api/v1/subdomains
Создать поддомен
curl -X POST -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"subdomain":"myapp","domain":"ht-c.online"}' \ https://ht-c.online/cp-api/v1/subdomains
DELETE /cp-api/v1/subdomains?id=123
Удалить поддомен и все его DNS-записи

API: DNS-записи

GET /cp-api/v1/dns?subdomain_id=123
Список DNS-записей поддомена
POST /cp-api/v1/dns
Создать запись. Типы: A, AAAA, CNAME, MX, TXT, SRV, NS
curl -X POST -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"subdomain_id":123,"type":"A","name":"@","content":"1.2.3.4","ttl":300}' \ https://ht-c.online/cp-api/v1/dns
DELETE /cp-api/v1/dns?id=456
Удалить DNS-запись

API: Почта

GET /cp-api/v1/mailboxes
Список ящиков
POST /cp-api/v1/mailboxes
Создать ящик
curl -X POST -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"subdomain_id":123,"localpart":"info","password":"StrongPass123"}' \ https://ht-c.online/cp-api/v1/mailboxes
DELETE /cp-api/v1/mailboxes?id=789
Удалить ящик

API: Аккаунт

GET /cp-api/v1/account
Профиль, баланс, лимиты, счётчики
curl -H "Authorization: Bearer TOKEN" \ https://ht-c.online/cp-api/v1/account

API: Примеры на языках

Python

import requests API = "https://ht-c.online/cp-api/v1" TOKEN = "ваш_токен" HEADERS = {"Authorization": f"Bearer {TOKEN}"} # Список поддоменов r = requests.get(f"{API}/subdomains", headers=HEADERS) print(r.json()) # Создать A-запись data = {"subdomain_id": 123, "type": "A", "name": "@", "content": "1.2.3.4", "ttl": 300} r = requests.post(f"{API}/dns", headers=HEADERS, json=data) print(r.json())

Node.js

const API = "https://ht-c.online/cp-api/v1"; const TOKEN = "ваш_токен"; async function listSubdomains() { const res = await fetch(`${API}/subdomains`, { headers: { "Authorization": `Bearer ${TOKEN}` } }); return await res.json(); } async function createDns(subdomainId, type, content) { const res = await fetch(`${API}/dns`, { method: "POST", headers: { "Authorization": `Bearer ${TOKEN}`, "Content-Type": "application/json" }, body: JSON.stringify({ subdomain_id: subdomainId, type, name: "@", content, ttl: 300 }) }); return await res.json(); }

PHP

$ch = curl_init('https://ht-c.online/cp-api/v1/subdomains'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer ВАШ_ТОКЕН' ]); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true);

Сайты и конструктор

Как создать сайт?
  1. Откройте раздел «Мои сайты» и нажмите «Создать сайт».
  2. Выберите домен или поддомен, на котором появится сайт.
  3. В редакторе выберите шаблон кнопкой «Шаблоны» или соберите страницу из блоков в левой панели.
  4. Нажмите «Опубликовать». Сайт станет доступен по выбранному адресу в течение нескольких секунд.

Каждая публикация заменяет предыдущую версию. Черновик сохраняется в проекте, и его можно продолжить редактировать позже.

Как работать с блоками и настройками элементов?

Перетащите блок из левой панели на страницу. Нажмите на любой элемент, чтобы выбрать его: справа появятся настройки оформления (отступы, цвет, шрифт, размеры), а дважды нажав на текст, вы можете его изменить. Для телефона и планшета переключите устройство в верхней панели и настройте внешний вид отдельно. Панель слоёв показывает вложенность элементов и помогает выбрать нужный.

Если блок оказался не там, где нужно, перетащите его за название в панели слоёв или нажмите Ctrl+Z.

Как загрузить изображения на сайт?
  1. Нажмите кнопку «Изображения» в верхней панели редактора.
  2. Перетащите файлы в выделенную рамку или нажмите «Выбрать файлы». Допустимы форматы JPG, PNG, GIF и WebP размером до 6 МБ.
  3. После загрузки в окне появятся превью. Нажмите «Вставить», и картинка добавится в выбранный блок или в конец страницы.
  4. Чтобы заменить существующую картинку, выберите её на странице и нажмите «Вставить» у нужного изображения.

Крестик на превью удаляет файл с сервера. Загруженные изображения занимают место в вашей дисковой квоте.

Какие шаблоны доступны?

В редакторе доступно более двадцати шаблонов в разных стилях:

  • Студия дизайна, Блог - тёплый песочный стиль с засечками, журнальная подача.
  • IT-стартап - тёмная фиолетово-синяя тема с тарифами и регистрацией.
  • Барбершоп - тёмный фон и золотой акцент.
  • Фитнес-клуб - контрастная чёрно-лаймовая тема с прямыми углами.
  • Фотограф - монохромный минимализм и крупная галерея.
  • Цветочный магазин - нежная пастельно-розовая палитра.
  • Юридическая фирма - строгий деловой синий.
  • Онлайн-школа, Стоматология - мятные и бирюзовые оттенки.
  • Конференция - светло-фиолетовая страница события.
  • Витрина магазина - пастельно-голубой каталог с заказом.
  • Мобильное приложение - персиковый лендинг с опросом.
  • Сайт с личным кабинетом - регистрация, вход и счётчик посещений.
  • Базовые шаблоны: лендинг, сайт компании, портфолио, кафе, визитка, страница «Скоро открытие».

После выбора шаблона замените тексты и картинки на свои. Формы в шаблонах уже подключены к серверным скриптам.

Какие блоки есть в редакторе?

Блоки сгруппированы по категориям:

  • Секции - шапка, главный экран, преимущества, цифры, этапы работы, каталог товаров, лента статей, тарифы, отзывы, команда, галерея, вопросы, призыв к действию, контакты, подвал.
  • Формы и скрипты - регистрация, вход, личный кабинет, обратная связь, заявка, бронирование, подписка, гостевая книга, опрос, счётчик посещений.
  • Базовые - заголовки, текст, кнопки, ссылки, картинки, списки, цитаты, разделители, раскрывающийся блок, информационная плашка.
  • Макет - контейнеры, колонки, карточки.
  • Медиа - видео, карта, галерея, аватар.

Блоки с серверными скриптами

Блоки из категории «Формы и скрипты» работают без программирования. При публикации сайта панель сама устанавливает нужные скрипты в папку _htc, подключает базу данных и настраивает защиту. Эти блоки не требуют ручных настроек, но для получения заявок на почту нужно указать адрес в настройках сайта (вкладка «Скрипты и база данных»).

Регистрация и вход посетителей

Блок «Регистрация» принимает имя, почту и пароль (не менее 8 символов) и создаёт учётную запись посетителя. Пароли хранятся только в виде необратимого хэша. После регистрации посетитель попадает в личный кабинет. Блок «Вход» открывает кабинет по почте и паролю. В кабинете можно сменить пароль и выйти.

Защита: проверка источника запроса, скрытое поле-ловушка для ботов, ограничение частоты попыток (регистрация - 5 в час, вход - 10 за 15 минут с одного адреса).

Список зарегистрированных пользователей доступен в настройках сайта на вкладке «Данные форм».

Форма обратной связи, заявка и бронирование

Эти блоки сохраняют все поля формы в базу и отправляют копию на почту, указанную в настройках сайта. Название формы задаётся скрытым полем, поэтому разные формы на одном сайте различаются. Лимиты: до 20 полей, до 2000 символов в каждом, не более 6 отправок за 10 минут с одного адреса.

Подписка на рассылку

Собирает адреса электронной почты без дублей. Список подписчиков отображается на вкладке «Данные форм». Рассылку вы отправляете самостоятельно любым удобным сервисом.

Гостевая книга

Кнопка ведёт на страницу /_htc/guestbook.php, где посетители читают и оставляют записи. Ссылки в сообщениях автоматически удаляются, текст экранируется, частота записей ограничена.

Опрос

Посетитель выбирает вариант и видит результаты в процентах. С одного адреса можно голосовать раз в сутки. Варианты ответов меняются прямо в редакторе: измените текст и значение (value) выбранного пункта. Несколько опросов на сайте различаются значением скрытого поля poll.

Счётчик посещений

Изображение /_htc/counter.php показывает число загрузок страницы. Вставьте блок в подвал сайта. Подробная статистика посещений доступна в настройках сайта на вкладке «Обзор».

Настройки сайта

Откройте «Мои сайты» и нажмите «Настройки» у нужного сайта либо воспользуйтесь кнопкой «Настройки» в редакторе. Вверху страницы выберите домен, настройки которого хотите изменить.

Вкладка «Обзор»

Показывает статус публикации, тип сертификата, версию PHP, занятое место на диске и график посещаемости за 14 дней: число запросов, уникальных посетителей и переданный трафик.

SSL-сертификат Let's Encrypt

Позволяет открывать сайт по защищённому соединению с собственным сертификатом вашего домена. Без него используется общий сертификат платформы, и браузеры могут показывать предупреждение для собственных доменов.

Условия выпуска:

  • Сайт опубликован.
  • A-запись домена указывает на IP сервера 104.143.201.179. Для поддоменов платформы запись создаётся автоматически при публикации.
  • Порты 80 и 443 доступны.

Нажмите «Получить сертификат». Выпуск занимает до минуты. Сертификат действует 90 дней и продлевается автоматически. Кнопка «Отключить» возвращает общий сертификат. Выпустить сертификат также можно командой /ssl домен в Telegram-боте.

Если выпуск не удался, проверьте DNS-записи (инструмент «DNS-проверка») и повторите попытку через несколько минут. Лимит Let's Encrypt - не более пяти сертификатов в неделю для одного домена.

Выбор версии PHP

На вкладке «Версия PHP» доступны версии 8.1, 8.2, 8.3 и 8.4. Новая версия применяется сразу. Если после смены версии скрипты начали выдавать ошибки, вернитесь на предыдущую. Среда выполнения изолирована: доступ только к файлам вашего хранилища, время выполнения до 15 секунд, память до 128 МБ, запуск системных команд запрещён.

Скрипты и база данных

На вкладке «Скрипты и база данных» можно установить готовые серверные скрипты вручную (например, для сайта, собранного из файлов), удалить их и указать почту для заявок. База данных MySQL создаётся автоматически при установке первого скрипта и учитывается в лимите баз данных вашего аккаунта.

Свои PHP-скрипты: подключите _htc/lib.php и получайте параметры подключения функцией htc_cfg(), либо создайте собственную базу в разделе «Хранилище». Доступно:

  • MySQL через PDO или mysqli (только ваши базы);
  • HTTP-запросы к внешним API через curl или file_get_contents;
  • отправка почты функцией mail() (письма уходят через почтовый сервер платформы, не более 30 в час и 100 в сутки с сайта; адрес отправителя заменяется на адрес платформы, ваш адрес попадает в Reply-To);
  • сессии, загрузка файлов, работа с файлами внутри папки сайта.

Ограничено в целях безопасности: запуск системных команд, доступ к чужим файлам и внутренним сервисам сервера, прямые подключения к почтовым портам и SSH.

Библиотеки

PHP-библиотеки (Composer). Введите имя пакета с packagist.org, например phpmailer/phpmailer или monolog/monolog:^3.0, и нажмите «Установить». Файлы сохраняются вне публичной папки сайта и занимают место в вашей дисковой квоте. Подключение в коде: require __DIR__ . '/_htc/bootstrap.php';. При нехватке места установка отменяется.

Библиотеки оформления. Bootstrap, jQuery, Alpine.js, Swiper, Chart.js, GSAP, AOS, GLightbox, Animate.css и Normalize.css скачиваются на ваш сайт и подключаются на все страницы при следующей публикации в редакторе. Кнопка «Убрать» удаляет файл и отключает подключение.

Данные форм

Показывает последние записи: зарегистрированных посетителей, заявки из форм, подписчиков и записи гостевой книги с общим количеством. Данные хранятся в вашей базе, и вы можете работать с ними собственными скриптами.

Telegram-бот

Какие команды доступны?
  • /me, /balance, /history - профиль, баланс и операции;
  • /domains, /dns домен, /mail - домены, DNS-записи и почта;
  • /sites, /site домен, /ssl домен, /traffic домен - сайты, карточка сайта, выпуск сертификата, посещаемость;
  • /storage - использование диска;
  • /support, /new, /ticket N - обращения в поддержку;
  • /ref, /status, /notify - рефералы, статус сервисов, уведомления.

Администраторам дополнительно доступны /server, /audit, /quota, /relay, /stats, /find, /addbal, /block, /unblock, /payments и /broadcast.

Почему бот отвечает с задержкой?

Сервер расположен в России, где доступ к серверам Telegram ограничен. Бот работает через шлюз: он проверяет все настроенные адреса одновременно, выбирает самый быстрый, поддерживает соединение открытым и мгновенно переключается на резервный при сбое. Сообщения, которые не удалось отправить, ставятся в очередь и доставляются после восстановления связи. Администратор задаёт адреса шлюзов в админ-панели на вкладке «Telegram-бот».

Как получать уведомления о статусе сервисов в Telegram?

Отправьте боту /subscribe или откройте ссылку со страницы статуса. Привязывать аккаунт для этого не нужно. Команда /status показывает текущее состояние сервисов, /unsubscribe отключает уведомления.

Бот не отвечает, что делать?

Бот работает через шлюз Cloudflare, поэтому отвечает даже при ограничении доступа к Telegram. Если ответа нет дольше минуты, проверьте состояние в админке на вкладке «Telegram-бот»: связь, активный шлюз и очередь сообщений. Неотправленные сообщения хранятся в очереди и доставляются автоматически после восстановления связи.

Проблемы с сайтами

Сертификат не выпускается
  • Проверьте, что сайт опубликован.
  • Убедитесь, что A-запись домена указывает на 104.143.201.179. Изменения DNS могут применяться до нескольких часов.
  • Удалите AAAA-записи, если они указывают на другой сервер.
  • Не отправляйте запросы чаще раза в минуту.
Форма выдаёт «Запрос отклонён»

Форму можно отправить только со страницы того же сайта. Проверьте, что вы открываете сайт по адресу собственного домена, а не из сохранённой копии страницы.

Письма из форм не приходят
  • Укажите почту для заявок в настройках сайта.
  • Проверьте папку «Спам».
  • Лимит отправки - 30 писем в час и 100 в сутки с одного сайта. Все заявки в любом случае сохраняются на вкладке «Данные форм».
Скрипт выдаёт ошибку 500

Проверьте синтаксис файла и версию PHP на вкладке «Версия PHP». Запрещённые функции (exec, system, shell_exec и подобные) приводят к ошибке. Время выполнения ограничено 15 секундами.

Библиотека не устанавливается

Проверьте имя пакета на packagist.org и свободное место на диске. Установка также прерывается, если пакет требует расширение PHP, которого нет на сервере.

Частые проблемы

Почта не приходит
  • Проверьте MX: должен указывать на mail.ht-c.ru
  • Убедитесь, что ящик активен
  • Проверьте папку «Спам»
  • Настройте SPF и DMARC
Письма уходят в спам
  1. Проверьте SPF: v=spf1 mx ~all
  2. Проверьте DKIM — должен быть активен
  3. Добавьте DMARC: v=DMARC1; p=none; rua=mailto:admin@домен
Поддомен не открывается
  1. Проверьте запись: dig @8.8.8.8 поддомен.ht-c.online
  2. Подождите TTL — до 5 минут
  3. Очистите кэш: ipconfig /flushdns
API возвращает 401
  • Токен передан в заголовке?
  • Токен не истёк?
  • Нет пробелов в начале/конце?
API возвращает 403

У токена нет нужного scope. Создайте новый с нужными правами в настройках.

API возвращает 429

Превышен лимит 60 запросов/минуту. Подождите минуту.

Поддержка
Авторизуйтесь, чтобы написать в поддержку.

Войти