[{"data":1,"prerenderedAt":724},["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/file-transfer":469,"i-lucide:link":722},[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":66,"body":472,"description":713,"extension":714,"icon":69,"meta":715,"navigation":110,"order":68,"path":716,"rawbody":717,"section":28,"seo":718,"seoTitle":719,"stem":720,"__hash__":721},"docsRu/ru/docs/file-transfer.md",{"type":473,"value":474,"toc":700},"minimark",[475,484,487,494,504,516,519,521,528,530,541,552,555,557,564,567,572,579,599,626,629,631,639,643,654,674,677,679,694],[476,477,478,479,483],"p",{},"Передачу файлов обслуживает ",[480,481,482],"strong",{},"штатный OpenSSH"," хоста, а не написанный в этом проекте демон.",[485,486,223],"h2",{"id":224},[476,488,489,490,493],{},"Вход помещается в chroot, принадлежащий root jail, внутрь которого ",[480,491,492],{},"примонтирован настоящий\nдомашний каталог аккаунта",". Отсюда два следствия, и оба задуманы намеренно:",[495,496,497,501],"ul",{},[498,499,500],"li",{},"Чтобы jail заработал, не пришлось менять владельца домашнего каталога, поэтому аккаунт по-прежнему\nвладеет своими файлами ровно так же, как раньше.",[498,502,503],{},"Изнутри не становится виден ни один другой аккаунт. Jail не просто каталог, в котором клиента просят\nоставаться: другого каталога там просто нет.",[476,505,506,507,511,512,515],{},"Вход несёт собственный uid аккаунта, поэтому загруженный файл принадлежит аккаунту ровно так же, как\nсозданный им самим. Ему выдаётся ",[508,509,510],"code",{},"internal-sftp"," и ",[480,513,514],{},"никакого шелла",". Проверяется это тем,\nчто настоящей сессии отказывают в команде, а не наличием директивы в файле.",[476,517,518],{},"Проброс портов выключен. Учётные данные для передачи файлов, умеющие пробрасывать порты, превращаются\nв туннель в приватную сеть сервера.",[485,520,226],{"id":227},[476,522,523,524,527],{},"Пароль и открытые ключи входа проверяются при установке соединения и больше не проверяются для сеанса,\nкоторый сервер уже принял. Поэтому смена учётных данных сама по себе не отключила бы того, кто уже\nподключён по старым. Когда вы сбрасываете пароль входа, панель завершает все открытые сеансы этого входа,\nа при удалении входа делает это до его удаления. Загрузка, которая идёт в этот момент, обрывается на том\nбайте, до которого дошла, и неполный файл остаётся. Завершаются только сеансы этого входа; другие входы\nаккаунта не затрагиваются. Если сервер не смог подтвердить завершение сеансов, удаление отклоняется и его\nможно повторить, а сброс всё равно возвращает новый пароль, но записывает сбой в журнал аудита как\n",[480,525,526],{},"Завершены сеансы SFTP",", чтобы вы знали: старые сеансы могут быть ещё открыты.",[485,529,229],{"id":230},[476,531,532,533,536,537,540],{},"Тот же блок указывает, откуда читаются открытые ключи входа SFTP:\n",[508,534,535],{},"/etc/ssh/maran-sftp-keys/\u003Cвход>",", по одному принадлежащему root файлу на вход. Ключ, который клиент\nположит в свой домашний каталог, ",[480,538,539],{},"никогда не читается",": файл, который решает, кто может войти, клиент\nзаписать не может.",[476,542,543,544,547,548,551],{},"Агент сервера пишет этот файл из проверенного списка и ни из чего больше. Принимаются только\nEd25519, ECDSA и RSA от 2048 бит (и две формы аппаратных ключей); ключ с опцией вроде ",[508,545,546],{},"command=\"…\"","\nотклоняется, а не чистится, и каждая строка пишется с ",[508,549,550],{},"restrict",", так что ключ умеет передавать\nфайлы и ничего больше. Ключи приостановленного аккаунта убираются в сторону и возвращаются при\nвозобновлении: одного заблокированного пароля недостаточно, чтобы остановить вход по ключу.",[476,553,554],{},"На хостах, установленных до этого изменения, установщик нужно запустить ещё раз, чтобы появились\nстрока и каталог. Добавление ключей с экрана SFTP в панели в этот выпуск ещё не входит.",[485,556,232],{"id":233},[476,558,559,560,563],{},"Установщик ставит vsftpd, и FTPS работает целиком. Поставляется он ",[480,561,562],{},"выключенным",": ничего не\nслушает, конфигурация не рендерится, а штатная служба дистрибутива замаскирована, пока\nадминистратор не включит FTPS из панели.",[476,565,566],{},"Включение FTPS ждёт ответа vsftpd до 10 секунд, прежде чем оценивать результат. Если демон так и не\nответил, изменение откатывается: после неудачного первого включения конфигурации не остаётся, поэтому\nповторная попытка начинается с чистого листа, а не сообщает об успехе при остановленном демоне.",[568,569,571],"h3",{"id":570},"строка-шифрования-говорит-о-том-что-измерено","Строка шифрования говорит о том, что измерено",[476,573,574,575,578],{},"В состоянии FTPS-сервера есть строка ",[480,576,577],{},"Шифрование",", прочитанная из конфигурации демона на хосте, а не из\nсобственной настройки панели. У неё три состояния:",[495,580,581,587,593],{},[498,582,583,586],{},[480,584,585],{},"TLS обязателен для входа и передачи",": демон отклоняет вход или передачу, которые не зашифрованы.",[498,588,589,592],{},[480,590,591],{},"TLS необязателен: вход и передача могут идти без шифрования",": демон принимает и то и другое, поэтому\nклиент, не запрашивающий TLS, отправляет пароль открытым текстом. Исправьте это, прежде чем открывать\nсервер для пользователей.",[498,594,595,598],{},[480,596,597],{},"Не проверено: настройки не удалось прочитать",": агент не смог прочитать конфигурацию демона, поэтому\nпанель не утверждает ни того, ни другого. Это не предупреждение о том, что TLS выключен; проверьте, что\nагент запущен, и обновите страницу.",[476,600,601,602,605,606,609,610,613,614,617,618,621,622,625],{},"Для интеграций ",[508,603,604],{},"GET /api/v1/ftps-server"," передаёт это как ",[508,607,608],{},"tlsEnforcement",": ",[508,611,612],{},"enforced",", ",[508,615,616],{},"notEnforced"," или\n",[508,619,620],{},"notObserved",". Оно заменяет ",[508,623,624],{},"forcedTls",", которое умело говорить только «да» или «нет», поэтому нечитаемую\nконфигурацию показывало как «нет».",[476,627,628],{},"Сказано прямо, потому что прежняя заметка о выпуске утверждала обратное (будто FTP-демон вообще не\nустанавливается), а оператор, который в это верит, не пойдёт искать его на своём хосте.",[485,630,235],{"id":236},[476,632,633,634,638],{},"Плановые копии аккаунтов с политиками хранения запускаются из панели. Одного они не делают: не\nпокрывают удаление базы. См. ",[635,636,637],"a",{"href":62},"базы данных",", где удаление окончательно, а путь\nудаления ни к чему не обращается.",[568,640,642],{"id":641},"когда-плановая-копия-не-удалась-администратор-получает-письмо","Когда плановая копия не удалась, администратор получает письмо",[476,644,645,646,649,650,653],{},"Раньше каждый из этих случаев проходил молча, теперь каждый отправляет одно оповещение на адрес из\n",[480,647,648],{},"Исходящая почта"," → ",[480,651,652],{},"Отправлять оповещения на",", на английском, русском или армянском:",[495,655,656,662,668],{},[498,657,658,661],{},[480,659,660],{},"Плановый запуск не удался",": он закончился без архива. Прежние копии аккаунта сохраняются.",[498,663,664,667],{},[480,665,666],{},"Место хранения отказало",": место хранения расписания нельзя было использовать, поэтому запуск\nне начинался.",[498,669,670,673],{},[480,671,672],{},"Запуск пропущен",": расписание стартовало больше чем через 30 минут после назначенного часа,\nобычно потому, что панель в тот час не работала. Панель, выключенная несколько ночей, догоняет\nодним запуском и отправляет одно оповещение с первым пропущенным часом.",[476,675,676],{},"Каждое оповещение записывается в журнал аудита как «Сработало оповещение», а если адрес для\nоповещений не задан, рядом записывается «Письмо не отправлено: нет настроек SMTP». Ручные копии\nписем не отправляют: тот, кто запустил копию, следит за её задачей. Пока не покрыто: проверка\nкаждого архива после записи. До тех пор повреждённый архив обнаруживается при восстановлении,\nкоторое проверяет каждый дамп базы перед загрузкой.",[485,678,238],{"id":239},[476,680,681,682,685,686,689,690,693],{},"Установщик пишет тот единственный блок ",[508,683,684],{},"Match Group",", который превращает SFTP-аккаунт в запертый\nвход, и делает это идемпотентно. ",[480,687,688],{},"Потом туда никто не смотрит."," Правленный руками ",[508,691,692],{},"sshd_config","\nили сброшенный обновлением дистрибутива, потерявший этот блок, дал бы каждому клиенту передачи\nфайлов полноценную сессию с шеллом, а панель продолжала бы показывать все входы здоровыми.",[476,695,696,697,699],{},"Если вы правите ",[508,698,692],{}," на хосте с Maran, проверьте, что блок на месте.",{"title":701,"searchDepth":15,"depth":15,"links":702},"",[703,704,705,706,709,712],{"id":224,"depth":15,"text":223},{"id":227,"depth":15,"text":226},{"id":230,"depth":15,"text":229},{"id":233,"depth":15,"text":232,"children":707},[708],{"id":570,"depth":33,"text":571},{"id":236,"depth":15,"text":235,"children":710},[711],{"id":641,"depth":33,"text":642},{"id":239,"depth":15,"text":238},"Как входы SFTP запираются в jail, чтобы ни один аккаунт не видел другого, почему FTPS поставляется выключенным, что забирают копии и что не перепроверяется.","md",{},"/ru/docs/file-transfer","---\ntitle: Передача файлов и резервные копии\ndescription: 'Как входы SFTP запираются в jail, чтобы ни один аккаунт не видел другого, почему FTPS поставляется выключенным, что забирают копии и что не перепроверяется.'\nseoTitle: 'Передача файлов и копии: jail и FTPS'\nsection: Как это работает\norder: 9\nicon: lucide:folder-sync\n---\n\nПередачу файлов обслуживает **штатный OpenSSH** хоста, а не написанный в этом проекте демон.\n\n## Каждый вход заперт, и jail настоящий\n\nВход помещается в chroot, принадлежащий root jail, внутрь которого **примонтирован настоящий\nдомашний каталог аккаунта**. Отсюда два следствия, и оба задуманы намеренно:\n\n- Чтобы jail заработал, не пришлось менять владельца домашнего каталога, поэтому аккаунт по-прежнему\n  владеет своими файлами ровно так же, как раньше.\n- Изнутри не становится виден ни один другой аккаунт. Jail не просто каталог, в котором клиента просят\n  оставаться: другого каталога там просто нет.\n\nВход несёт собственный uid аккаунта, поэтому загруженный файл принадлежит аккаунту ровно так же, как\nсозданный им самим. Ему выдаётся `internal-sftp` и **никакого шелла**. Проверяется это тем,\nчто настоящей сессии отказывают в команде, а не наличием директивы в файле.\n\nПроброс портов выключен. Учётные данные для передачи файлов, умеющие пробрасывать порты, превращаются\nв туннель в приватную сеть сервера.\n\n## Сброс или удаление входа завершает его открытые сеансы\n\nПароль и открытые ключи входа проверяются при установке соединения и больше не проверяются для сеанса,\nкоторый сервер уже принял. Поэтому смена учётных данных сама по себе не отключила бы того, кто уже\nподключён по старым. Когда вы сбрасываете пароль входа, панель завершает все открытые сеансы этого входа,\nа при удалении входа делает это до его удаления. Загрузка, которая идёт в этот момент, обрывается на том\nбайте, до которого дошла, и неполный файл остаётся. Завершаются только сеансы этого входа; другие входы\nаккаунта не затрагиваются. Если сервер не смог подтвердить завершение сеансов, удаление отклоняется и его\nможно повторить, а сброс всё равно возвращает новый пароль, но записывает сбой в журнал аудита как\n**Завершены сеансы SFTP**, чтобы вы знали: старые сеансы могут быть ещё открыты.\n\n## Открытые ключи лежат вне jail\n\nТот же блок указывает, откуда читаются открытые ключи входа SFTP:\n`/etc/ssh/maran-sftp-keys/\u003Cвход>`, по одному принадлежащему root файлу на вход. Ключ, который клиент\nположит в свой домашний каталог, **никогда не читается**: файл, который решает, кто может войти, клиент\nзаписать не может.\n\nАгент сервера пишет этот файл из проверенного списка и ни из чего больше. Принимаются только\nEd25519, ECDSA и RSA от 2048 бит (и две формы аппаратных ключей); ключ с опцией вроде `command=\"…\"`\nотклоняется, а не чистится, и каждая строка пишется с `restrict`, так что ключ умеет передавать\nфайлы и ничего больше. Ключи приостановленного аккаунта убираются в сторону и возвращаются при\nвозобновлении: одного заблокированного пароля недостаточно, чтобы остановить вход по ключу.\n\nНа хостах, установленных до этого изменения, установщик нужно запустить ещё раз, чтобы появились\nстрока и каталог. Добавление ключей с экрана SFTP в панели в этот выпуск ещё не входит.\n\n## FTPS поставляется установленным и выключенным\n\nУстановщик ставит vsftpd, и FTPS работает целиком. Поставляется он **выключенным**: ничего не\nслушает, конфигурация не рендерится, а штатная служба дистрибутива замаскирована, пока\nадминистратор не включит FTPS из панели.\n\nВключение FTPS ждёт ответа vsftpd до 10 секунд, прежде чем оценивать результат. Если демон так и не\nответил, изменение откатывается: после неудачного первого включения конфигурации не остаётся, поэтому\nповторная попытка начинается с чистого листа, а не сообщает об успехе при остановленном демоне.\n\n### Строка шифрования говорит о том, что измерено\n\nВ состоянии FTPS-сервера есть строка **Шифрование**, прочитанная из конфигурации демона на хосте, а не из\nсобственной настройки панели. У неё три состояния:\n\n- **TLS обязателен для входа и передачи**: демон отклоняет вход или передачу, которые не зашифрованы.\n- **TLS необязателен: вход и передача могут идти без шифрования**: демон принимает и то и другое, поэтому\n  клиент, не запрашивающий TLS, отправляет пароль открытым текстом. Исправьте это, прежде чем открывать\n  сервер для пользователей.\n- **Не проверено: настройки не удалось прочитать**: агент не смог прочитать конфигурацию демона, поэтому\n  панель не утверждает ни того, ни другого. Это не предупреждение о том, что TLS выключен; проверьте, что\n  агент запущен, и обновите страницу.\n\nДля интеграций `GET /api/v1/ftps-server` передаёт это как `tlsEnforcement`: `enforced`, `notEnforced` или\n`notObserved`. Оно заменяет `forcedTls`, которое умело говорить только «да» или «нет», поэтому нечитаемую\nконфигурацию показывало как «нет».\n\nСказано прямо, потому что прежняя заметка о выпуске утверждала обратное (будто FTP-демон вообще не\nустанавливается), а оператор, который в это верит, не пойдёт искать его на своём хосте.\n\n## Резервные копии\n\nПлановые копии аккаунтов с политиками хранения запускаются из панели. Одного они не делают: не\nпокрывают удаление базы. См. [базы данных](/docs/databases), где удаление окончательно, а путь\nудаления ни к чему не обращается.\n\n### Когда плановая копия не удалась, администратор получает письмо\n\nРаньше каждый из этих случаев проходил молча, теперь каждый отправляет одно оповещение на адрес из\n**Исходящая почта** → **Отправлять оповещения на**, на английском, русском или армянском:\n\n- **Плановый запуск не удался**: он закончился без архива. Прежние копии аккаунта сохраняются.\n- **Место хранения отказало**: место хранения расписания нельзя было использовать, поэтому запуск\n  не начинался.\n- **Запуск пропущен**: расписание стартовало больше чем через 30 минут после назначенного часа,\n  обычно потому, что панель в тот час не работала. Панель, выключенная несколько ночей, догоняет\n  одним запуском и отправляет одно оповещение с первым пропущенным часом.\n\nКаждое оповещение записывается в журнал аудита как «Сработало оповещение», а если адрес для\nоповещений не задан, рядом записывается «Письмо не отправлено: нет настроек SMTP». Ручные копии\nписем не отправляют: тот, кто запустил копию, следит за её задачей. Пока не покрыто: проверка\nкаждого архива после записи. До тех пор повреждённый архив обнаруживается при восстановлении,\nкоторое проверяет каждый дамп базы перед загрузкой.\n\n## Что ничто не перепроверяет\n\nУстановщик пишет тот единственный блок `Match Group`, который превращает SFTP-аккаунт в запертый\nвход, и делает это идемпотентно. **Потом туда никто не смотрит.** Правленный руками `sshd_config`\nили сброшенный обновлением дистрибутива, потерявший этот блок, дал бы каждому клиенту передачи\nфайлов полноценную сессию с шеллом, а панель продолжала бы показывать все входы здоровыми.\n\nЕсли вы правите `sshd_config` на хосте с Maran, проверьте, что блок на месте.\n",{"title":66,"description":713},"Передача файлов и копии: jail и FTPS","ru/docs/file-transfer","7ZqD9ZI90cCRrtB39YjyNehPEsEcBxUl79QxvyVVum8",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":723},"\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>",1793873018554]