Обзор развертывания ISPConfig на сервере¶
Предварительные требования¶
Для корректной работы панели управления необходимы следующие параметры и настройки системы:
-
Операционная система: Ubuntu или Debian.
-
Доменное имя: Требуется настроенный FQDN (полное доменное имя).
-
Порты:
-
22/tcp— SSH доступ. -
80/tcp— HTTP трафик. -
443/tcp— HTTPS трафик. -
8080/tcp— Внутренний порт панели управления ISPConfig.
FQDN итоговой панели на домене hostkey.in¶
Для доступа к интерфейсу используется следующий шаблон домена:
| Параметр | Значение |
|---|---|
| Префикс | ispconfig |
| Домен | hostkey.in |
| Полный шаблон | ispconfig{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В процессе развертывания создаются и используются следующие директории:
-
/usr/local/ispconfig— основные файлы приложения ISPConfig. -
/etc/nginx/sites-available/— конфигурационные файлы веб-сервера Nginx. -
/etc/nginx/sites-enabled/— активные конфигурации веб-сервера. -
/root/nginx— рабочая директория для Docker-контейнера с прокси-сервером. -
/data/nginx/user_conf.d/— пользовательские конфигурации Nginx.
Процесс установки приложения¶
Установка выполняется комбинированным методом: через системный автоустановщик и настройку окружения PHP.
-
Подготовка системы: Обновление кэша APT, установка базовых утилит (
wget,curl,ca-certificates,tarи др.) и настройка параметров хоста (hostname) в/etc/hosts. -
Установка Docker: Установка среды выполнения контейнеров для работы прокси-сервера.
-
Развертывание базы данных: Загрузка и запуск образа MariaDB из корпоративного репозитория.
-
Запуск автоустановщика ISPConfig: Выполняется скрипт
ispconfig.ai.phpс параметрами для автоматической настройки (без модулей почты, DNS и FTP, если не указано иное). -
Настройка PHP-FPM: Установка и запуск PHP версии 8.3 для обеспечения работы веб-интерфейса панели.
-
Конфигурация Nginx: Создание виртуального хоста (vhost) для ISPConfig, который перенаправляет трафик на локальный порт
8080.
Права доступа и безопасность¶
Безопасность системы обеспечивается следующими мерами:
-
Брандмауэр (UFW): Включен по умолчанию. Разрешены входящие соединения на порты
22,80,443и8080. -
Пользователь веб-сервера: Для работы интерфейса используется пользователь
www-data. -
Ограничение доступа: Файлы конфигурации (например,
config.inc.php) имеют права доступа0640, позволяя пользователюwww-dataтолько чтение.
Базы данных¶
Для работы панели используется база данных MariaDB:
-
Имя базы данных:
dbispconfig. -
Пользователь БД:
ispconfig. -
Локальное подключение: Панель подключается к базе через
localhost:3306.
Контейнеры Docker и их запуск¶
Для обеспечения работы SSL-сертификатов используется контейнерный прокси-сервер.
| Имя образа | Порты (Host:Container) | Тома (Volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | 80, 443 -> 80, 443 (режим host) | nginx_secrets:/etc/letsencrypt, /data/nginx/user_conf.d:/etc/nginx/user_conf.d | CERTBOT_EMAIL=hkadm@hostkey.com | unless-stopped |
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Настройка проксирования: В конфигурационные файлы Nginx вносятся изменения для перенаправления запросов с порта
443на внутренний порт панели8080. -
Управление сертификатами: Использование контейнера Certbot через Nginx для автоматического получения SSL-сертификатов.
Инструкция по обновлению приложения¶
Для обновления основного приложения используется стандартный механизм:
-
Если приложение развернуто в Docker, необходимо выполнить команду:
docker compose pull && docker compose up -d(в директории/root/nginx). -
При использовании системных пакетов обновление выполняется через менеджер пакетов:
apt-get update && apt-get upgrade.
Расположение конфигурационных файлов и данных¶
-
Конфигурация панели:
/usr/local/ispconfig/interface/lib/config.inc.php. -
Конфигурация Nginx (прокси):
/data/nginx/user_conf.d/{prefix}{Server_ID_from_Invapi}.hostkey.in.conf.
Доступные порты для подключения¶
-
443— основной защищенный доступ через HTTPS. -
8080— внутренний порт панели управления.
Запуск, остановка приложения¶
Управление состоянием веб-сервера и панелью осуществляется через системные службы:
-
Перезагрузка конфигурации Nginx:
systemctl reload nginx. -
Проверка конфигурации Nginx:
nginx -t.