Обзор развертывания Easypanel на сервере¶
Предварительные требования¶
Для корректной работы приложения и его сетевой доступности должны быть соблюдены следующие условия:
-
Операционная система: Ubuntu.
-
Доступные порты: 80 (HTTP) и 443 (HTTPS).
-
Права доступа: Права суперпользователя (root) для выполнения установочных скриптов и управления Docker.
FDQN итоговой панели на домене hostkey.in¶
Для доступа к интерфейсу управления используется динамически формируемый поддомен.
| Параметр | Значение |
|---|---|
| Префикс | easypanel |
| Домен | hostkey.in |
| Полный шаблон | easypanel{Server_ID}.hostkey.in |
Процесс установки приложения¶
Установка Easypanel выполняется в несколько этапов с использованием официального установочного скрипта и настройки проксирования:
-
Подготовка системы:
-
Остановка и отключение системных служб
nginxиapache2, если они установлены. -
Принудительный выход из режима Docker Swarm (если он активен).
-
Остановка всех контейнеров, занимающих порты 80 и 443.
-
Установка приложения: Выполняется запуск официального установочного скрипта:
curl -sSL https://get.easypanel.io | sh -
Настройка проксирования: Создается конфигурация для Nginx, которая перенаправляет входящий трафик на внутренний порт приложения (порт 3000).
Контейнеры Docker и их запуск¶
В системе развернут дополнительный контейнер для управления SSL-сертификатами:
| Параметр | Значение |
|---|---|
| Имя образа | jonasal/nginx-certbot:latest |
| Режим сети | host |
| Переменные окружения | CERTBOT_EMAIL=hkadm@hostkey.com |
| Тома (volumes) | nginx_secrets:/etc/letsencrypt, /data/nginx/user_conf.d:/etc/nginx/user_conf.d |
| Политика перезапуска | unless-stopped |
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Настройка Nginx: В конфигурационные файлы в директории
/data/nginx/user_conf.d/вносятся изменения для перенаправления трафика (proxy_pass) наhttp://127.0.0.1:3000. -
Управление сертификатами: Используется механизм Certbot через контейнер Nginx для автоматического получения SSL-сертификатов.
Расположение конфигурационных файлов и данных¶
Основные данные и настройки распределены по следующим путям:
-
/root/nginx/compose.yml— конфигурация контейнера управления сертификатами. -
/data/nginx/user_conf.d/— пользовательские конфигурации Nginx. -
/data/nginx/nginx-certbot.env— файл переменных окружения для Certbot. -
/etc/traefik/acme.json— хранилище SSL-сертификатов (через Traefik).
Доступные порты для подключения¶
| Порт | Протокол | Назначение |
|---|---|---|
| 80 | HTTP | Перенаправление на HTTPS |
| 443 | HTTPS | Основной интерфейс управления Easypanel |
| 3000 | TCP | Внутренний порт приложения (доступен локально) |
Запуск, остановка приложения¶
Управление основным приложением осуществляется через стандартные команды Docker:
-
Просмотр состояния контейнеров:
docker ps -
Остановка сервисов: Приложение Easypanel управляется через его собственный интерфейс или через управление Docker-контейнерами.