Обзор развертывания 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:
-
Настройка репозиториев
apt: принудительное использование IPv4 и установка таймаутов для предотвращения зависаний. -
Переключение зеркал
aptна зеркало Yandex для повышения стабильности загрузки. -
Обновление кэша пакетов и установка утилит
wgetиca-certificates. -
Проверка системы на наличие установленных компонентов MySQL/MariaDB (установка прерывается, если они найдены).
-
Загрузка и запуск установочного скрипта из официального репозитория FastPanel:
https://repo.fastpanel.direct/install/debian.sh.
Для систем на базе RHEL (CentOS, Rocky, AlmaLinux):
-
Установка пакета
wget. -
Загрузка и выполнение установочного скрипта из
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