...

AKR Updater

1.7.3

...

💻 Команда установки
curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash

Это практическое руководство подробно описывает пошаговое использование программного обеспечения: от знакомства с веб-интерфейсом до настройки ваших первых запланированных задач. Вы также научитесь связывать свой аккаунт Discord для управления перезагрузками удаленно.

Перед запуском развертывания приложения узнайте, как быстро и правильно настроить ваш хост. Вся процедура основана на единственной shell-команде, выполняемой в вашем терминале Linux.

Установка

1

Подготовка среды Linux

Запустите систему Linux или создайте чистый, выделенный контейнер LXC для размещения службы. Убедитесь, что у вас есть доступ к терминалу с правами администратора sudo и активное сетевое соединение для загрузки необходимых файлов.

2

Выполнение команды установки

Откройте терминал и вставьте следующую точную команду: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Подтвердите выполнение, чтобы запустить официальный скрипт автоматической установки.

3

Ожидание автоматической настройки

Позвольте процессу установки развернуть файлы и настроить фоновые службы. Скрипт работает автономно и за несколько секунд подготовит компоненты, необходимые для работы системы.

4

Проверка сетевых портов

Проверьте, доступен ли порт TCP 8080 из вашей локальной сети, или разрешите его в правилах брандмауэра. Этот порт необходим для взаимодействия с графическим интерфейсом администратора, размещенным в программе.

5

Доступ к веб-панели управления

Запустите веб-браузер и перейдите по IP-адресу вашего сервера, добавив порт 8080 (например, http://IP_SERVER:8080). Вы попадете на главный экран панели, предназначенной для управления вашими серверами.

6

Добавление первого удаленного сервера

Через веб-панель зарегистрируйте свою первую целевую машину, указав её адрес и учетные данные, необходимые для начальной связки. Система сгенерирует зашифрованный SSH-ключ, обеспечивающий защищенный доступ для будущих операций обслуживания.

Руководство пользователя

Навигация в веб-панели управления

Панель управления, доступная через порт 8080, централизует состояние всех ваших зарегистрированных машин. Там вы можете наблюдать за общим статусом вашего парка, проверять последние выполненные операции и просматривать полную историю действий. Это пространство является нервным центром для координации ваших технических вмешательств без необходимости открывать несколько SSH-сессий.

Планирование задач и TRIM SSD

В разделе планирования определите частоту, с которой должны проверяться и обновляться ваши системные пакеты. Вы также можете включить оптимизацию trim SSD для поддержания высокой производительности на ваших флэш-накопителях. После сохранения рутина будет автоматически выполняться в фоновом режиме в соответствии с установленным графиком.

Настройка оповещений и бота Discord

Для удаленного контроля настройте каналы оповещений, введя вебхук Discord или активировав встроенного бота. В режиме бота вы будете получать подробные карточки после каждого выполнения задачи. Эти расширенные уведомления включают интерактивные кнопки, позволяющие перезапустить машину или запланировать её перезагрузку одним кликом.

Администрирование экземпляров NetBird

Если ваша инфраструктура основана на NetBird, программное обеспечение поддерживает управление версиями ваших компонентов. Вы можете применять обновления как к клиенту, так и к инфраструктуре NetBird SelfHosted непосредственно через инструмент. Эта встроенная интеграция обеспечивает согласованность версий вашей overlay-сети без сложных ручных манипуляций.

Мониторинг журналов и отслеживаемость

Регулярно просматривайте историю операций в интерфейсе, чтобы проверять действия, выполненные на ваших машинах. В случае аномалий в работе сервиса после обновления журнал позволяет точно проверить, какие пакеты были обработаны и в какое время. Эта прозрачность облегчает анализ и профилактическое обслуживание ваших сред.

Эти советы по использованию были сформулированы, чтобы помочь вам получить максимальную отдачу от вашей панели управления и оптимизировать безопасность вашего парка серверов. Применяйте эти рекомендации для сохранения стабильности ваших сред Linux.

Советы

Используйте выделенный контейнер LXC

Установите инструмент внутри пустой инстанции LXC, чтобы изолировать администрирование серверов от ваших текущих прикладных нагрузок. Это упрощает создание общих резервных копий и сохраняет целостность вашего сервера мониторинга.

Планируйте задачи вне часов пиковой активности

Запланируйте циклы обновлений и trim SSD на ночное время. Так вы избежите непредвиденных замедлений диска или кратковременной недоступности сервисов для ваших пользователей.

Используйте интерактивные кнопки Discord

Настройте режим бота Discord, а не пассивный вебхук, чтобы получить доступ к интерактивным кнопкам перезагрузки. Это позволит вам подтвердить перезапуск системы с мобильного устройства без входа в панель управления.

Следите за пакетами ядра

Обращайте внимание на уведомления об обновлении ядра Linux. Сразу планируйте быструю перезагрузку хоста, чтобы загрузить новую безопасную версию, не оставляя машину в промежуточном состоянии.

Проверяйте свои зарегистрированные SSH-ключи

Поскольку инструмент автоматически шифрует сгенерированные SSH-ключи, не изменяйте вручную права доступа к папкам с ключами на целевых машинах. Позвольте инструменту управлять своим доступом, чтобы избежать разрыва связи.

Централизуйте ваши узлы NetBird

Объедините мониторинг ваших клиентов NetBird и вашего сервера SelfHosted на одной панели управления. Это гарантирует идеальную однородность протоколов и ограничивает риски несовместимости версий сети.

Проверяйте историю перед любыми важными изменениями

Перед установкой нового тяжелого приложения на удаленный сервер проверьте в истории, что последнее обслуживание завершилось без ошибок. Таким образом, вы начинаете работу с идеально чистой и актуальной программной базы.

Проверяйте доступность порта 8080

Если вы управляете машинами через удаленную сеть, подумайте о том, чтобы разместить веб-панель за защищенным туннелем или строго фильтровать IP-адреса, которым разрешено подключаться к порту 8080.

В случае непредвиденных проблем при доступе к веб-панели или при связи с удаленной машиной обратитесь к этому разделу устранения неполадок. Он объединяет конкретные решения для наиболее часто встречающихся технических препятствий.

Устранение неполадок

⚠️ Веб-интерфейс на порту 8080 не загружается после установки
Проверьте, активна ли служба на хост-машине, просмотрев текущие процессы в терминале. Убедитесь, что локальный брандмауэр не блокирует подключения к порту 8080 и что используемый IP-адрес доступен с вашего рабочего места.
⚠️ Ошибка подключения при добавлении новой целевой машины
Проверьте, доступен ли удаленный сервер по сети и правильно ли работает на нем служба SSH. Убедитесь, что введенные временные учетные данные администратора верны, чтобы ПО могло развернуть свой начальный зашифрованный ключ.
⚠️ Оповещения Discord не приходят в чат
Проверьте URL вебхука или токен бота Discord, настроенный в параметрах панели. Убедитесь, что целевой текстовый канал предоставляет боту права на запись и отправку сообщений с расширенными вложениями (embeds).
⚠️ Интерактивные кнопки Discord не запускают перезагрузку
Убедитесь, что вы используете режим бота Discord, а не простой вебхук, так как последний не поддерживает интерактивность. Также проверьте, не заблокирован ли исходящий трафик с вашего хоста к API Discord.
⚠️ Операция trim SSD не выполняется на конкретном сервере
Проверьте, основано ли хранилище целевой машины на SSD-накопителе, совместимом с командой fstrim. В случае виртуальной машины или контейнера на гипервизоре должна быть включена опция эмуляции SSD или доступ к командам discard.
⚠️ Обновление NetBird SelfHosted зависло
Проверьте журналы истории в веб-интерфейсе, чтобы выявить возможные конфликты пакетов или контейнеров. Убедитесь, что у инстанции NetBird достаточно дискового пространства для загрузки и распаковки новых бинарных файлов.
⚠️ Прерывание команды curl при начальной установке
Проверьте стабильность вашего интернет-соединения и убедитесь, что пакеты curl и sudo установлены в вашей базовой системе. Затем повторно запустите команду curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash в вашем терминале.
⚠️ Запланированная перезагрузка не выполнилась в назначенное время
Проверьте синхронизацию времени (часовой пояс и службу NTP) между сервером, на котором запущен Updater, и удаленной машиной. Разница во времени может отложить выполнение запланированных задач.

Ознакомьтесь с аппаратными и системными требованиями, необходимыми для обеспечения оптимальной работы веб-панели и её фоновых задач. Созданный для максимальной экономичности, инструмент адаптируется к скромным аппаратным конфигурациям.

Требования

Минимум

ОССовременный дистрибутив Linux (рекомендуется в новом контейнере LXC)
ЦПУ1-ядерный 64-битный процессор
ОЗУ512 МБ оперативной памяти
Диск1 ГБ свободного места
СетьДоступ в Интернет для загрузки файлов и репозиториев пакетов

Рекомендуется

ОССовременный дистрибутив Linux в выделенном контейнере LXC
ЦПУ2-ядерный процессор
ОЗУ1 ГБ оперативной памяти или больше
Диск5 ГБ свободного места для истории и журналов
СетьВысокоскоростное соединение и открытый порт 8080 в локальной сети