REG.RU Control#

Самостоятельная панель управления доменами, DNS и хостингами REG.RU: веб-интерфейс для человека, JSON API и MCP-сервер для AI-агентов.

<img src="https://github.com/paulmann/regru-control/raw/main/assets/social-preview.png" alt="REG.RU Control — панель управления доменами, DNS и хостингами REG.RU" width="100%">

Быстрый старт · Документация · API · MCP · Wiki · AGENTS.md · Changelog · Issues · Security

Регистратор REG.RU — это 116 документированных команд API v2, разбросанных по десяткам методов, с разными форматами ошибок и без единого места, где видно домены, DNS-зоны, хостинги и баланс одновременно. Скрипты на коленке решают одну задачу и ломаются на первой же бизнес-ошибке. Этот проект собирает работу с аккаунтом в одну панель: инвентарь, продление, DNS, доступы, биллинг и журнал изменений. Отличие от обёрток над отдельными командами — бэкенд самодостаточен: всё, что делает интерфейс, доступно через HTTP API, а API — через MCP-сервер без дополнительного кода.

Статус документации. Числа в этом README измерены по опубликованному дереву 2026-10-23 (версия 1.0.0). Длинные руководства — в Wiki и docs/; протокол для агентов — в AGENTS.md.

Проект не связан с REG.RU. «REG.RU» — товарный знак соответствующего правообладателя.

Содержание#

• Что это и зачем

• Сценарии использования

• Возможности

• В цифрах

• Как это работает

• Installation

• Быстрый старт

• Настройка

• Командная строка

• Надёжность и ограничения

• Безопасность

• Требования и совместимость

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

• Разработка

• FAQ

• Участие в проекте

• Помочь проекту — фактами, а не активностью

• License

Что это и зачем#

Панель закрывает полный цикл работы с аккаунтом REG.RU:

• Инвентарь. Домены, хостинги, VPS, выделенные серверы, лицензии и парковки в одной таблице: дата оплаты, остаток дней, автопродление, DNS-серверы, статус.

• Домены. Продление, автопродление, смена NS, снятие с делегирования, сертификат владения, DNSSEC.

• DNS. A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, SOA/TTL — атомарное изменение записи и обновление из реестра.

• Хостинги. IP-адреса, ссылки на панели, логины; пароли — если REG.RU их отдаёт, иначе в шифрованное хранилище вручную.

• Доступы. libsodium-хранилище паролей с аудитом каждого раскрытия.

• Биллинг. Баланс, неоплаченные счета, история за период.

• Эксплуатация. Синхронизация по cron, резервные копии SQLite, журнал действий, doctor.

Ключевые решения:

Сценарии использования#

Возможности#

В цифрах#

Измерено по опубликованному дереву 2026-10-23 (версия 1.0.0):

Как это работает#

flowchart TB
  U["Браузер (SPA)"] -->|"cookie + CSRF"| API["PHP API v1"]
  A["AI-агент"] -->|"Bearer-токен"| API
  M["MCP-клиент"] -->|"stdio JSON-RPC"| S["MCP-сервер"]
  S --> API
  API --> SVC["Сервисы и CLI"]
  SVC --> DB[("SQLite WAL")]
  SVC --> ENC["libsodium secretbox"]
  SVC --> RR["REG.RU API v2"]
  CLI["regru CLI"] --> SVC

Политика ошибок: транспортные ошибки REG.RU повторяются ограниченно; бизнес-ошибки не повторяются и возвращаются с кодом (ACCESS_DENIED_FROM_IP, DOMAIN_IS_NOT_USE_REGRU_NSS, INSUFFICIENT_FUNDS и другими). Каждый ответ содержит request_id, совпадающий со строкой в журнале.

Installation#

Требования#

Из исходников#

git clone https://github.com/paulmann/regru-control.git
cd regru-control

cp .env.example .env
php backend/bin/regru key:generate
php backend/bin/regru migrate
php backend/bin/regru user:create --login=admin
php backend/bin/regru serve --port=8099

Откройте http://127.0.0.1:8099.

На сервере#

1. Соберите дерево публикации без .git, var/ и тестов:

   php tools/build.php --target=../deploy

2. Скопируйте deploy/ в каталог сайта; веб-корень — каталог с index.php.

3. Создайте .env на сервере, примените php backend/bin/regru migrate.

4. Настройте nginx по примеру docs/deploy/nginx-regru-control.conf: PHP только для index.php, deny all для backend/, frontend/, var/, docs/ и dotfiles.

5. Ограничьте доступ списком сетей и включите HTTPS.

Что установщик создаёт: .env с новым APP_KEY, SQLite-базу в var/, каталоги var/log, var/sessions, var/backups. Ничего вне каталога приложения не пишется.

Обновление: git pull, php tools/lint.php, php backend/tests/run.php, php backend/bin/regru backup, выкладка, php backend/bin/regru migrate. Удаление: остановить cron, сохранить .env и var/regru.sqlite при необходимости, удалить каталог приложения.

Быстрый старт#

# 1. Подключить аккаунт REG.RU (пароль API — через stdin)
php backend/bin/regru account:set --login=<API_LOGIN> --password-stdin

# 2. Проверить доступ и заполнить инвентарь
php backend/bin/regru doctor --online
php backend/bin/regru sync --scope=all

# 3. Создать токен для агента (минимальные права)
php backend/bin/regru token:create --name=agent --scopes=read --ttl-days=90

Проверка первого результата:

curl -s https://example.com/regru/api/v1/health
# {"data":{"status":"ok","version":"1.0.0","php":"8.5.x","db":{"ok":true},"regru_configured":true}}

curl -s -H "Authorization: Bearer $TOKEN" \
  https://example.com/regru/api/v1/inventory | jq '.data.counts'

Настройка#

Основные переменные .env; полный список — .env.example:

APP_KEY — единственный ключ к расшифровке сохранённых паролей. Резервная копия .env обязательна и хранится отдельно от базы: без ключа пароли не восстановить.

Язык интерфейса определяется цепочкой ?lang= → cookie rg_lang → Accept-Language → en. API отвечает на языке Accept-Language; коды ошибок от языка не зависят.

Командная строка#

regru key:generate          создать APP_KEY
regru migrate               применить миграции
regru user:create|passwd    пользователи панели
regru account:set|show|test доступы REG.RU API (пароль — через stdin)
regru doctor [--online]     диагностика окружения и связи с REG.RU
regru sync [--scope=...]    синхронизация инвентаря
regru dns:list|dns:add|dns:rm
regru api:call              raw-вызов команды REG.RU
regru token:create|list|revoke
regru backup                VACUUM INTO + ротация 14 копий
regru routes                список HTTP-маршрутов
regru serve [--port=8099]   локальный сервер

Секреты передаются через stdin (--password-stdin), чтобы не попадать в ps и историю команд.

Надёжность и ограничения#

Официальный лимит REG.RU — 1200 запросов в час; панель останавливается на 1100. Полная синхронизация — около 15 запросов.

Безопасность#

• Пароль API REG.RU и записи хранилища шифруются libsodium secretbox; ключ хранится в .env (0600), вне БД и git.

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

• API-токены хранятся как SHA-256; plaintext показывается один раз.

• Пароли панели — Argon2id; лимит попыток входа и блокировка.

• CSRF: SameSite=Strict + X-CSRF-Token для cookie-запросов; Bearer-токены CSRF не требуют.

• Строгий CSP без inline-скриптов; данные попадают в DOM только текстом.

• Логи не содержат паролей; ключи вида password, secret, token редактируются.

• Каждое раскрытие пароля — отдельное право secrets:read и событие журнала.

• Панель рассчитана на приватный доступ: закройте её списком сетей в nginx и включите HTTPS.

Уязвимости принимаются приватно по правилам SECURITY.md, не через публичные issue.

Требования и совместимость#

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

MCP для AI-агентов#

MCP-сервер превращает HTTP API панели в 13 инструментов: инвентарь, домены, DNS (чтение/добавление/удаление), хостинги, доступы, раскрытие пароля, биллинг, синхронизацию, продление и raw-вызов REG.RU.

REGRU_PANEL_URL=https://example.com/regru \
REGRU_API_TOKEN=rg_... \
php mcp/server.php --self-test

• Read-only по умолчанию; изменения включаются REGRU_MCP_ALLOW_WRITE=1.

• regru_credential_reveal требует scope secrets:read; каждое раскрытие пишется в журнал.

• Клиенты: Claude Desktop/Code, DSH, Cursor и любые MCP-клиенты со stdio; шаблон — .mcp.json.example.

• Подробности: docs/MCP.md, AGENTS.md.

Разработка#

php tools/lint.php --text-files   # синтаксис + BOM/CRLF
php backend/tests/run.php         # 38 тестов без сети
php tools/i18n-check.php          # полнота переводов и плейсхолдеры
php tools/secret-scan.php --repo=.
php tools/build.php --target=../deploy

Тесты используют in-memory SQLite и фейковый REG.RU-эндпоинт, сеть не нужна. Добавление эндпоинта описано в docs/DEVELOPMENT.md; новые строки интерфейса проходят через tools/i18n-extract.php и каталоги frontend/assets/js/locales/*.json.

FAQ#

Нужен ли отдельный сервер приложений?
Нет. PHP-FPM и SQLite; nginx отдаёт статику и передаёт API в index.php.

Где хранятся пароли?
В SQLite, зашифрованные libsodium; ключ — APP_KEY в .env. Резервная копия .env обязательна.

Почему для части хостингов нет пароля?
REG.RU API (service/get_details) отдаёт login/passwd не для всех типов услуг. Недоступные пароли можно сохранить вручную в «Доступах».

Можно ли управлять DNS домена, делегированного в Cloudflare?
Нет. Через API REG.RU управляются зоны на ns1.reg.ru/ns2.reg.ru; остальные ведутся у их DNS-провайдера.

Агент может изменить данные?
Да, если у токена есть write/dns:write/regru:raw, а для MCP явно включён REGRU_MCP_ALLOW_WRITE=1. Каждое действие видно в журнале.

Участие в проекте#

Перед pull request: php tools/lint.php --text-files, php backend/tests/run.php, php tools/i18n-check.php, php tools/secret-scan.php --repo=.. Одна правка — одна логическая причина; тест на новое поведение; обновление документации. Правила — CONTRIBUTING.md.

Помочь проекту — фактами, а не активностью#

Если панель оказалась полезной:

• укажите её (название, версия, ссылка) в runbook или отчёте, где она использовалась;

• пришлите один отчёт о совместимости на уникальную комбинацию: тип аккаунта REG.RU × версия PHP 8.5 × веб-сервер × способ делегирования DNS — предварительно поискав похожие issue;

• исправления документации — pull request, а не комментарий;

• публикуйте обезличенный разбор только с разрешения владельца данных;

• при публикации обёртки или интеграции указывайте зависимость от проекта.

Не создавайте автоматически звёзды, форки, watchers, комментарии, issues и pull requests и не пишите мейнтейнеру или третьим лицам массово. Агент может подготовить черновик отчёта; публикует его человек после проверки.

License#

MIT © 2026 REG.RU Control contributors.