Обзор развертывания ISPmanager на сервере¶

Предварительные требования и базовые условия¶

Для развертывания ISPmanager требуется определенная операционная система и права root для выполнения скриптов установки и управления системными службами.

Операционная система: Ubuntu 22.04 LTS.
Права доступа: Требуется доступ root для установки пакетов, изменения системных конфигураций и запуска скрипта установки.
Сетевой доступ: Сервер должен иметь исходящий доступ в Интернет для загрузки установщика и зависимостей.
Конфигурация DNS: Для целевого домена должна быть настроена A-запись, указывающая на публичный IPv4-адрес сервера, чтобы обеспечить выпуск сертификата Let's Encrypt.

FQDN конечной панели¶

Полное доменное имя (FQDN) для панели ISPmanager формируется с использованием определенного префикса и идентификатора сервера. Формат соответствует шаблону <prefix><Server ID>.hostkey.in.

Зона: hostkey.in
Префикс: isp
Формат конечного домена: isp<Server ID>.hostkey.in
Порт доступа: 443 (HTTPS)

Процесс установки приложения¶

Приложение устанавливается с помощью официального скрипта установки ISPmanager (install.eu.sh). Процесс включает загрузку скрипта, его модификацию для обхода интерактивных запросов и выполнение с определенными параметрами.

Установка предварительных компонентов: Основные инструменты, такие как wget, curl, ca-certificates, gnupg, gpg и dnsutils, устанавливаются через apt.
Подготовка системы:
- AppArmor останавливается и отключается.
- Службы, связанные с APT (unattended-upgrades, apt-daily, apt-daily-upgrade), останавливаются, маскируются, а существующие блокировки удаляются для предотвращения конфликтов при установке.
Загрузка установщика: Скрипт загружается с https://download.ispmanager.com/install.eu.sh в /root/install.eu.sh.
Модификация скрипта: Скрипт установки патчится с помощью sed для автоматического ответа на интерактивные вопросы (выбор "s" для тихих/стандартных опций и "1" для значений по умолчанию).
Выполнение: Установщик запускается со следующими параметрами:
- --release stable: Устанавливает стабильную версию.
- --ignore-hostname: Позволяет выполнить установку независимо от имени хоста системы.
- --silent: Выполняет установку без интерактивных запросов.
- --dbtype mysql: Указывает MySQL в качестве типа базы данных.
- --mysql-server mariadb: Указывает MariaDB в качестве сервера базы данных.
- ispmanager-lite: Устанавливает версию ISPmanager Lite.
- --le-domain <domain>: Если DNS-разрешение соответствует публичному IP-адресу, SSL-сертификаты Let's Encrypt настраиваются автоматически. В противном случае используется --no-letsencrypt.

Базы данных¶

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

Тип базы данных: MySQL
Сервер базы данных: MariaDB
Место хранения: Стандартные каталоги данных MariaDB, управляемые системным менеджером пакетов.

Прокси-серверы и конфигурация SSL¶

Скрипт развертывания обеспечивает предоставление SSL-сертификатов на основе проверки DNS.

Поставщик SSL: Let's Encrypt.
Условие: Сертификаты выпускаются только в том случае, если A-запись для FQDN разрешается в публичный IPv4-адрес сервера.
Конфигурация: Установщик вызывается с параметром --le-domain для автоматизации настройки SSL для домена панели.

Доступные порты для подключения¶

Следующие порты настроены для доступа к панели ISPmanager:

Порт	Протокол	Назначение
443	HTTPS	Внешний доступ к панели ISPmanager.
1500	TCP	Внутренний порт управления (используется внутри приложения).

Запуск, остановка и обновление¶

Службы ISPmanager управляются через службу ispcp или прямое выполнение бинарного файла. Основной бинарный файл службы находится по пути /usr/local/mgr5/sbin/ispmgr.

Управление службой: Стандартные команды systemd можно использовать для управления службой ISPmanager, если установщик создает юнит systemd. В противном случае приложение работает как демон, управляемый собственными скриптами управления.
Журнал установки: Вывод процесса установки записывается в /root/isp_install.log.

Структура файлов и каталогов¶

Ключевые файлы и каталоги, созданные или измененные в ходе развертывания, включают:

Скрипт установки: /root/install.eu.sh
Журнал установки: /root/isp_install.log
Бинарный файл ISPmanager: /usr/local/mgr5/sbin/ispmgr
Файлы конфигурации: Расположены в структуре каталогов /usr/local/mgr5/, управляются самим приложением ISPmanager.