[{"data":1,"prerenderedAt":1230},["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/troubleshooting":469,"i-lucide:link":1226,"i-lucide:copy":1228},[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":91,"body":472,"description":1217,"extension":1218,"icon":94,"meta":1219,"navigation":110,"order":93,"path":1220,"rawbody":1221,"section":28,"seo":1222,"seoTitle":1223,"stem":1224,"__hash__":1225},"docsRu/ru/docs/troubleshooting.md",{"type":473,"value":474,"toc":1211},"minimark",[475,505,529,552,555,576,581,634,669,674,728,730,742,746,827,877,881,902,904,936,940,1023,1027,1052,1054,1070,1074,1125,1156,1160,1207],[476,477,478,479,483,484,487,488,491,492,496,497,500,501,504],"p",{},"В каждом сценарии ниже три части: ",[480,481,482],"strong",{},"симптомы",", которые вы видите, ",[480,485,486],{},"проверки",", отличающие причины\nдруг от друга, и ",[480,489,490],{},"исправления",". Все команды выполняйте на самом сервере от root. Два инструмента\nпомогают во всех четырёх случаях: ",[493,494,495],"code",{},"maran status"," показывает, какие службы работают, даже когда панель\nне отвечает, а ",[493,498,499],{},"maran collect-diagnostics"," собирает архив с вычищенными секретами для того, кто вам\nпомогает (оба описаны в разделе ",[502,503,71],"a",{"href":72},").",[506,507,512],"pre",{"className":508,"code":509,"language":510,"meta":511,"style":511},"language-bash shiki shiki-themes github-light-high-contrast github-dark-high-contrast","sudo /usr/local/sbin/maran status\n","bash","",[493,513,514],{"__ignoreMap":511},[515,516,518,522,526],"span",{"class":517,"line":10},"line",[515,519,521],{"class":520},"soyes","sudo",[515,523,525],{"class":524},"sT6z2"," /usr/local/sbin/maran",[515,527,528],{"class":524}," status\n",[476,530,531,532,535,536,539,540,543,544,547,548,551],{},"Службы называются ",[493,533,534],{},"maran-api"," (панель), ",[493,537,538],{},"maran-agent"," (демон от root, выполняющий привилегированные\nоперации), ",[493,541,542],{},"postgresql"," и ",[493,545,546],{},"nginx","; после включения передачи файлов в списке появляется и ",[493,549,550],{},"maran-ftps",".\nИх журналы находятся в журнале systemd.",[553,554,391],"h2",{"id":392},[476,556,557,560,561,563,564,567,568,571,572,575],{},[480,558,559],{},"Симптомы."," Браузер не открывает панель на порту 8443, либо открывает, но каждый вызов отвечает 502.\nВ ",[493,562,495],{}," служба ",[493,565,566],{},"maran-api.service"," в состоянии ",[493,569,570],{},"failed"," или ",[493,573,574],{},"activating",", либо раздел Panel\nсообщает, что собственный отчёт панели недоступен.",[476,577,578],{},[480,579,580],{},"Проверки.",[506,582,584],{"className":508,"code":583,"language":510,"meta":511,"style":511},"sudo systemctl status maran-api.service --no-pager\nsudo journalctl -u maran-api.service -n 50 --no-pager\nls -l /run/maran-api/api.sock\n",[493,585,586,603,623],{"__ignoreMap":511},[515,587,588,590,593,596,599],{"class":517,"line":10},[515,589,521],{"class":520},[515,591,592],{"class":524}," systemctl",[515,594,595],{"class":524}," status",[515,597,598],{"class":524}," maran-api.service",[515,600,602],{"class":601},"s-5SL"," --no-pager\n",[515,604,605,607,610,613,615,618,621],{"class":517,"line":15},[515,606,521],{"class":520},[515,608,609],{"class":524}," journalctl",[515,611,612],{"class":601}," -u",[515,614,598],{"class":524},[515,616,617],{"class":601}," -n",[515,619,620],{"class":601}," 50",[515,622,602],{"class":601},[515,624,625,628,631],{"class":517,"line":33},[515,626,627],{"class":520},"ls",[515,629,630],{"class":601}," -l",[515,632,633],{"class":524}," /run/maran-api/api.sock\n",[635,636,637,649,659,666],"ul",{},[638,639,640,641,644,645,648],"li",{},"Когда панель отказывается запускаться, причина названа в журнале: ключ шифрования или подписи в\n",[493,642,643],{},"/etc/maran/panel.env"," отсутствует, совпадает с опубликованным ключом для разработки или имеет\nневерный формат, либо не задан ",[493,646,647],{},"ReverseProxy__PeerUid"," (идентификатор пользователя веб-сервера,\nкоторый записывает установщик).",[638,650,651,652,654,655,658],{},"Панель подключается к PostgreSQL через локальный сокет, поэтому в ",[493,653,495],{}," посмотрите и\n",[493,656,657],{},"postgresql.service",".",[638,660,661,662,665],{},"У исправной панели есть сокет ",[493,663,664],{},"/run/maran-api/api.sock"," с правами 660. Если его нет, панель его так и\nне создала; если права или группа другие, nginx не может его открыть и каждый вызов отвечает 502.",[638,667,668],{},"Служба сдаётся после пяти запусков за шестьдесят секунд. Если в журнале видно именно это, причина\nнаходится выше по журналу, а не в последней строке.",[476,670,671],{},[480,672,673],{},"Исправления.",[675,676,677,683,689,720],"ol",{},[638,678,679,680,682],{},"Исправьте то, что названо в журнале, например строку в ",[493,681,643],{},". Не заменяйте ключ\nшифрования вручную, если об этом не говорит сообщение об отказе: после замены сохранённые секреты\nстановятся нечитаемыми.",[638,684,685,686,658],{},"Если PostgreSQL был остановлен, сначала запустите его: ",[493,687,688],{},"sudo systemctl start postgresql.service",[638,690,691,692],{},"Сбросьте счётчик запусков и запустите панель:",[506,693,695],{"className":508,"code":694,"language":510,"meta":511,"style":511},"sudo systemctl reset-failed maran-api.service\nsudo systemctl restart maran-api.service\n",[493,696,697,709],{"__ignoreMap":511},[515,698,699,701,703,706],{"class":517,"line":10},[515,700,521],{"class":520},[515,702,592],{"class":524},[515,704,705],{"class":524}," reset-failed",[515,707,708],{"class":524}," maran-api.service\n",[515,710,711,713,715,718],{"class":517,"line":15},[515,712,521],{"class":520},[515,714,592],{"class":524},[515,716,717],{"class":524}," restart",[515,719,708],{"class":524},[638,721,722,723,725,726,658],{},"Если сами файлы повреждены, запустите установщик ещё раз: это безопасно (см.\n",[502,724,13],{"href":14},"). Если не работает только вход в панель, см.\n",[502,727,71],{"href":72},[553,729,394],{"id":395},[476,731,732,734,735,571,738,741],{},[480,733,559],{}," Размещённый сайт отвечает ",[493,736,737],{},"502 Bad Gateway",[493,739,740],{},"404 Not Found",", а сама панель работает.",[476,743,744],{},[480,745,580],{},[506,747,749],{"className":508,"code":748,"language":510,"meta":511,"style":511},"sudo nginx -t\nsudo systemctl status nginx.service --no-pager\nls /etc/maran/nginx/sites/\nls -l /run/maran-php/\nsudo tail -n 50 /var/log/maran/sites/\u003Caccount>/*.log\n",[493,750,751,761,774,781,790],{"__ignoreMap":511},[515,752,753,755,758],{"class":517,"line":10},[515,754,521],{"class":520},[515,756,757],{"class":524}," nginx",[515,759,760],{"class":601}," -t\n",[515,762,763,765,767,769,772],{"class":517,"line":15},[515,764,521],{"class":520},[515,766,592],{"class":524},[515,768,595],{"class":524},[515,770,771],{"class":524}," nginx.service",[515,773,602],{"class":601},[515,775,776,778],{"class":517,"line":33},[515,777,627],{"class":520},[515,779,780],{"class":524}," /etc/maran/nginx/sites/\n",[515,782,783,785,787],{"class":517,"line":38},[515,784,627],{"class":520},[515,786,630],{"class":601},[515,788,789],{"class":524}," /run/maran-php/\n",[515,791,792,794,797,799,801,804,808,811,815,818,821,824],{"class":517,"line":43},[515,793,521],{"class":520},[515,795,796],{"class":524}," tail",[515,798,617],{"class":601},[515,800,620],{"class":601},[515,802,803],{"class":524}," /var/log/maran/sites/",[515,805,807],{"class":806},"sHUrx","\u003C",[515,809,810],{"class":524},"accoun",[515,812,814],{"class":813},"suds8","t",[515,816,817],{"class":806},">",[515,819,820],{"class":524},"/",[515,822,823],{"class":601},"*",[515,825,826],{"class":524},".log\n",[635,828,829,843,856,864],{},[638,830,831,834,835,838,839,842],{},[493,832,833],{},"nginx -t"," должен проходить. У каждого сайта свой файл конфигурации в ",[493,836,837],{},"/etc/maran/nginx/sites/",",\nподключаемый через ",[493,840,841],{},"/etc/nginx/conf.d/maran-sites.conf",". Сайт без файла там nginx неизвестен, и его\nимя отвечает как другой сайт или как сайт по умолчанию.",[638,844,845,848,849,852,853,855],{},[480,846,847],{},"502"," на PHP-сайте означает, что nginx не достучался до PHP-пула сайта: его сокет лежит в\n",[493,850,851],{},"/run/maran-php",". ",[480,854,847],{}," на сайте-обратном прокси означает, что служба, на которую вы его\nнаправили, не запущена или не слушает.",[638,857,858,861,862,658],{},[480,859,860],{},"404"," означает, что nginx ответил, но ничего не нашёл: домена нет среди доменных имён и алиасов\nсайта, сайт приостановлен или отключён, DNS-имя указывает на другой сервер или в корневом каталоге\nнет индексного файла. См. ",[502,863,41],{"href":42},[638,865,866,867,870,871,543,874,658],{},"Журналы доступа и ошибок самого сайта лежат в ",[493,868,869],{},"/var/log/maran/sites/\u003Caccount>/",", вне домашнего\nкаталога клиента; панель также показывает их потоком на странице сайта. Журналы веб-сервера самой\nпанели: ",[493,872,873],{},"/var/log/maran/nginx-access.log",[493,875,876],{},"/var/log/maran/nginx-error.log",[476,878,879],{},[480,880,673],{},[675,882,883,886,889,896],{},[638,884,885],{},"Исправьте домен, алиасы или корневой каталог в панели либо снова включите сайт и проверьте\nDNS-запись.",[638,887,888],{},"Для сайта-обратного прокси запустите службу, на которую он смотрит.",[638,890,891,892,895],{},"Если нет PHP-сокета или сайт создан более ранним выпуском, перезапустите панель:\n",[493,893,894],{},"sudo systemctl restart maran-api.service",". При запуске она просит агента привести пул и\nконфигурацию веб-сервера каждого PHP-сайта в порядок.",[638,897,898,899,901],{},"Запись конфигурации проверяется собственным валидатором веб-сервера и откатывается при ошибке,\nпоэтому один сайт обычно не ломает остальные. Если ",[493,900,833],{}," падает на файле, который не относится\nк Maran, сначала исправьте его: из-за него не проходит перезагрузка конфигурации для всех сайтов.",[553,903,397],{"id":398},[476,905,906,908,909,912,913,912,916,919,920,912,923,912,926,929,930,933,934,504],{},[480,907,559],{}," Заказ сертификата для сайта или доверенного сертификата для панели завершается ошибкой.\nЭто одна из ",[493,910,911],{},"AcmeValidationFailed",", ",[493,914,915],{},"AcmeValidationTimedOut",[493,917,918],{},"AcmeAuthorityUnreachable",",\n",[493,921,922],{},"AcmeChallengeWriteFailed",[493,924,925],{},"PanelHostNameNotConfigured",[493,927,928],{},"PanelChallengeWriteFailed"," или\n",[493,931,932],{},"AgentBelowFreeSpaceFloor"," (все перечислены в разделе ",[502,935,51],{"href":52},[476,937,938],{},[480,939,580],{},[635,941,942,982,996,1016],{},[638,943,944,945,948,949,978,981],{},"Сертификаты выпускаются по проверке ACME HTTP-01, поэтому центр сертификации должен достучаться до\nвашего сервера по обычному HTTP на ",[480,946,947],{},"порту 80",". Домен должен указывать на этот сервер, а порт 80 не\nдолжен блокироваться ни межсетевым экраном перед машиной, ни правилами самого сервера:",[506,950,952],{"className":508,"code":951,"language":510,"meta":511,"style":511},"sudo nft list ruleset\ncurl -I http://example.com/.well-known/acme-challenge/test\n",[493,953,954,967],{"__ignoreMap":511},[515,955,956,958,961,964],{"class":517,"line":10},[515,957,521],{"class":520},[515,959,960],{"class":524}," nft",[515,962,963],{"class":524}," list",[515,965,966],{"class":524}," ruleset\n",[515,968,969,972,975],{"class":517,"line":15},[515,970,971],{"class":520},"curl",[515,973,974],{"class":601}," -I",[515,976,977],{"class":524}," http://example.com/.well-known/acme-challenge/test\n",[979,980],"br",{},"Ответ 404 на вторую команду нормален: он доказывает, что порт 80 отвечает для этого имени.",[638,983,984,985,988,989,912,992,995],{},"Проверочный файл ",[480,986,987],{},"сайта"," отдаётся из его собственного корневого каталога, поэтому сайт должен\nсуществовать, быть включён и отвечать на заказываемое имя. Имя, которое панель резервирует (IP-адрес,\n",[493,990,991],{},"localhost",[493,993,994],{},".local"," и подобные или собственное имя панели), отклоняется до любого запроса.",[638,997,998,999,1002,1003,1006,1007,1009,1010,1013,1014,658],{},"Для сертификата ",[480,1000,1001],{},"панели"," ",[493,1004,1005],{},"Panel__HostName"," в ",[493,1008,643],{}," должно быть настоящим именем,\nуказывающим на этот сервер. Проверочный файл отдаётся из ",[493,1011,1012],{},"/var/lib/maran-acme"," блоком порта 80 в\nконфигурации веб-сервера панели; сервер, установленный до появления этого блока, требует повторного\nзапуска установщика. См. ",[502,1015,76],{"href":77},[638,1017,1018,1019,1022],{},"Свободное место: ",[493,1020,1021],{},"df -h",". Ниже порога свободного места (1 ГиБ, если не изменён) запись отклоняется.",[476,1024,1025],{},[480,1026,673],{},[675,1028,1029,1032,1038,1043],{},[638,1030,1031],{},"Направьте DNS-запись на этот сервер, откройте порт 80 и закажите сертификат снова. Неудачный заказ\nничего не заменяет: уже используемый сертификат остаётся на месте.",[638,1033,1034,1035,1037],{},"Задайте ",[493,1036,1005],{},", если его нет, перезапустите панель и закажите снова; если нет блока порта\n80, запустите установщик ещё раз.",[638,1039,1040,1041,658],{},"Освободите место на диске, если ошибка называется ",[493,1042,932],{},[638,1044,1045,1046,1049,1050,658],{},"Подстановочные имена и DNS-01 не поддерживаются, поэтому имя вида ",[493,1047,1048],{},"*.example.com"," заказать нельзя.\nКак устроены заказ и продление, описано в разделе ",[502,1051,56],{"href":57},[553,1053,400],{"id":401},[476,1055,1056,1058,1059,1062,1063,1065,1066,1069],{},[480,1057,559],{}," Действия, меняющие сервер (создание учётной записи или сайта, заказ сертификата,\nрезервная копия), завершаются ошибкой агента, например ",[493,1060,1061],{},"AgentIncompatible",", а страницы, которые только\nчитают данные панели, открываются. Отчёт о состоянии панели показывает агента как недоступного, а\n",[493,1064,495],{}," показывает ",[493,1067,1068],{},"maran-agent.service"," не в состоянии active.",[476,1071,1072],{},[480,1073,580],{},[506,1075,1077],{"className":508,"code":1076,"language":510,"meta":511,"style":511},"sudo systemctl status maran-agent.service --no-pager\nsudo journalctl -u maran-agent.service -n 50 --no-pager\nls -l /run/maran/agent.sock\ncat /etc/maran/agent.env\n",[493,1078,1079,1092,1108,1117],{"__ignoreMap":511},[515,1080,1081,1083,1085,1087,1090],{"class":517,"line":10},[515,1082,521],{"class":520},[515,1084,592],{"class":524},[515,1086,595],{"class":524},[515,1088,1089],{"class":524}," maran-agent.service",[515,1091,602],{"class":601},[515,1093,1094,1096,1098,1100,1102,1104,1106],{"class":517,"line":15},[515,1095,521],{"class":520},[515,1097,609],{"class":524},[515,1099,612],{"class":601},[515,1101,1089],{"class":524},[515,1103,617],{"class":601},[515,1105,620],{"class":601},[515,1107,602],{"class":601},[515,1109,1110,1112,1114],{"class":517,"line":33},[515,1111,627],{"class":520},[515,1113,630],{"class":601},[515,1115,1116],{"class":524}," /run/maran/agent.sock\n",[515,1118,1119,1122],{"class":517,"line":38},[515,1120,1121],{"class":520},"cat",[515,1123,1124],{"class":524}," /etc/maran/agent.env\n",[635,1126,1127,1140,1148,1153],{},[638,1128,1129,1130,1133,1134,1006,1137,658],{},"Агент слушает unix-сокет ",[493,1131,1132],{},"/run/maran/agent.sock",": права 660, владелец root, группа панели. Никто\nдругой подключиться не может, а сам агент принимает только идентификатор пользователя из\n",[493,1135,1136],{},"MARAN_AGENT_ALLOW_UID",[493,1138,1139],{},"/etc/maran/agent.env",[638,1141,1142,1145,1146,504],{},[493,1143,1144],{},"MARAN_AGENT_FREE_SPACE_FLOOR_MIB"," в том же файле должен быть целым числом от 1: иначе агент\nотказывается запускаться (порог свободного места описан в разделе\n",[502,1147,71],{"href":72},[638,1149,1150,1152],{},[493,1151,1061],{}," означает, что панель и агент разных версий, например во время обновления. Их\nнужно обновлять вместе.",[638,1154,1155],{},"Панель запускается без агента и лишь пишет предупреждение, поэтому то, что панель работает, ничего\nне говорит об агенте.",[476,1157,1158],{},[480,1159,673],{},[675,1161,1162,1191,1197,1200],{},[638,1163,1164,1165],{},"Перезапустите агента, затем панель, именно в таком порядке:",[506,1166,1168],{"className":508,"code":1167,"language":510,"meta":511,"style":511},"sudo systemctl restart maran-agent.service\nsudo systemctl restart maran-api.service\n",[493,1169,1170,1181],{"__ignoreMap":511},[515,1171,1172,1174,1176,1178],{"class":517,"line":10},[515,1173,521],{"class":520},[515,1175,592],{"class":524},[515,1177,717],{"class":524},[515,1179,1180],{"class":524}," maran-agent.service\n",[515,1182,1183,1185,1187,1189],{"class":517,"line":15},[515,1184,521],{"class":520},[515,1186,592],{"class":524},[515,1188,717],{"class":524},[515,1190,708],{"class":524},[638,1192,1193,1194,658],{},"Если служба продолжает падать, исправьте то, что названо в её журнале (например, значение порога),\nи перед перезапуском выполните ",[493,1195,1196],{},"sudo systemctl reset-failed maran-agent.service",[638,1198,1199],{},"Если версии различаются, запустите установщик ещё раз, чтобы обе части были из одного выпуска.",[638,1201,1202,1203,1206],{},"Если не помогло, выполните ",[493,1204,1205],{},"sudo /usr/local/sbin/maran collect-diagnostics",", прочитайте архив и\nотправьте его тому, кто вам помогает.",[1208,1209,1210],"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 .sHUrx, html code.shiki .sHUrx{--shiki-default:#A0111F;--shiki-dark:#FF9492}html pre.shiki code .suds8, html code.shiki .suds8{--shiki-default:#0E1116;--shiki-dark:#F0F3F6}",{"title":511,"searchDepth":15,"depth":15,"links":1212},[1213,1214,1215,1216],{"id":392,"depth":15,"text":391},{"id":395,"depth":15,"text":394},{"id":398,"depth":15,"text":397},{"id":401,"depth":15,"text":400},"Разбор четырёх частых отказов: панель не запускается, сайт отвечает 502 или 404, сертификат не выпускается и агент недоступен.","md",{},"/ru/docs/troubleshooting","---\ntitle: Устранение неполадок\ndescription: 'Разбор четырёх частых отказов: панель не запускается, сайт отвечает 502 или 404, сертификат не выпускается и агент недоступен.'\nseoTitle: 'Устранение неполадок сервера Maran: 4 сценария'\nsection: Как это работает\norder: 14\nicon: lucide:wrench\n---\n\nВ каждом сценарии ниже три части: **симптомы**, которые вы видите, **проверки**, отличающие причины\nдруг от друга, и **исправления**. Все команды выполняйте на самом сервере от root. Два инструмента\nпомогают во всех четырёх случаях: `maran status` показывает, какие службы работают, даже когда панель\nне отвечает, а `maran collect-diagnostics` собирает архив с вычищенными секретами для того, кто вам\nпомогает (оба описаны в разделе [Восстановление и диагностика](/docs/recovery)).\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nСлужбы называются `maran-api` (панель), `maran-agent` (демон от root, выполняющий привилегированные\nоперации), `postgresql` и `nginx`; после включения передачи файлов в списке появляется и `maran-ftps`.\nИх журналы находятся в журнале systemd.\n\n## Панель не запускается\n\n**Симптомы.** Браузер не открывает панель на порту 8443, либо открывает, но каждый вызов отвечает 502.\nВ `maran status` служба `maran-api.service` в состоянии `failed` или `activating`, либо раздел Panel\nсообщает, что собственный отчёт панели недоступен.\n\n**Проверки.**\n\n```bash\nsudo systemctl status maran-api.service --no-pager\nsudo journalctl -u maran-api.service -n 50 --no-pager\nls -l /run/maran-api/api.sock\n```\n\n- Когда панель отказывается запускаться, причина названа в журнале: ключ шифрования или подписи в\n  `/etc/maran/panel.env` отсутствует, совпадает с опубликованным ключом для разработки или имеет\n  неверный формат, либо не задан `ReverseProxy__PeerUid` (идентификатор пользователя веб-сервера,\n  который записывает установщик).\n- Панель подключается к PostgreSQL через локальный сокет, поэтому в `maran status` посмотрите и\n  `postgresql.service`.\n- У исправной панели есть сокет `/run/maran-api/api.sock` с правами 660. Если его нет, панель его так и\n  не создала; если права или группа другие, nginx не может его открыть и каждый вызов отвечает 502.\n- Служба сдаётся после пяти запусков за шестьдесят секунд. Если в журнале видно именно это, причина\n  находится выше по журналу, а не в последней строке.\n\n**Исправления.**\n\n1. Исправьте то, что названо в журнале, например строку в `/etc/maran/panel.env`. Не заменяйте ключ\n   шифрования вручную, если об этом не говорит сообщение об отказе: после замены сохранённые секреты\n   становятся нечитаемыми.\n2. Если PostgreSQL был остановлен, сначала запустите его: `sudo systemctl start postgresql.service`.\n3. Сбросьте счётчик запусков и запустите панель:\n\n   ```bash\n   sudo systemctl reset-failed maran-api.service\n   sudo systemctl restart maran-api.service\n   ```\n\n4. Если сами файлы повреждены, запустите установщик ещё раз: это безопасно (см.\n   [Установка](/docs/installation)). Если не работает только вход в панель, см.\n   [Восстановление и диагностика](/docs/recovery).\n\n## Сайт отвечает 502 или 404\n\n**Симптомы.** Размещённый сайт отвечает `502 Bad Gateway` или `404 Not Found`, а сама панель работает.\n\n**Проверки.**\n\n```bash\nsudo nginx -t\nsudo systemctl status nginx.service --no-pager\nls /etc/maran/nginx/sites/\nls -l /run/maran-php/\nsudo tail -n 50 /var/log/maran/sites/\u003Caccount>/*.log\n```\n\n- `nginx -t` должен проходить. У каждого сайта свой файл конфигурации в `/etc/maran/nginx/sites/`,\n  подключаемый через `/etc/nginx/conf.d/maran-sites.conf`. Сайт без файла там nginx неизвестен, и его\n  имя отвечает как другой сайт или как сайт по умолчанию.\n- **502** на PHP-сайте означает, что nginx не достучался до PHP-пула сайта: его сокет лежит в\n  `/run/maran-php`. **502** на сайте-обратном прокси означает, что служба, на которую вы его\n  направили, не запущена или не слушает.\n- **404** означает, что nginx ответил, но ничего не нашёл: домена нет среди доменных имён и алиасов\n  сайта, сайт приостановлен или отключён, DNS-имя указывает на другой сервер или в корневом каталоге\n  нет индексного файла. См. [Сайты и PHP](/docs/websites).\n- Журналы доступа и ошибок самого сайта лежат в `/var/log/maran/sites/\u003Caccount>/`, вне домашнего\n  каталога клиента; панель также показывает их потоком на странице сайта. Журналы веб-сервера самой\n  панели: `/var/log/maran/nginx-access.log` и `/var/log/maran/nginx-error.log`.\n\n**Исправления.**\n\n1. Исправьте домен, алиасы или корневой каталог в панели либо снова включите сайт и проверьте\n   DNS-запись.\n2. Для сайта-обратного прокси запустите службу, на которую он смотрит.\n3. Если нет PHP-сокета или сайт создан более ранним выпуском, перезапустите панель:\n   `sudo systemctl restart maran-api.service`. При запуске она просит агента привести пул и\n   конфигурацию веб-сервера каждого PHP-сайта в порядок.\n4. Запись конфигурации проверяется собственным валидатором веб-сервера и откатывается при ошибке,\n   поэтому один сайт обычно не ломает остальные. Если `nginx -t` падает на файле, который не относится\n   к Maran, сначала исправьте его: из-за него не проходит перезагрузка конфигурации для всех сайтов.\n\n## Сертификат не выпускается\n\n**Симптомы.** Заказ сертификата для сайта или доверенного сертификата для панели завершается ошибкой.\nЭто одна из `AcmeValidationFailed`, `AcmeValidationTimedOut`, `AcmeAuthorityUnreachable`,\n`AcmeChallengeWriteFailed`, `PanelHostNameNotConfigured`, `PanelChallengeWriteFailed` или\n`AgentBelowFreeSpaceFloor` (все перечислены в разделе [Коды ошибок API](/docs/api-errors)).\n\n**Проверки.**\n\n- Сертификаты выпускаются по проверке ACME HTTP-01, поэтому центр сертификации должен достучаться до\n  вашего сервера по обычному HTTP на **порту 80**. Домен должен указывать на этот сервер, а порт 80 не\n  должен блокироваться ни межсетевым экраном перед машиной, ни правилами самого сервера:\n\n  ```bash\n  sudo nft list ruleset\n  curl -I http://example.com/.well-known/acme-challenge/test\n  ```\n\n  Ответ 404 на вторую команду нормален: он доказывает, что порт 80 отвечает для этого имени.\n- Проверочный файл **сайта** отдаётся из его собственного корневого каталога, поэтому сайт должен\n  существовать, быть включён и отвечать на заказываемое имя. Имя, которое панель резервирует (IP-адрес,\n  `localhost`, `.local` и подобные или собственное имя панели), отклоняется до любого запроса.\n- Для сертификата **панели** `Panel__HostName` в `/etc/maran/panel.env` должно быть настоящим именем,\n  указывающим на этот сервер. Проверочный файл отдаётся из `/var/lib/maran-acme` блоком порта 80 в\n  конфигурации веб-сервера панели; сервер, установленный до появления этого блока, требует повторного\n  запуска установщика. См. [Сертификат панели](/docs/panel-certificate).\n- Свободное место: `df -h`. Ниже порога свободного места (1 ГиБ, если не изменён) запись отклоняется.\n\n**Исправления.**\n\n1. Направьте DNS-запись на этот сервер, откройте порт 80 и закажите сертификат снова. Неудачный заказ\n   ничего не заменяет: уже используемый сертификат остаётся на месте.\n2. Задайте `Panel__HostName`, если его нет, перезапустите панель и закажите снова; если нет блока порта\n   80, запустите установщик ещё раз.\n3. Освободите место на диске, если ошибка называется `AgentBelowFreeSpaceFloor`.\n4. Подстановочные имена и DNS-01 не поддерживаются, поэтому имя вида `*.example.com` заказать нельзя.\n   Как устроены заказ и продление, описано в разделе [SSL-сертификаты](/docs/ssl).\n\n## Агент недоступен\n\n**Симптомы.** Действия, меняющие сервер (создание учётной записи или сайта, заказ сертификата,\nрезервная копия), завершаются ошибкой агента, например `AgentIncompatible`, а страницы, которые только\nчитают данные панели, открываются. Отчёт о состоянии панели показывает агента как недоступного, а\n`maran status` показывает `maran-agent.service` не в состоянии active.\n\n**Проверки.**\n\n```bash\nsudo systemctl status maran-agent.service --no-pager\nsudo journalctl -u maran-agent.service -n 50 --no-pager\nls -l /run/maran/agent.sock\ncat /etc/maran/agent.env\n```\n\n- Агент слушает unix-сокет `/run/maran/agent.sock`: права 660, владелец root, группа панели. Никто\n  другой подключиться не может, а сам агент принимает только идентификатор пользователя из\n  `MARAN_AGENT_ALLOW_UID` в `/etc/maran/agent.env`.\n- `MARAN_AGENT_FREE_SPACE_FLOOR_MIB` в том же файле должен быть целым числом от 1: иначе агент\n  отказывается запускаться (порог свободного места описан в разделе\n  [Восстановление и диагностика](/docs/recovery)).\n- `AgentIncompatible` означает, что панель и агент разных версий, например во время обновления. Их\n  нужно обновлять вместе.\n- Панель запускается без агента и лишь пишет предупреждение, поэтому то, что панель работает, ничего\n  не говорит об агенте.\n\n**Исправления.**\n\n1. Перезапустите агента, затем панель, именно в таком порядке:\n\n   ```bash\n   sudo systemctl restart maran-agent.service\n   sudo systemctl restart maran-api.service\n   ```\n\n2. Если служба продолжает падать, исправьте то, что названо в её журнале (например, значение порога),\n   и перед перезапуском выполните `sudo systemctl reset-failed maran-agent.service`.\n3. Если версии различаются, запустите установщик ещё раз, чтобы обе части были из одного выпуска.\n4. Если не помогло, выполните `sudo /usr/local/sbin/maran collect-diagnostics`, прочитайте архив и\n   отправьте его тому, кто вам помогает.\n",{"title":91,"description":1217},"Устранение неполадок сервера Maran: 4 сценария","ru/docs/troubleshooting","SoLP4Q6eG4T1_aJglUIMzfH3ELeiWjAQa2fgbEot6R0",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1227},"\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>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1229},"\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>",1793873019667]