# REG.RU Control Wiki

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

[Репозиторий](https://github.com/paulmann/regru-control) · [Релизы](https://github.com/paulmann/regru-control/releases) · [Issues](https://github.com/paulmann/regru-control/issues) · [README](https://github.com/paulmann/regru-control/blob/main/README.md) · [AGENTS.md](https://github.com/paulmann/regru-control/blob/main/AGENTS.md)

## С чего начать

| Впервые знакомитесь | Уже эксплуатируете |
|---|---|
| [Зачем это нужно](01-Why-This-Exists) | [Справочник конфигурации](03-Configuration-Reference) |
| [Установка и первый запуск](02-Getting-Started) | [Эксплуатация](08-Operations) |
| [Архитектура](04-Architecture) | [Устранение неполадок](09-Troubleshooting) |

## Что делает панель

| Область | Возможности |
|---|---|
| Инвентарь | домены, хостинги, VPS, выделенные серверы, лицензии, парковки; даты оплаты, автопродление, NS, статусы |
| Домены | продление, автопродление, смена DNS-серверов, снятие с делегирования, сертификат владения, DNSSEC |
| DNS | A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, SOA/TTL; кэш и обновление из реестра |
| Хостинги | IP-адреса, панели, логины; пароли — если REG.RU их отдаёт, иначе в шифрованное хранилище |
| Доступы | libsodium-хранилище паролей с аудитом каждого раскрытия |
| Биллинг | баланс, неоплаченные счета, история |
| API / MCP | scoped Bearer-токены, OpenAPI, 13 MCP-инструментов, raw-вызов любой из 116 команд |
| Эксплуатация | cron-синхронизация, бэкапы SQLite, журнал, `doctor` |

## Карта вики

| Страница | Содержание |
|---|---|
| [01 · Зачем это нужно](01-Why-This-Exists) | проблема, решение, принципы, границы применимости |
| [02 · Установка](02-Getting-Started) | требования, локальный запуск, сервер, первый результат |
| [03 · Конфигурация](03-Configuration-Reference) | `.env`, аккаунт REG.RU, язык, cron, MCP |
| [04 · Архитектура](04-Architecture) | слои, данные, клиент API2, синхронизация, i18n |
| [05 · API](05-API) | аутентификация, scopes, эндпоинты, ошибки, лимиты |
| [06 · MCP](06-MCP) | инструменты, клиенты, безопасность, диагностика |
| [07 · Безопасность](07-Security) | шифрование, доступ, инциденты |
| [08 · Эксплуатация](08-Operations) | синхронизация, бэкапы, обновления, мониторинг |
| [09 · Неполадки](09-Troubleshooting) | коды REG.RU, панель, развёртывание, диагностика |
| [10 · Разработка](10-Development-and-Testing) | структура, тесты, добавление функций |
| [11 · FAQ](11-FAQ) | частые вопросы и ограничения |

## Коротко о проекте

- PHP 8.5, SQLite, ноль Composer/Node-зависимостей.
- 116 документированных команд REG.RU API v2.
- Шесть языков: `en` (по умолчанию), `ru`, `zh`, `hi`, `de`, `es`.
- 38 автотестов без сети; MCP-сервер с 13 инструментами.

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

Лицензия: [MIT](https://github.com/paulmann/regru-control/blob/main/LICENSE).