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

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

Предварительные требования

Для успешного развертывания приложения должны быть соблюдены следующие условия:

  • Операционная система: Debian, Ubuntu, CentOS, Rocky Linux или AlmaLinux.

  • Чистая ОС: Система должна быть чистой. Наличие предустановленных пакетов MySQL или MariaDB приведет к ошибке установки.

  • Доступ: Права суперпользователя (root) для выполнения установочных скриптов.

  • Сеть: Доступ к репозиториям Ubuntu/Debian и возможность работы через IPv4.

FQDN итоговой панели на домене hostkey.in

Параметр Значение
Префикс fastpanel
Домен hostkey.in
Полный шаблон fastpanel{Server_ID_from_Invapi}.hostkey.in

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

В процессе развертывания создаются следующие директории:

  • /root/nginx — файлы конфигурации Docker Compose для прокси-сервера.

  • /data/nginx — основные рабочие директории Nginx.

  • /data/nginx/user_conf.d — пользовательские конфигурационные файлы сайтов и доменов.

  • /data/nginx/letsencrypt/.well-known/acme-challenge — директория для прохождения проверки Certbot.

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

Процесс развертывания зависит от используемой операционной системы:

Для систем на базе Debian/Ubuntu:

  1. Настройка репозиториев apt: принудительное использование IPv4 и установка таймаутов для предотвращения зависаний.

  2. Переключение зеркал apt на зеркало Yandex для повышения стабильности загрузки.

  3. Обновление кэша пакетов и установка утилит wget и ca-certificates.

  4. Проверка системы на наличие установленных компонентов MySQL/MariaDB (установка прерывается, если они найдены).

  5. Загрузка и запуск установочного скрипта из официального репозитория FastPanel: https://repo.fastpanel.direct/install/debian.sh.

Для систем на базе RHEL (CentOS, Rocky, AlmaLinux):

  1. Установка пакета wget.

  2. Загрузка и выполнение установочного скрипта из http://repo.fastpanel.direct/install_fastpanel.sh.

После завершения установки создается пользователь fastuser с обновленным паролем.

Права доступа и безопасность

  • Для обеспечения безопасности используется настройка брандмауэра (в рамках стандартной настройки ОС).

  • Все конфигурационные файлы в директориях /data/nginx/ имеют права 0644.

  • Директории создаются с владельцем root и группой root.

Контейнеры Docker и их запуск

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

Имя образа Порты Тома (volumes) Переменные окружения Политика перезапуска
jonasal/nginx-certbot:latest host (443, 80) nginx_secrets:/etc/letsencrypt
/data/nginx/user_conf.d:/etc/nginx/user_conf.d
/data/nginx/letsencrypt:/var/www/letsencrypt
CERTBOT_EMAIL=hkadm@hostkey.com
Параметры из /data/nginx/nginx-certbot.env
unless-stopped

Контейнер работает в режиме network_mode: host, что позволяет ему напрямую использовать порты сервера и взаимодействовать с локальными сервисами через host.docker.internal.

Кастомные скрипты и дополнительные настройки

В процессе развертывания выполняются следующие действия по настройке окружения:

  • Настройка Nginx для ACME: Создается временная конфигурация Nginx, которая разрешает только HTTP-трафик для прохождения проверки владения доменом через директорию .well-known/acme-challenge.

  • Получение SSL-сертификатов: После успешной проверки домена выполняется команда certbot certonly внутри контейнера Nginx.

  • Перенаправление трафика: После получения сертификатов конфигурация Nginx обновляется: устанавливается принудительное перенаправление с HTTP на HTTPS и настраивается проксирование (proxy_pass) на внутренний порт панели 127.0.0.1:8888.

Инструкция по обновлению приложения

Обновление основного приложения FastPanel осуществляется путем повторного запуска установочного скрипта или через стандартные механизмы управления пакетами, в зависимости от версии ОС. Для обновления прокси-сервера Nginx используется команда: docker compose pull && docker compose up -d (в директории /root/nginx).

Расположение конфигурационных файлов и данных

Тип файла Путь к файлу
Конфигурация Docker Compose /root/nginx/compose.yml
Переменные окружения Nginx /data/nginx/nginx-certbot.env
Пользовательские конфиги доменов /data/nginx/user_conf.d/{domain}.conf
Данные SSL (сертификаты) В томе nginx_secrets

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

  • 443 (HTTPS) — основной порт для доступа к панели управления через веб-интерфейс.

  • 8888 — внутренний порт приложения FastPanel.

Запуск, остановка приложения

Управление прокси-сервером осуществляется через Docker Compose в директории /root/nginx:

  • Запуск: docker compose up -d

  • Остановка: docker compose down

  • Перезагрузка конфигурации Nginx: docker exec nginx-nginx-1 nginx -s reload

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