Перейти к основному контенту

Установка MaxKB

Системные требования для установки MaxKB:

  • Операционная система: Linux с поддержкой работы Docker
  • CPU/память: 4C/8GB или более
  • Пространство диска: 100GB

Онлайн установка с помощью 1Panel

Что такое 1Panel?

1Panel — это современная веб-панель управления Linux-сервером с открытым исходным кодом, предоставляющая интуитивно понятный графический интерфейс для комплексного администрирования: мониторинга хоста, управления файлами, базами данных, контейнерами, веб-сайтами и LLM-моделями, а также автоматического развертывания сайтов и приложений через встроенный магазин приложений и один клик установки популярных сервисов.

Для AI-систем и решений 1Panel полезна как единая платформа управления инфраструктурой и AI-сервисами, предоставляя следующие возможности:

  • Управление LLM-сервисами: развертывание и администрирование LLM-движков (например, Ollama, LocalAI, vLLM) через контейнеры, контроль их состояния и ресурсов.

  • Поддержка MCP (Model Context Protocol): использование MCP Server для подключения LLM-агентов к инструментам, сервисам и данным сервера, что упрощает создание автономных и агентных AI-решений.

  • Развёртывание MaxKB: быстрая установка и эксплуатация MaxKB для построения RAG-систем, корпоративных чат-ботов и AI-ассистентов с базами знаний и workflow-логикой.

  • Мониторинг ресурсов AI-нагрузок: контроль CPU, GPU, памяти и дисков для стабильной работы моделей и сервисов.

  • Управление данными и хранилищами: администрирование баз данных и файлов, используемых AI-приложениями, включая данные для обучения и inference.

  • Безопасность и изоляция: контейнеризация, управление фаерволом и логами для защиты AI-сервисов и API.

  • Резервное копирование и восстановление: защита моделей, конфигураций и баз знаний с поддержкой облачных хранилищ.

В совокупности это делает 1Panel удобной платформой для быстрого запуска, масштабирования и промышленной эксплуатации современных AI-решений.

Установка 1Panel

Для онлайн установки 1Panel выполните команду от root:

bash -c "$(curl -sSL https://resource.1panel.pro/quick_start.sh)"

После завершения установки вы увидите в консоли URL, логин и пароль для авторизации в веб-интерфейс 1Panel:

изображение.png

Обратите внимания на то, что URL генерируется с рандомным значением после / , именно в таком виде и нужно вводить URL в браузер.

Установка MaxKb через 1Panel

В интерфейсе 1Panel в основном меню слева выберите App Store, в разделе выберите вкладку AI, найдите в списке приложений MaxKb и нажмите Install:

изображение.png

В открывшемся окне вы можете выбрать версию MaxKb и порт, главное поставьте галочку "External Access" чтобы приложение MaxKB было доступно по сети, нажмите кнопку Confirm и дождитесь завершения установки.

изображение.png

Авторизуйтесь в интерфейс MaxKb
Адрес интерфейса по умолчанию: http://<1Panel_IP>:8080
Логин: admin
Пароль:  MaxKB@123..   (да, пароль содержит 2 точки в конце! :)   

Оффлайн установка из дистрибутива

Запросите у нас актуальный дистрибутив для установки и скачайте архив с дистрибутивом в папку /opt/ на вашем сервере, разархивируйте:

tar -zxvf maxkb-v2.4.1-x86_64-offline-installer.tar.gz
Изменение настроек по умолчанию

При необходимости отредактируйте конфигурационный файл установки

cd maxkb-v2.4.1-x86_64-offline-installer.tar.gz
nano install.conf

Описание параметров файла установки:

# Базовая конфигурация
## Каталог установки
MAXKB_BASE=/opt
## Порт сервиса
MAXKB_PORT=8080
## Настройка подсети Docker
MAXKB_DOCKER_SUBNET=172.31.250.192/26

# Конфигурация базы данных
## Использовать ли внешнюю базу данных
MAXKB_EXTERNAL_PGSQL=false
## Адрес базы данных
MAXKB_PGSQL_HOST=pgsql
## Порт базы данных
MAXKB_PGSQL_PORT=5432
## Имя базы данных
MAXKB_PGSQL_DB=maxkb
## Имя пользователя базы данных
MAXKB_PGSQL_USER=root
## Пароль базы данных
MAXKB_PGSQL_PASSWORD=Password123@postgres

# Конфигурация Redis
## Использовать ли внешний Redis
MAXKB_EXTERNAL_REDIS=false
## Адрес Redis
REDIS_HOST=redis
## Порт Redis
REDIS_PORT=6379
## База данных Redis
REDIS_DB=0
## Пароль Redis
REDIS_PASSWORD=Password123@redis

# Конфигурация образов
## Репозиторий образов
MAXKB_IMAGE_REPOSITORY=registry.fit2cloud.com/maxkb
## Имя образа
MAXKB_IMAGE=maxkb
## Версия
MAXKB_VERSION=v2.4.1

MAXKB_PGSQL_PORT, REDIS_PORT действителен только для использования внешних баз данных, если вы используете встроенную базу данных, пожалуйста, не изменяйте.

Если вам нужно снова изменить параметры конфигурации после установки, вам необходимо изменить файл ${MAXKB_BASE}/maxkb/.env (по умолчанию /opt/maxkb/.env), после изменения параметров выполнить команду:

mkctl reload

Эта команда перезагружает файл конфигурации. Команда mkctl restart - перезапустит сервис, но НЕ применит новую конфигурацию.

Установка MaxKB
cd maxkb-v2.4.1-x86_64-offline-installer
bash install.sh

и дождитесь завершения установки и авторизуйтесь в интерфейс MaxKb: 

Адрес интерфейса по умолчанию: http://<IP>:8080
Логин: admin
Пароль:  MaxKB@123..   (да, пароль содержит 2 точки в конце! :)   

Наверх