[{"data":1,"prerenderedAt":1030},["ShallowReactive",2],{"docs-navigation-ru":3,"i-lucide:search":95,"i-lucide:sun":100,"i-lucide:globe":102,"i-lucide:menu":104,"i-lucide:chevron-down":106,"i-lucide:github":108,"i-lucide:map-pin":111,"docs-headings-ru":113,"i-lucide:book-open":437,"i-lucide:download":439,"i-lucide:compass":441,"i-lucide:arrow-up-circle":443,"i-lucide:layers":445,"i-lucide:users":447,"i-lucide:plug":449,"i-lucide:circle-alert":451,"i-lucide:lock":453,"i-lucide:database":455,"i-lucide:folder-sync":457,"i-lucide:life-buoy":459,"i-lucide:shield-check":461,"i-lucide:archive-restore":463,"i-lucide:activity":465,"i-lucide:wrench":467,"docs-ru-/docs/recovery":469,"i-lucide:copy":1026,"i-lucide:link":1028},[4,27],{"section":5,"items":6},"Начало работы",[7,12,17,22],{"title":8,"path":9,"order":10,"icon":11},"Введение","/docs",1,"lucide:book-open",{"title":13,"path":14,"order":15,"icon":16},"Установка","/docs/installation",2,"lucide:download",{"title":18,"path":19,"order":20,"icon":21},"Как устроен интерфейс панели","/docs/panel-interface",2.5,"lucide:compass",{"title":23,"path":24,"order":25,"icon":26},"Обновление Maran","/docs/upgrade",2.7,"lucide:arrow-up-circle",{"section":28,"items":29},"Как это работает",[30,35,40,45,50,55,60,65,70,75,80,85,90],{"title":31,"path":32,"order":33,"icon":34},"Как это устроено","/docs/architecture",3,"lucide:layers",{"title":36,"path":37,"order":38,"icon":39},"Хостинг-аккаунты","/docs/accounts",4,"lucide:users",{"title":41,"path":42,"order":43,"icon":44},"Сайты и PHP","/docs/websites",5,"lucide:globe",{"title":46,"path":47,"order":48,"icon":49},"API провижининга","/docs/api",6,"lucide:plug",{"title":51,"path":52,"order":53,"icon":54},"Коды ошибок API","/docs/api-errors",6.5,"lucide:circle-alert",{"title":56,"path":57,"order":58,"icon":59},"SSL-сертификаты","/docs/ssl",7,"lucide:lock",{"title":61,"path":62,"order":63,"icon":64},"Базы данных","/docs/databases",8,"lucide:database",{"title":66,"path":67,"order":68,"icon":69},"Передача файлов и резервные копии","/docs/file-transfer",9,"lucide:folder-sync",{"title":71,"path":72,"order":73,"icon":74},"Восстановление и диагностика","/docs/recovery",10,"lucide:life-buoy",{"title":76,"path":77,"order":78,"icon":79},"Сертификат панели","/docs/panel-certificate",11,"lucide:shield-check",{"title":81,"path":82,"order":83,"icon":84},"Резервная копия и восстановление панели","/docs/panel-backup",12,"lucide:archive-restore",{"title":86,"path":87,"order":88,"icon":89},"Панель состояния и мониторинг","/docs/monitoring",13,"lucide:activity",{"title":91,"path":92,"order":93,"icon":94},"Устранение неполадок","/docs/troubleshooting",14,"lucide:wrench",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":99},0,24,false,"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"m21 21l-4.34-4.34\"/>\u003Ccircle cx=\"11\" cy=\"11\" r=\"8\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":101},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"/>\u003Cpath d=\"M12 2v2m0 16v2M4.93 4.93l1.41 1.41m11.32 11.32l1.41 1.41M2 12h2m16 0h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":103},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"M12 2a14.5 14.5 0 0 0 0 20a14.5 14.5 0 0 0 0-20M2 12h20\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":105},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":107},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":109,"hidden":110},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5c.08-1.25-.27-2.48-1-3.5c.28-1.15.28-2.35 0-3.5c0 0-1 0-3 1.5c-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.4 5.4 0 0 0 4 9c0 3.5 3 5.5 6 5.5c-.39.49-.68 1.05-.85 1.65S8.93 17.38 9 18v4\"/>\u003Cpath d=\"M9 18c-4.51 2-5-2-7-2\"/>\u003C/g>",true,{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":112},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0\"/>\u003Ccircle cx=\"12\" cy=\"10\" r=\"3\"/>\u003C/g>",{"/docs/accounts":114,"/docs/api":154,"/docs/api-errors":179,"/docs/architecture":192,"/docs/databases":208,"/docs/file-transfer":221,"/docs":240,"/docs/installation":253,"/docs/monitoring":269,"/docs/panel-backup":288,"/docs/panel-certificate":307,"/docs/panel-interface":324,"/docs/recovery":353,"/docs/ssl":378,"/docs/troubleshooting":389,"/docs/upgrade":402,"/docs/websites":418},[115,118,121,124,127,130,133,136,139,142,145,148,151],{"title":116,"anchor":117},"Что происходит при создании","что-происходит-при-создании",{"title":119,"anchor":120},"Форма нового аккаунта","форма-нового-аккаунта",{"title":122,"anchor":123},"Приостановка: состояние, а не удаление","приостановка-состояние-а-не-удаление",{"title":125,"anchor":126},"Удаление убирает то, что аккаунт оставил","удаление-убирает-то-что-аккаунт-оставил",{"title":128,"anchor":129},"Тарифы","тарифы",{"title":131,"anchor":132},"Функции тарифа","функции-тарифа",{"title":134,"anchor":135},"Командный доступ: пользователи","командный-доступ-пользователи",{"title":137,"anchor":138},"Больше одного аккаунта на вход","больше-одного-аккаунта-на-вход",{"title":140,"anchor":141},"Просмотр как аккаунт","просмотр-как-аккаунт",{"title":143,"anchor":144},"Лимиты ресурсов","лимиты-ресурсов",{"title":146,"anchor":147},"Запуск запланированной задачи сейчас","запуск-запланированной-задачи-сейчас",{"title":149,"anchor":150},"Что видит клиент","что-видит-клиент",{"title":152,"anchor":153},"Одно ограничение, о котором стоит знать","одно-ограничение-о-котором-стоит-знать",[155,158,161,164,167,170,173,176],{"title":156,"anchor":157},"Пока вход, а не ключ","пока-вход-а-не-ключ",{"title":159,"anchor":160},"Жизненный цикл аккаунта","жизненный-цикл-аккаунта",{"title":162,"anchor":163},"Функции тарифов, аккаунты и просмотры","функции-тарифов-аккаунты-и-просмотры",{"title":165,"anchor":166},"Ответы без тела","ответы-без-тела",{"title":168,"anchor":169},"Переименованные поля ответов","переименованные-поля-ответов",{"title":171,"anchor":172},"Чем это не является","чем-это-не-является",{"title":174,"anchor":175},"Ошибки говорят ровно то, что вызывающему позволено знать","ошибки-говорят-ровно-то-что-вызывающему-позволено-знать",{"title":177,"anchor":178},"Все коды ошибок","все-коды-ошибок",[180,183,186,189],{"title":181,"anchor":182},"Статус определяется видом ошибки","статус-определяется-видом-ошибки",{"title":184,"anchor":185},"Коды, которые стоит знать в первую очередь","коды-которые-стоит-знать-в-первую-очередь",{"title":187,"anchor":188},"Неудачная фоновая задача несёт те же коды","неудачная-фоновая-задача-несёт-те-же-коды",{"title":190,"anchor":191},"Все коды","все-коды",[193,196,199,202,205],{"title":194,"anchor":195},"Три процесса","три-процесса",{"title":197,"anchor":198},"Контракт между ними","контракт-между-ними",{"title":200,"anchor":201},"Запись конфигурационного файла","запись-конфигурационного-файла",{"title":203,"anchor":204},"Изоляция между аккаунтами","изоляция-между-аккаунтами",{"title":206,"anchor":207},"Чего сознательно нет","чего-сознательно-нет",[209,212,215,218],{"title":210,"anchor":211},"Изоляция строится, а не предполагается","изоляция-строится-а-не-предполагается",{"title":213,"anchor":214},"Пароль показывается один раз","пароль-показывается-один-раз",{"title":216,"anchor":217},"Удаление окончательно","удаление-окончательно",{"title":219,"anchor":220},"Починка грантов для хостов, работавших на старой сборке","починка-грантов-для-хостов-работавших-на-старой-сборке",[222,225,228,231,234,237],{"title":223,"anchor":224},"Каждый вход заперт, и jail настоящий","каждый-вход-заперт-и-jail-настоящий",{"title":226,"anchor":227},"Сброс или удаление входа завершает его открытые сеансы","сброс-или-удаление-входа-завершает-его-открытые-сеансы",{"title":229,"anchor":230},"Открытые ключи лежат вне jail","открытые-ключи-лежат-вне-jail",{"title":232,"anchor":233},"FTPS поставляется установленным и выключенным","ftps-поставляется-установленным-и-выключенным",{"title":235,"anchor":236},"Резервные копии","резервные-копии",{"title":238,"anchor":239},"Что ничто не перепроверяет","что-ничто-не-перепроверяет",[241,244,247,250],{"title":242,"anchor":243},"Три процесса, и root есть только у одного","три-процесса-и-root-есть-только-у-одного",{"title":245,"anchor":246},"Что такое аккаунт хостинга","что-такое-аккаунт-хостинга",{"title":248,"anchor":249},"Ни брокеров, ни сайдкаров","ни-брокеров-ни-сайдкаров",{"title":251,"anchor":252},"Клавиатура, экранные дикторы и анимация","клавиатура-экранные-дикторы-и-анимация",[254,257,260,263,266],{"title":255,"anchor":256},"Запустить установщик","запустить-установщик",{"title":258,"anchor":259},"Установка без доступа в интернет","установка-без-доступа-в-интернет",{"title":261,"anchor":262},"Первый администратор","первый-администратор",{"title":264,"anchor":265},"После первого входа","после-первого-входа",{"title":267,"anchor":268},"Обновления","обновления",[270,273,276,279,282,285],{"title":271,"anchor":272},"Что показывает стартовая страница","что-показывает-стартовая-страница",{"title":274,"anchor":275},"Часть, которую не удалось прочитать, говорит об этом","часть-которую-не-удалось-прочитать-говорит-об-этом",{"title":277,"anchor":278},"Диск: занято, зарезервировано, доступно","диск-занято-зарезервировано-доступно",{"title":280,"anchor":281},"Использование диска по аккаунтам","использование-диска-по-аккаунтам",{"title":283,"anchor":284},"Оповещения приходят оператору по почте","оповещения-приходят-оператору-по-почте",{"title":286,"anchor":287},"Уровень журнала панели","уровень-журнала-панели",[289,292,295,298,301,304],{"title":290,"anchor":291},"Файл с парольной фразой","файл-с-парольной-фразой",{"title":293,"anchor":294},"Сделать резервную копию","сделать-резервную-копию",{"title":296,"anchor":297},"Что внутри архива","что-внутри-архива",{"title":299,"anchor":300},"Восстановить на чистом сервере","восстановить-на-чистом-сервере",{"title":302,"anchor":303},"Расписание, хранение нескольких копий и копия вне сервера","расписание-хранение-нескольких-копий-и-копия-вне-сервера",{"title":305,"anchor":306},"Ограничения","ограничения",[308,311,314,317,320,323],{"title":309,"anchor":310},"Заказать сертификат","заказать-сертификат",{"title":312,"anchor":313},"Имя хоста берётся с сервера","имя-хоста-берётся-с-сервера",{"title":315,"anchor":316},"Блок проверки на порту 80","блок-проверки-на-порту-80",{"title":318,"anchor":319},"Продление","продление",{"title":321,"anchor":322},"Если выпуск не удался","если-выпуск-не-удался",{"title":305,"anchor":306},[325,328,331,334,337,340,343,344,347,350],{"title":326,"anchor":327},"Боковое меню и навигационная цепочка","боковое-меню-и-навигационная-цепочка",{"title":329,"anchor":330},"Светлая, тёмная или системная тема","светлая-тёмная-или-системная-тема",{"title":332,"anchor":333},"Избранное","избранное",{"title":335,"anchor":336},"Выбор сервера","выбор-сервера",{"title":338,"anchor":339},"Переключение между аккаунтами","переключение-между-аккаунтами",{"title":341,"anchor":342},"Значок внимания","значок-внимания",{"title":140,"anchor":141},{"title":345,"anchor":346},"Списки: поиск, фильтры и страницы","списки-поиск-фильтры-и-страницы",{"title":348,"anchor":349},"Таблицы на телефоне","таблицы-на-телефоне",{"title":351,"anchor":352},"Фоновые задачи и их прогресс","фоновые-задачи-и-их-прогресс",[354,357,360,363,366,369,372,375],{"title":355,"anchor":356},"Запуск от root","запуск-от-root",{"title":358,"anchor":359},"Сбросить пароль администратора","сбросить-пароль-администратора",{"title":361,"anchor":362},"Если правильные коды двухфакторной аутентификации не принимаются","если-правильные-коды-двухфакторной-аутентификации-не-принимаются",{"title":364,"anchor":365},"Сменить собственный пароль","сменить-собственный-пароль",{"title":367,"anchor":368},"Проверить состояние сервера","проверить-состояние-сервера",{"title":370,"anchor":371},"Нижний предел свободного места","нижний-предел-свободного-места",{"title":373,"anchor":374},"Собрать архив для поддержки","собрать-архив-для-поддержки",{"title":376,"anchor":377},"Читать журналы и менять их подробность","читать-журналы-и-менять-их-подробность",[379,382,383,386],{"title":380,"anchor":381},"Куда попадает приватный ключ","куда-попадает-приватный-ключ",{"title":318,"anchor":319},{"title":384,"anchor":385},"Чего этот клиент не делал","чего-этот-клиент-не-делал",{"title":387,"anchor":388},"Ограничения, о которых стоит знать","ограничения-о-которых-стоит-знать",[390,393,396,399],{"title":391,"anchor":392},"Панель не запускается","панель-не-запускается",{"title":394,"anchor":395},"Сайт отвечает 502 или 404","сайт-отвечает-502-или-404",{"title":397,"anchor":398},"Сертификат не выпускается","сертификат-не-выпускается",{"title":400,"anchor":401},"Агент недоступен","агент-недоступен",[403,406,409,412,415],{"title":404,"anchor":405},"1. Сначала сделайте резервную копию панели","_1-сначала-сделайте-резервную-копию-панели",{"title":407,"anchor":408},"2. Запустите установщик ещё раз","_2-запустите-установщик-ещё-раз",{"title":410,"anchor":411},"Что установщик сохраняет, а что меняет","что-установщик-сохраняет-а-что-меняет",{"title":413,"anchor":414},"3. Проверьте результат","_3-проверьте-результат",{"title":416,"anchor":417},"Если обновление не удалось","если-обновление-не-удалось",[419,422,425,428,431,434],{"title":420,"anchor":421},"Конфигурацию проверяет сам сервер","конфигурацию-проверяет-сам-сервер",{"title":423,"anchor":424},"Значения проверяются, а не экранируются","значения-проверяются-а-не-экранируются",{"title":426,"anchor":427},"Псевдонимы","псевдонимы",{"title":429,"anchor":430},"Закрытые наборы выбирают, а не вводят","закрытые-наборы-выбирают-а-не-вводят",{"title":432,"anchor":433},"Несколько версий PHP одновременно","несколько-версий-php-одновременно",{"title":435,"anchor":436},"Логи","логи",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":438},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 5v16m8.001-2A2 2 0 0 0 22 17V5a2 2 0 0 0-1.999-2L16 3.002A5 5 0 0 0 12 5a5 5 0 0 0-4-2H4a2 2 0 0 0-2 2v12a2 2 0 0 0 1.999 2H8a5 5 0 0 1 4 2a5 5 0 0 1 4-2z\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":440},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12 15V3m9 12v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4\"/>\u003Cpath d=\"m7 10l5 5l5-5\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":442},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"m16.24 7.76l-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":444},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"m16 12l-4-4l-4 4m4 4V8\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":446},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z\"/>\u003Cpath d=\"M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12\"/>\u003Cpath d=\"M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":448},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2M16 3.128a4 4 0 0 1 0 7.744M22 21v-2a4 4 0 0 0-3-3.87\"/>\u003Ccircle cx=\"9\" cy=\"7\" r=\"4\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":450},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 22v-5m3-9V2m2 6a1 1 0 0 1 1 1v4a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1zM9 8V2\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":452},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"M12 8v4m0 4h.01\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":454},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"18\" height=\"11\" x=\"3\" y=\"11\" rx=\"2\" ry=\"2\"/>\u003Cpath d=\"M7 11V7a5 5 0 0 1 10 0v4\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":456},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cellipse cx=\"12\" cy=\"5\" rx=\"9\" ry=\"3\"/>\u003Cpath d=\"M3 5v14a9 3 0 0 0 18 0V5\"/>\u003Cpath d=\"M3 12a9 3 0 0 0 18 0\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":458},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M9 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v.5\"/>\u003Cpath d=\"M12 10v4h4\"/>\u003Cpath d=\"m12 14l1.535-1.605a5 5 0 0 1 8 1.5M22 22v-4h-4\"/>\u003Cpath d=\"m22 18l-1.535 1.605a5 5 0 0 1-8-1.5\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":460},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"m4.93 4.93l4.24 4.24m5.66 0l4.24-4.24m-4.24 9.9l4.24 4.24m-9.9-4.24l-4.24 4.24\"/>\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":462},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z\"/>\u003Cpath d=\"m9 12l2 2l4-4\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":464},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"20\" height=\"5\" x=\"2\" y=\"3\" rx=\"1\"/>\u003Cpath d=\"M4 8v11a2 2 0 0 0 2 2h2M20 8v11a2 2 0 0 1-2 2h-2m-7-6l3-3l3 3m-3-3v9\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":466},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":468},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z\"/>",{"doc":470,"isFallback":98},{"id":471,"title":71,"body":472,"description":1017,"extension":1018,"icon":74,"meta":1019,"navigation":110,"order":73,"path":1020,"rawbody":1021,"section":28,"seo":1022,"seoTitle":1023,"stem":1024,"__hash__":1025},"docsRu/ru/docs/recovery.md",{"type":473,"value":474,"toc":1003},"minimark",[475,484,534,537,548,571,574,576,593,596,629,636,647,650,655,675,678,680,683,686,735,738,740,766,790,799,801,813,816,818,824,842,849,852,866,873,876,880,883,885,899,917,922,951,960,963,969,971,990,999],[476,477,478,479,483],"p",{},"Команда ",[480,481,482],"code",{},"maran"," нужна на тот случай, когда вход в саму панель недоступен. Она ставится вместе с\nпанелью, не добавляет ни службы, ни порта, ни сетевых запросов и работает только из оболочки на самом\nсервере.",[485,486,487,500],"table",{},[488,489,490],"thead",{},[491,492,493,497],"tr",{},[494,495,496],"th",{},"Команда",[494,498,499],{},"Когда использовать",[501,502,503,514,524],"tbody",{},[491,504,505,511],{},[506,507,508],"td",{},[480,509,510],{},"maran admin-reset-password",[506,512,513],{},"Администратор потерял пароль или аутентификатор, а панель не может отправить письмо для сброса.",[491,515,516,521],{},[506,517,518],{},[480,519,520],{},"maran status",[506,522,523],{},"Нужно узнать, какие службы работают и что панель сообщает о себе, даже если сама панель не отвечает.",[491,525,526,531],{},[506,527,528],{},[480,529,530],{},"maran collect-diagnostics",[506,532,533],{},"Нужно передать архив для поддержки тому, кто помогает вам разобраться.",[535,536,355],"h2",{"id":356},[476,538,539,540,543,544,547],{},"Команда доступна только root намеренно: она умеет выдать доступ к учётной записи администратора.\nЗапускайте её по полному пути, чтобы она работала при любом ",[480,541,542],{},"PATH",", который сохраняет ваш ",[480,545,546],{},"sudo",":",[549,550,555],"pre",{"className":551,"code":552,"language":553,"meta":554,"style":554},"language-bash shiki shiki-themes github-light-high-contrast github-dark-high-contrast","sudo /usr/local/sbin/maran status\n","bash","",[480,556,557],{"__ignoreMap":554},[558,559,561,564,568],"span",{"class":560,"line":10},"line",[558,562,546],{"class":563},"soyes",[558,565,567],{"class":566},"sT6z2"," /usr/local/sbin/maran",[558,569,570],{"class":566}," status\n",[476,572,573],{},"Пользователь без прав root получает одну строку с отказом и больше ничего.",[535,575,358],{"id":359},[549,577,579],{"className":551,"code":578,"language":553,"meta":554,"style":554},"sudo /usr/local/sbin/maran admin-reset-password admin@example.com\n",[480,580,581],{"__ignoreMap":554},[558,582,583,585,587,590],{"class":560,"line":10},[558,584,546],{"class":563},[558,586,567],{"class":566},[558,588,589],{"class":566}," admin-reset-password",[558,591,592],{"class":566}," admin@example.com\n",[476,594,595],{},"Укажите адрес электронной почты или имя пользователя администратора. Дальше команда:",[597,598,599,603,606,609],"ol",{},[600,601,602],"li",{},"Принимает только администратора с активным входом. Клиент, приостановленный администратор или\nприглашённый, но не принявший приглашение, получают понятный отказ; у клиентской зоны есть свой сброс\nпо почте.",[600,604,605],{},"Отменяет ранее выданные ссылки для сброса, так что действующая ссылка всегда одна.",[600,607,608],{},"Снимает блокировку после неудачных входов и завершает все сеансы учётной записи.",[600,610,611,612,616,617,620,621,624,625,628],{},"Показывает ссылку для сброса ",[613,614,615],"strong",{},"один раз, в вашем терминале",". Она действует ",[613,618,619],{},"один час"," и срабатывает\n",[613,622,623],{},"один раз",". Она не попадает ни в журналы, ни в запись аудита, а вывод в канал или файл команда\nотклоняет, если вы не добавили ",[480,626,627],{},"--allow-non-terminal",".",[476,630,631,632,635],{},"Откройте ссылку в браузере и задайте новый пароль. Если у панели не настроен публичный адрес, команда\nвыведет путь, начинающийся с ",[480,633,634],{},"/",", и сообщит об этом; допишите перед ним адрес вашей панели.",[476,637,638,639,642,643,646],{},"Каждое использование фиксируется в журнале аудита панели и в журнале аутентификации сервера\n(",[480,640,641],{},"authpriv",") с указанием учётной записи и того, была ли снята двухфакторная защита. Имя оператора берётся\nиз ",[480,644,645],{},"SUDO_USER"," и является заявленным, а не подтверждённым.",[476,648,649],{},"Если администраторов нет вовсе, команда сообщает об этом и отправляет вас на страницу первичной\nнастройки вместо того, чтобы создать администратора.",[651,652,654],"h3",{"id":653},"если-потерян-ещё-и-аутентификатор","Если потерян ещё и аутентификатор",[549,656,658],{"className":551,"code":657,"language":553,"meta":554,"style":554},"sudo /usr/local/sbin/maran admin-reset-password admin@example.com --clear-two-factor\n",[480,659,660],{"__ignoreMap":554},[558,661,662,664,666,668,671],{"class":560,"line":10},[558,663,546],{"class":563},[558,665,567],{"class":566},[558,667,589],{"class":566},[558,669,670],{"class":566}," admin@example.com",[558,672,674],{"class":673},"s-5SL"," --clear-two-factor\n",[476,676,677],{},"Так дополнительно удаляется двухфакторная привязка администратора, и при следующем входе хватит нового\nпароля. Применяйте это, только если аутентификатор действительно потерян: защита учётной записи снижается,\nпока администратор не подключит его заново, поэтому сразу после входа включите двухфакторную защиту снова.\nБез этого флага двухфакторная защита не затрагивается никогда.",[535,679,361],{"id":362},[476,681,682],{},"Коды аутентификатора вычисляются по времени, поэтому сервер, у которого ушли часы, отклоняет любой\nправильный код. Панель следит за часами: если последняя проверка нашла, что часы не синхронизированы с\nисточником времени, отклонённый код сообщает об этом («Часы сервера не синхронизированы…»), а не\nтолько «Код неверен». На главной странице в разделе «Требует внимания» появляется «Часы сервера не\nсинхронизированы», на странице «Мониторинг» видна карточка «Часы» с причиной, а оператор получает письмо,\nкогда часы остаются несинхронизированными десять проверок подряд, и ещё одно, когда они восстановятся.",[476,684,685],{},"Сама панель время не меняет. Включите службу синхронизации времени и дайте ей связаться с сервером\nвремени:",[549,687,689],{"className":551,"code":688,"language":553,"meta":554,"style":554},"sudo timedatectl set-ntp true             # Debian и Ubuntu: systemd-timesyncd\nsudo systemctl enable --now chronyd       # AlmaLinux и Rocky Linux: chrony\ntimedatectl                               # ищите «System clock synchronized: yes»\n",[480,690,691,708,727],{"__ignoreMap":554},[558,692,693,695,698,701,704],{"class":560,"line":10},[558,694,546],{"class":563},[558,696,697],{"class":566}," timedatectl",[558,699,700],{"class":566}," set-ntp",[558,702,703],{"class":673}," true",[558,705,707],{"class":706},"sLBg1","             # Debian и Ubuntu: systemd-timesyncd\n",[558,709,710,712,715,718,721,724],{"class":560,"line":15},[558,711,546],{"class":563},[558,713,714],{"class":566}," systemctl",[558,716,717],{"class":566}," enable",[558,719,720],{"class":673}," --now",[558,722,723],{"class":566}," chronyd",[558,725,726],{"class":706},"       # AlmaLinux и Rocky Linux: chrony\n",[558,728,729,732],{"class":560,"line":33},[558,730,731],{"class":563},"timedatectl",[558,733,734],{"class":706},"                               # ищите «System clock synchronized: yes»\n",[476,736,737],{},"Панель читает собственный вердикт ядра, а ядро перестаёт считать часы синхронизированными, когда его\nоценка возможной ошибки превышает шестнадцать секунд. Часы, ушедшие на несколько секунд, которые ядро\nещё считает синхронизированными, не отмечаются.",[535,739,364],{"id":365},[476,741,742,743,746,747,750,751,754,755,758,759,762,763,628],{},"Любой, кто вошёл в панель (администратор или клиент), может сменить свой пароль без ссылки сброса\nпо почте. Откройте меню под своим именем, выберите ",[613,744,745],{},"Профиль и защита"," и воспользуйтесь карточкой\n",[613,748,749],{},"Пароль",": ",[613,752,753],{},"Текущий пароль",", ",[613,756,757],{},"Новый пароль"," и ",[613,760,761],{},"Подтверждение пароля",", затем\n",[613,764,765],{},"Сменить пароль",[767,768,769,780,787],"ul",{},[600,770,771,772,779],{},"Новый пароль должен быть не короче минимума, который политика безопасности задаёт для сброса и\nприглашений; более короткий отклоняется. Сообщение сейчас всегда называет 12 символов, каким бы ни\nбыл минимум политики (",[773,774,778],"a",{"href":775,"rel":776},"https://github.com/innovayse/maran/issues/300",[777],"nofollow","задача #300",").",[600,781,782,783,786],{},"Неверный текущий пароль отклоняется с 400 ",[480,784,785],{},"CurrentPasswordIncorrect"," и сообщением «Текущий пароль указан\nневерно.» Попытка засчитывается в блокировку учётной записи точно так же, как неудачный вход, а\nпока учётная запись заблокирована, любая попытка получает тот же ответ.",[600,788,789],{},"При успехе панель сообщает «Пароль изменён. Все остальные устройства отключены.» Устройство, на\nкотором вы сменили пароль, остаётся в системе; все остальные сеансы завершаются.",[476,791,792,793,796,797,628],{},"Эндпоинт ",[480,794,795],{},"POST /api/v1/auth/change-password"," разделяет ограничение частоты со входом. Каждая\nсмена и каждый отказ записываются в журнал аудита как «Пароль изменён», без какого-либо из паролей.\nОстальные коды ошибок перечислены в разделе ",[773,798,51],{"href":52},[535,800,367],{"id":368},[549,802,803],{"className":551,"code":552,"language":553,"meta":554,"style":554},[480,804,805],{"__ignoreMap":554},[558,806,807,809,811],{"class":560,"line":10},[558,808,546],{"class":563},[558,810,567],{"class":566},[558,812,570],{"class":566},[476,814,815],{},"В первом разделе видно, активны и включены ли панель, агент, PostgreSQL и веб-сервер (передача файлов\nдобавляется, когда администратор её включил). Второй раздел содержит собственный отчёт панели: доступность базы\nданных, связь с агентом, ожидающие миграции, версия, число администраторов и открыто ли ещё окно первичной\nнастройки. Второй раздел может не сработать, не скрыв первый. Код возврата 0 означает, что всё в порядке,\nиначе 1. Секретов команда не выводит.",[535,817,370],{"id":371},[476,819,820,821,547],{},"Агент держит нижний предел свободного места: сколько MiB должно оставаться доступным в файловой\nсистеме, прежде чем он начнёт работу, которая туда пишет. Это 1 ГиБ, если вы не изменили значение\nв ",[480,822,823],{},"/etc/maran/agent.env",[549,825,827],{"className":551,"code":826,"language":553,"meta":554,"style":554},"MARAN_AGENT_FREE_SPACE_FLOOR_MIB=1024\n",[480,828,829],{"__ignoreMap":554},[558,830,831,835,839],{"class":560,"line":10},[558,832,834],{"class":833},"suds8","MARAN_AGENT_FREE_SPACE_FLOOR_MIB",[558,836,838],{"class":837},"sHUrx","=",[558,840,841],{"class":566},"1024\n",[476,843,844,845,848],{},"Установщик записывает 1024 и сохраняет ваше значение при повторном запуске. Юнит передаёт его\nагенту как ",[480,846,847],{},"--free-space-floor-mib","; без флага агент применяет те же 1024. Значение должно быть\nцелым числом от 1. С нулём или любым другим значением агент не запустится: нечитаемый предел нельзя\nпринимать за нулевой. Изменить его может только root; ничто из того, что отправляет панель, предел не несёт.",[476,850,851],{},"Пока в файловой системе, куда операция будет писать, доступно меньше предела, следующие операции\nотклоняются до того, как что-либо записано:",[767,853,854,857,860,863],{},[600,855,856],{},"создание аккаунта,",[600,858,859],{},"создание резервной копии,",[600,861,862],{},"восстановление резервной копии,",[600,864,865],{},"приём загрузки.",[476,867,868,869,872],{},"Отказ возвращается как ошибка ",[480,870,871],{},"AgentBelowFreeSpaceFloor"," (HTTP 503). В ответе и в причине сбоя\nзадачи резервного копирования или восстановления она читается на вашем языке как «На сервере почти\nзакончилось место на диске…». Файловая система, которую не удалось измерить, тоже отклоняется, а\nне пропускается. Приостановка, удаление и любое чтение продолжают работать, так что место можно\nосвободить из панели.",[476,874,875],{},"Предел проверяется перед началом работы, а не резервируется: другой процесс всё ещё может заполнить\nдиск после проверки, и пути записи сохраняют для этого случая собственную обработку по принципу\n«всё или ничего».",[651,877,879],{"id":878},"предупреждение-о-приближении-к-пределу","Предупреждение о приближении к пределу",[476,881,882],{},"Панель отправляет оператору письмо, когда в корневой файловой системе десять проверок подряд\nдоступно меньше двух пределов, так что предупреждение приходит до начала отказов. Второе письмо\nсообщает, когда свободного места снова достаточно. Если домашние каталоги аккаунтов лежат в\nотдельной файловой системе, отказ по-прежнему следует за ней, но предупреждение ему не предшествует:\nоно следит только за корневой файловой системой.",[535,884,373],{"id":374},[549,886,888],{"className":551,"code":887,"language":553,"meta":554,"style":554},"sudo /usr/local/sbin/maran collect-diagnostics\n",[480,889,890],{"__ignoreMap":554},[558,891,892,894,896],{"class":560,"line":10},[558,893,546],{"class":563},[558,895,567],{"class":566},[558,897,898],{"class":566}," collect-diagnostics\n",[476,900,901,902,905,906,909,910,913,914,628],{},"Команда записывает ",[480,903,904],{},"maran-diagnostics-\u003Cвремя>-\u003Cномер>.tar.gz"," в ",[480,907,908],{},"/root",", читаемый только для root. Другой\nкаталог задаётся через ",[480,911,912],{},"--out DIR"," (абсолютный путь, принадлежащий root и недоступный другим на запись), а\nжурналы можно исключить флагом ",[480,915,916],{},"--no-logs",[476,918,919],{},[613,920,921],{},"Что входит в архив:",[767,923,924,930,933,936,939,942,945],{},[600,925,926,927,929],{},"отчёт о службах из ",[480,928,520],{},", включая сведения о базе данных и миграциях;",[600,931,932],{},"версия операционной системы, юниты systemd панели и состояние её служб;",[600,934,935],{},"два конфигурационных файла Maran для веб-сервера;",[600,937,938],{},"ИМЕНА настроек панели, но не их значения;",[600,940,941],{},"субъект, издатель и срок действия сертификата панели;",[600,943,944],{},"правила межсетевого экрана;",[600,946,947,948,950],{},"если нет ",[480,949,916],{},", журнал панели, агента и веб-сервера за последние семь дней (с ограничением размера)\nи конец собственных журналов панели верхнего уровня.",[476,952,953,956,957,628],{},[613,954,955],{},"Что команда никогда не читает:"," файлы и домашние каталоги клиентов, журналы самих сайтов, резервные\nкопии, дампы баз данных, закрытые ключи и значения из ",[480,958,959],{},"panel.env",[476,961,962],{},"Из каждого текста удаляются известные секреты и типичные формы секретов, затем готовый архив\nраспаковывается и проверяется ещё раз. Если проверка что-то находит, архив удаляется, а команда завершается\nс ошибкой, а не оставляет пакет, который вы могли бы отправить.",[476,964,965,968],{},[613,966,967],{},"Просмотрите архив перед отправкой."," Очистка убирает то, что этот сервер заведомо хранит, но её полноту\nдоказать нельзя. IP-адреса, имена хостов и доменные имена клиентов не удаляются. Распакуйте архив,\nпрочитайте его и отправляйте только тем, кому доверяете такие сведения.",[535,970,376],{"id":377},[476,972,973,974,977,978,981,982,985,986,989],{},"Панель и агент сервера пишут в журнал systemd: читайте их командами ",[480,975,976],{},"journalctl -u maran-api"," и\n",[480,979,980],{},"journalctl -u maran-agent",". Их размер ограничивает journald. Файлы в ",[480,983,984],{},"/var/log/maran"," ротируются\nправилами, которые установщик кладёт в ",[480,987,988],{},"/etc/logrotate.d/",": журнал установки ротируется раз в месяц (хранятся\nдвенадцать), журналы веб-сервера самой панели ежедневно (тридцать), журналы веб-сервера сайтов\nежедневно (четырнадцать), журнал FTPS раз в неделю (четыре). На уже установленном сервере\nзапустите установщик повторно, чтобы получить правило для журнала установки.",[476,991,992,995,996,998],{},[613,993,994],{},"Меняйте уровень журнала панели без перезапуска."," Мониторинг → ",[613,997,286],{},"\nпоказывает, с каким уровнем панель пишет журнал, и позволяет администратору выбрать: подробный,\nотладка, информация (обычный уровень), предупреждение, ошибка или критический. Изменение действует\nсо следующей строки, сохраняется после перезапуска и записывается в журнал аудита с прежним и новым\nуровнем. Повышайте его на время разбора проблемы, затем верните обратно. Ни один уровень не заставит\nпанель записать пароль, ключ или токен. Уровень журнала самого агента сервера так пока изменить\nнельзя.",[1000,1001,1002],"style",{},"html pre.shiki code .soyes, html code.shiki .soyes{--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .sT6z2, html code.shiki .sT6z2{--shiki-default:#032563;--shiki-dark:#ADDCFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s-5SL, html code.shiki .s-5SL{--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .sLBg1, html code.shiki .sLBg1{--shiki-default:#66707B;--shiki-dark:#BDC4CC}html pre.shiki code .suds8, html code.shiki .suds8{--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .sHUrx, html code.shiki .sHUrx{--shiki-default:#A0111F;--shiki-dark:#FF9492}",{"title":554,"searchDepth":15,"depth":15,"links":1004},[1005,1006,1009,1010,1011,1012,1015,1016],{"id":356,"depth":15,"text":355},{"id":359,"depth":15,"text":358,"children":1007},[1008],{"id":653,"depth":33,"text":654},{"id":362,"depth":15,"text":361},{"id":365,"depth":15,"text":364},{"id":368,"depth":15,"text":367},{"id":371,"depth":15,"text":370,"children":1013},[1014],{"id":878,"depth":33,"text":879},{"id":374,"depth":15,"text":373},{"id":377,"depth":15,"text":376},"Как вернуть доступ к панели при потере пароля или аутентификатора администратора, проверить состояние сервера и собрать архив для поддержки.","md",{},"/ru/docs/recovery","---\ntitle: Восстановление и диагностика\ndescription: Как вернуть доступ к панели при потере пароля или аутентификатора администратора, проверить состояние сервера и собрать архив для поддержки.\nseoTitle: 'Восстановление доступа и сбор диагностики Maran'\nsection: Как это работает\norder: 10\nicon: lucide:life-buoy\n---\n\nКоманда `maran` нужна на тот случай, когда вход в саму панель недоступен. Она ставится вместе с\nпанелью, не добавляет ни службы, ни порта, ни сетевых запросов и работает только из оболочки на самом\nсервере.\n\n| Команда | Когда использовать |\n|---|---|\n| `maran admin-reset-password` | Администратор потерял пароль или аутентификатор, а панель не может отправить письмо для сброса. |\n| `maran status` | Нужно узнать, какие службы работают и что панель сообщает о себе, даже если сама панель не отвечает. |\n| `maran collect-diagnostics` | Нужно передать архив для поддержки тому, кто помогает вам разобраться. |\n\n## Запуск от root\n\nКоманда доступна только root намеренно: она умеет выдать доступ к учётной записи администратора.\nЗапускайте её по полному пути, чтобы она работала при любом `PATH`, который сохраняет ваш `sudo`:\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nПользователь без прав root получает одну строку с отказом и больше ничего.\n\n## Сбросить пароль администратора\n\n```bash\nsudo /usr/local/sbin/maran admin-reset-password admin@example.com\n```\n\nУкажите адрес электронной почты или имя пользователя администратора. Дальше команда:\n\n1. Принимает только администратора с активным входом. Клиент, приостановленный администратор или\n   приглашённый, но не принявший приглашение, получают понятный отказ; у клиентской зоны есть свой сброс\n   по почте.\n2. Отменяет ранее выданные ссылки для сброса, так что действующая ссылка всегда одна.\n3. Снимает блокировку после неудачных входов и завершает все сеансы учётной записи.\n4. Показывает ссылку для сброса **один раз, в вашем терминале**. Она действует **один час** и срабатывает\n   **один раз**. Она не попадает ни в журналы, ни в запись аудита, а вывод в канал или файл команда\n   отклоняет, если вы не добавили `--allow-non-terminal`.\n\nОткройте ссылку в браузере и задайте новый пароль. Если у панели не настроен публичный адрес, команда\nвыведет путь, начинающийся с `/`, и сообщит об этом; допишите перед ним адрес вашей панели.\n\nКаждое использование фиксируется в журнале аудита панели и в журнале аутентификации сервера\n(`authpriv`) с указанием учётной записи и того, была ли снята двухфакторная защита. Имя оператора берётся\nиз `SUDO_USER` и является заявленным, а не подтверждённым.\n\nЕсли администраторов нет вовсе, команда сообщает об этом и отправляет вас на страницу первичной\nнастройки вместо того, чтобы создать администратора.\n\n### Если потерян ещё и аутентификатор\n\n```bash\nsudo /usr/local/sbin/maran admin-reset-password admin@example.com --clear-two-factor\n```\n\nТак дополнительно удаляется двухфакторная привязка администратора, и при следующем входе хватит нового\nпароля. Применяйте это, только если аутентификатор действительно потерян: защита учётной записи снижается,\nпока администратор не подключит его заново, поэтому сразу после входа включите двухфакторную защиту снова.\nБез этого флага двухфакторная защита не затрагивается никогда.\n\n## Если правильные коды двухфакторной аутентификации не принимаются\n\nКоды аутентификатора вычисляются по времени, поэтому сервер, у которого ушли часы, отклоняет любой\nправильный код. Панель следит за часами: если последняя проверка нашла, что часы не синхронизированы с\nисточником времени, отклонённый код сообщает об этом («Часы сервера не синхронизированы…»), а не\nтолько «Код неверен». На главной странице в разделе «Требует внимания» появляется «Часы сервера не\nсинхронизированы», на странице «Мониторинг» видна карточка «Часы» с причиной, а оператор получает письмо,\nкогда часы остаются несинхронизированными десять проверок подряд, и ещё одно, когда они восстановятся.\n\nСама панель время не меняет. Включите службу синхронизации времени и дайте ей связаться с сервером\nвремени:\n\n```bash\nsudo timedatectl set-ntp true             # Debian и Ubuntu: systemd-timesyncd\nsudo systemctl enable --now chronyd       # AlmaLinux и Rocky Linux: chrony\ntimedatectl                               # ищите «System clock synchronized: yes»\n```\n\nПанель читает собственный вердикт ядра, а ядро перестаёт считать часы синхронизированными, когда его\nоценка возможной ошибки превышает шестнадцать секунд. Часы, ушедшие на несколько секунд, которые ядро\nещё считает синхронизированными, не отмечаются.\n\n## Сменить собственный пароль\n\nЛюбой, кто вошёл в панель (администратор или клиент), может сменить свой пароль без ссылки сброса\nпо почте. Откройте меню под своим именем, выберите **Профиль и защита** и воспользуйтесь карточкой\n**Пароль**: **Текущий пароль**, **Новый пароль** и **Подтверждение пароля**, затем\n**Сменить пароль**.\n\n- Новый пароль должен быть не короче минимума, который политика безопасности задаёт для сброса и\n  приглашений; более короткий отклоняется. Сообщение сейчас всегда называет 12 символов, каким бы ни\n  был минимум политики ([задача #300](https://github.com/innovayse/maran/issues/300)).\n- Неверный текущий пароль отклоняется с 400 `CurrentPasswordIncorrect` и сообщением «Текущий пароль указан\n  неверно.» Попытка засчитывается в блокировку учётной записи точно так же, как неудачный вход, а\n  пока учётная запись заблокирована, любая попытка получает тот же ответ.\n- При успехе панель сообщает «Пароль изменён. Все остальные устройства отключены.» Устройство, на\n  котором вы сменили пароль, остаётся в системе; все остальные сеансы завершаются.\n\nЭндпоинт `POST /api/v1/auth/change-password` разделяет ограничение частоты со входом. Каждая\nсмена и каждый отказ записываются в журнал аудита как «Пароль изменён», без какого-либо из паролей.\nОстальные коды ошибок перечислены в разделе [Коды ошибок API](/docs/api-errors).\n\n## Проверить состояние сервера\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nВ первом разделе видно, активны и включены ли панель, агент, PostgreSQL и веб-сервер (передача файлов\nдобавляется, когда администратор её включил). Второй раздел содержит собственный отчёт панели: доступность базы\nданных, связь с агентом, ожидающие миграции, версия, число администраторов и открыто ли ещё окно первичной\nнастройки. Второй раздел может не сработать, не скрыв первый. Код возврата 0 означает, что всё в порядке,\nиначе 1. Секретов команда не выводит.\n\n## Нижний предел свободного места\n\nАгент держит нижний предел свободного места: сколько MiB должно оставаться доступным в файловой\nсистеме, прежде чем он начнёт работу, которая туда пишет. Это 1 ГиБ, если вы не изменили значение\nв `/etc/maran/agent.env`:\n\n```bash\nMARAN_AGENT_FREE_SPACE_FLOOR_MIB=1024\n```\n\nУстановщик записывает 1024 и сохраняет ваше значение при повторном запуске. Юнит передаёт его\nагенту как `--free-space-floor-mib`; без флага агент применяет те же 1024. Значение должно быть\nцелым числом от 1. С нулём или любым другим значением агент не запустится: нечитаемый предел нельзя\nпринимать за нулевой. Изменить его может только root; ничто из того, что отправляет панель, предел не несёт.\n\nПока в файловой системе, куда операция будет писать, доступно меньше предела, следующие операции\nотклоняются до того, как что-либо записано:\n\n- создание аккаунта,\n- создание резервной копии,\n- восстановление резервной копии,\n- приём загрузки.\n\nОтказ возвращается как ошибка `AgentBelowFreeSpaceFloor` (HTTP 503). В ответе и в причине сбоя\nзадачи резервного копирования или восстановления она читается на вашем языке как «На сервере почти\nзакончилось место на диске…». Файловая система, которую не удалось измерить, тоже отклоняется, а\nне пропускается. Приостановка, удаление и любое чтение продолжают работать, так что место можно\nосвободить из панели.\n\nПредел проверяется перед началом работы, а не резервируется: другой процесс всё ещё может заполнить\nдиск после проверки, и пути записи сохраняют для этого случая собственную обработку по принципу\n«всё или ничего».\n\n### Предупреждение о приближении к пределу\n\nПанель отправляет оператору письмо, когда в корневой файловой системе десять проверок подряд\nдоступно меньше двух пределов, так что предупреждение приходит до начала отказов. Второе письмо\nсообщает, когда свободного места снова достаточно. Если домашние каталоги аккаунтов лежат в\nотдельной файловой системе, отказ по-прежнему следует за ней, но предупреждение ему не предшествует:\nоно следит только за корневой файловой системой.\n\n## Собрать архив для поддержки\n\n```bash\nsudo /usr/local/sbin/maran collect-diagnostics\n```\n\nКоманда записывает `maran-diagnostics-\u003Cвремя>-\u003Cномер>.tar.gz` в `/root`, читаемый только для root. Другой\nкаталог задаётся через `--out DIR` (абсолютный путь, принадлежащий root и недоступный другим на запись), а\nжурналы можно исключить флагом `--no-logs`.\n\n**Что входит в архив:**\n\n- отчёт о службах из `maran status`, включая сведения о базе данных и миграциях;\n- версия операционной системы, юниты systemd панели и состояние её служб;\n- два конфигурационных файла Maran для веб-сервера;\n- ИМЕНА настроек панели, но не их значения;\n- субъект, издатель и срок действия сертификата панели;\n- правила межсетевого экрана;\n- если нет `--no-logs`, журнал панели, агента и веб-сервера за последние семь дней (с ограничением размера)\n  и конец собственных журналов панели верхнего уровня.\n\n**Что команда никогда не читает:** файлы и домашние каталоги клиентов, журналы самих сайтов, резервные\nкопии, дампы баз данных, закрытые ключи и значения из `panel.env`.\n\nИз каждого текста удаляются известные секреты и типичные формы секретов, затем готовый архив\nраспаковывается и проверяется ещё раз. Если проверка что-то находит, архив удаляется, а команда завершается\nс ошибкой, а не оставляет пакет, который вы могли бы отправить.\n\n**Просмотрите архив перед отправкой.** Очистка убирает то, что этот сервер заведомо хранит, но её полноту\nдоказать нельзя. IP-адреса, имена хостов и доменные имена клиентов не удаляются. Распакуйте архив,\nпрочитайте его и отправляйте только тем, кому доверяете такие сведения.\n\n## Читать журналы и менять их подробность\n\nПанель и агент сервера пишут в журнал systemd: читайте их командами `journalctl -u maran-api` и\n`journalctl -u maran-agent`. Их размер ограничивает journald. Файлы в `/var/log/maran` ротируются\nправилами, которые установщик кладёт в `/etc/logrotate.d/`: журнал установки ротируется раз в месяц (хранятся\nдвенадцать), журналы веб-сервера самой панели ежедневно (тридцать), журналы веб-сервера сайтов\nежедневно (четырнадцать), журнал FTPS раз в неделю (четыре). На уже установленном сервере\nзапустите установщик повторно, чтобы получить правило для журнала установки.\n\n**Меняйте уровень журнала панели без перезапуска.** Мониторинг → **Уровень журнала панели**\nпоказывает, с каким уровнем панель пишет журнал, и позволяет администратору выбрать: подробный,\nотладка, информация (обычный уровень), предупреждение, ошибка или критический. Изменение действует\nсо следующей строки, сохраняется после перезапуска и записывается в журнал аудита с прежним и новым\nуровнем. Повышайте его на время разбора проблемы, затем верните обратно. Ни один уровень не заставит\nпанель записать пароль, ключ или токен. Уровень журнала самого агента сервера так пока изменить\nнельзя.\n",{"title":71,"description":1017},"Восстановление доступа и сбор диагностики Maran","ru/docs/recovery","sIGzy9Kif7Au2Chua10GPlCxBFEj3AVNQJuGcbdI_Kg",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1027},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"/>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1029},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71\"/>\u003Cpath d=\"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71\"/>\u003C/g>",1793873019503]