Перейти к содержанию

Обзор развертывания 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 выполняется в несколько этапов:

  1. Подготовка системы:

  2. Остановка и отключение системных служб nginx и apache2, если они установлены.

  3. Завершение работы Docker Swarm (если он активен).

  4. Остановка всех контейнеров, занимающих порты 80 и 443.

  5. Установка Easypanel:

  6. Выполняется через официальный установочный скрипт:

    curl -sSL https://get.easypanel.io | sh
    

  7. Настройка проксирования:

  8. Создается конфигурационный файл compose.yml для управления SSL-сертификатами.

  9. В конфигурационные файлы 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. Для перезапуска прокси-сервера используется:

docker compose restart nginx

Прокси серверы

Для обеспечения доступа по HTTPS и автоматического получения SSL-сертификатов используются:

  • Nginx (через jonasal/nginx-certbot): выступает в обратного прокси для терминации SSL.

  • Traefik: используется для динамической маршрутизации трафика внутри системы.

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×