Обзор развертывания Easypanel на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие условия:
-
Операционная система: Ubuntu.
-
Доступ к интернету для загрузки компонентов.
-
Свободные порты
80и443. -
Права суперпользователя (
root) для выполнения установочных скриптов.
FQDN итоговой панели на домене hostkey.in¶
Для доступа к интерфейсу управления используется следующий шаблон доменного имени:
| Параметр | Значение |
|---|---|
| Префикс | easypanel |
| Домен | hostkey.in |
| Полный шаблон | easypanel{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В процессе развертывания создаются и используются следующие директории:
-
/root/nginx— рабочая директория для конфигурации прокси-сервера. -
/data/nginx/user_conf.d— каталог с конфигурационными файлами Nginx. -
/data/nginx/nginx-certbot.env— файл переменных окружения для SSL. -
/opt/traefik/dynamic— директория для динамических конфигураций Traefik. -
/opt/traefik/acme.json— файл хранения сертификатов Let's Encrypt.
Процесс установки приложения¶
Развертывание Easypanel выполняется в несколько этапов:
-
Подготовка системы:
-
Остановка и отключение системных служб
nginxиapache2, если они установлены. -
Завершение работы Docker Swarm (если он активен).
-
Остановка всех контейнеров, занимающих порты
80и443. -
Установка Easypanel:
-
Выполняется через официальный установочный скрипт:
-
Настройка проксирования:
-
Создается конфигурационный файл
compose.ymlдля управления SSL-сертификатами. -
В конфигурационные файлы Nginx вносятся изменения для перенаправления трафика на внутренний порт приложения (
127.0.0.1:3000).
Права доступа и безопасность¶
-
Все создаваемые директории (например,
/root/nginx) имеют права0755. -
Конфигурационные файлы в
/root/nginxустанавливаются с правами0644. -
Приложение работает под управлением Docker, что обеспечивает изоляцию процессов.
Базы данных¶
В данной конфигурации база данных не развертывается как отдельный системный сервис, а должна быть настроена внутри самой панели Easypanel после завершения установки.
Контейнеры Docker и их запуск¶
Приложение использует следующий контейнер для обеспечения работы веб-сервиса с SSL:
| Имя образа | Порты | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | host mode | nginx_secrets:/etc/letsencrypt, /data/nginx/user_conf.d:/etc/nginx/user_conf.d | CERTBOT_EMAIL=hkadm@hostkey.com | unless-stopped |
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Очистка портов
80и443от любых запущенных контейнеров перед началом установки. -
Автоматическое создание конфигурационных файлов для Nginx, обеспечивающих проксирование на локальный адрес
http://127.0.0.1:3000.
Инструкция по обновлению приложения¶
Для обновления Easypanel необходимо использовать стандартную команду обновления Docker-контейнеров (если приложение запущено в контейнере) или запустить установочный скрипт повторно для получения актуальной версии компонентов.
Расположение конфигурационных файлов и данных¶
-
Конфигурация проксирования:
/data/nginx/user_conf.d/easypanel{Server_ID_from_Invapi}.hostkey.in.conf. -
Данные сертификатов:
nginx_secrets(внешний том Docker).
Доступные порты для подключения¶
| Порт | Протокол | Назначение |
|---|---|---|
443 | HTTPS | Основной доступ к панели управления через домен |
80 | HTTP | Перенаправление на HTTPS |
3000 | TCP | Внутренний порт приложения (доступен локально) |
Запуск, остановка приложения¶
Управление основным приложением осуществляется через интерфейс Easypanel или стандартные команды управления контейнерами Docker. Для перезапуска прокси-сервера используется:
Прокси серверы¶
Для обеспечения доступа по HTTPS и автоматического получения SSL-сертификатов используются:
-
Nginx (через jonasal/nginx-certbot): выступает в обратного прокси для терминации SSL.
-
Traefik: используется для динамической маршрутизации трафика внутри системы.