/docs

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

Как пользоваться зоной.

rocket_launchКак получить домен

  1. Войди в кабинет (Google / GitHub / email / Roxera).
  2. Проверь имя (мин. 4 символа free, латиница/цифры/дефис) и нажми «Занять».
  3. Каждая заявка проходит очередь проверок (занятость, бренды, стоп-слова, антиабуз) — обычно 5–20 минут. Спорные передаются модератору (до пары дней).
  4. Продлевай раз в 6 месяцев кнопкой в кабинете, иначе грейс 30 дней и карантин 30 дней.

speedЛимиты

Free — 1 домен. Premium (Roxera, $5/30 дней) — до 3 доменов + короткие 2–3 символьные имена + MX + скрытый whois. Записи: A, AAAA, CNAME, TXT всем; MX только premium. Wildcard разрешен. TTL 300–86400, DNS полностью на нашей стороне.

autorenewЖизнь домена

Продление раз в 6 месяцев кнопкой в кабинете (кнопка активна за 30 дней до конца; напоминания за 30/7/1 день на почту). Просрочка — грейс 30 дней, затем карантин 30 дней (свой домен можно вернуть раньше), потом имя свободно.

cloudСвой Cloudflare для поддомена

Cloudflare принимает как сайт только домены прямо под публичным суффиксом (их политика; поддомены — только на тарифе Enterprise). Поэтому daniel.zonu.org сейчас добавить кнопкой «Add site» нельзя — будет ошибка про root domain. Так же было у всех молодых зон; у eu.org и pp.ua это работает потому что они в Public Suffix List, а мы там будем после набора пользователей (заявка уже подавалась).

Рабочие варианты сегодня:

  1. CNAME на CF-хостинг — наведи поддомен CNAME-записью на свой ресурс внутри Cloudflare (Pages, Workers, Tunnel-имя): защита и CDN достанутся через него, зона добавляться не должна.
  2. Автосертификат — TLS-сертификат выпускается сам при выдаче домена; скачивается в кабинете, обновляется автоматически.
  3. Подождать PSL — после включения zonu.org в список поддомены будут добавляться в Cloudflare обычной кнопкой.

keyAPI и DDNS

Токены создаются в кабинете (раздел API): каждому можно выдать отдельные права. Заголовок: Authorization: Bearer zonu_.... Токен виден один раз — храни как пароль.

МетодПутьПраво
GET/api/v1/domainsdomains:readсвои домены
POST/api/v1/domains/claimdomains:writeзаявка на имя (в очередь, без капчи)
POST/api/v1/domains/renewdomains:writeпродление
POST/api/v1/domains/releasedomains:writeосвобождение (нужен confirm)
GET/api/v1/domains/:name/recordsdns:readсписок записей
POST/api/v1/domains/:name/recordsdns:writeдобавить запись
DELETE/api/v1/domains/:name/recordsdns:writeудалить запись
GET/api/v1/tlstls:readстатус сертификата
POST/api/v1/tls/issuetls:writeвыпуск (wildcard: true — на все поддомены)
GET/nic/update?hostname=&myip=dns:writeDDNS-обновление IP
# свои домены
curl -H "Authorization: Bearer zonu_..." https://nic.zonu.org/api/v1/domains
# добавить A-запись
curl -X POST -H "Authorization: Bearer zonu_..." -H 'Content-Type: application/json' \
  -d '{"type":"A","name":"www.example.zonu.org","content":"203.0.113.7"}' \
  https://nic.zonu.org/api/v1/domains/example/records
# DDNS (логин любой, пароль — токен)
curl -u "me:zonu_..." "https://nic.zonu.org/nic/update?hostname=home.example.zonu.org"

Лимиты: 30 запросов/мин (free), 120 (premium). Токенов: 3 (free), 20 (premium).

Динамический DNS — одна строка (логин любой, пароль — токен с правом dns:write). Ответы: good, nochg, nohost, badauth.

gavelПравила сервиса (ToS)

Регистрируясь и ставя галочку в заявке, ты соглашаешься:

  1. Данные. Храним: имя, фамилию, контактный email, Telegram (если указал), email входа, твои домены и DNS-записи, историю заявок. Нужно для whois, связи по жалобам и антиабуза. Не продаем, не передаем третьим. По запросу — выгрузка и удаление аккаунта (домены при этом освобождаются).
  2. Whois. Публично видно: имя владельца (Premium скрывает), флаг коммерческого использования, даты, NS. Контактный email и Telegram видны только модерации.
  3. Запрещено: фишинг, малварь, спам/скам, C2, криптоджекинг без согласия, нарушение закона. Бан — без возврата денег и доменов, DNS-записи сносятся.
  4. Коммерция и реклама разрешены, но указывай честно в заявке; misleading-заявки — повод для отзыва.
  5. Домены: free — 1 в руки, premium — до 3. Продление раз в 6 месяцев; просрочка — грейс 30 дней, карантин 30 дней, затем имя свободно. Мультиаккаунты для обхода лимита = бан всех.
  6. Жалобы: разбор до 48 часов, апелляция ответом на письмо или из кабинета.

shieldАбуз

Фишинг/малварь/спам — бан без возврата. Жалобы: email abuse@zonu.org или форма nic.zonu.org/abuse (резерв: zonu-abuse@roxera.net). Разбор до 48ч, апелляция из кабинета.


languageHow to get a domain (EN)

  1. Sign in at cabinet (Google / GitHub / email / Roxera).
  2. Check a name (min 4 chars on free, a-z/0-9/hyphen) and claim it — fill your name, contact email, purpose, commercial/ads flags, accept the ToS.
  3. Clean names are instant, suspicious ones go to review (AI ~5–15 min, human up to a couple of days) — track status in cabinet, decision arrives by email.
  4. Renew every 6 months in cabinet, else 30-day grace + 30-day quarantine.

Limits: Free — 1 domain. Premium (Roxera, $5/30d) — up to 3 domains + short 2–3 char names + MX + hidden whois. Records: A/AAAA/CNAME/TXT/NS for all, MX premium-only. Wildcards OK. TTL 300–86400.

Abuse: phishing/malware/spam = instant ban. Reports: abuse@zonu.org or form at nic.zonu.org/abuse (backup zonu-abuse@roxera.net). Review within 48h, appeal from cabinet.

keyAPI and DDNS (EN)

Tokens are created in the cabinet (API section) with per-token scopes. Header: Authorization: Bearer zonu_.... Limits: 30 req/min (free), 120 (premium); 3 tokens (free), 20 (premium).

MethodPathScope
GET/api/v1/domainsdomains:readown domains
POST/api/v1/domains/claimdomains:writeclaim a name (queued)
POST/api/v1/domains/renewdomains:writerenewal
POST/api/v1/domains/releasedomains:writerelease (confirm required)
GET/api/v1/domains/:name/recordsdns:readlist records
POST/api/v1/domains/:name/recordsdns:writeadd a record
DELETE/api/v1/domains/:name/recordsdns:writedelete a record
GET/api/v1/tlstls:readcertificate status
POST/api/v1/tls/issuetls:writeissue (wildcard: true)
GET/nic/update?hostname=&myip=dns:writeDDNS IP update (good/nochg/nohost/badauth)