Обзор развертывания Proxmox на сервере¶
Предварительные требования¶
Для успешного развертывания приложения должны быть соблюдены следующие условия:
-
Операционная система: Debian (версии 11 Bullseye, 12 Bookworm или 13 Trixie).
-
Права доступа: права суперпользователя (
root) для установки системных пакетов и изменения конфигурации загрузчика. -
Сетевые настройки: наличие публичного IP-адреса и доступ к репозиториям Proxmox VE.
FQDN итоговой панели на домене hostkey.in¶
Для доступа к веб-интерфейсу управления используется следующий шаблон доменного имени:
| Параметр | Значение | | Префикс | proxmox | | Домен | hostkey.in | | Полный шаблон | proxmox{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В процессе работы создаются следующие директории и файлы:
-
/etc/apt/sources.list.d/pve-install-repo.list— файл с репозиторием Proxmox VE. -
/root/nginx/compose.yml— конфигурационный файл Docker Compose для прокси-сервера. -
/data/nginx/user_conf.d/— директория для пользовательских конфигураций Nginx. -
/data/nginx/letsencrypt/.well-known/acme-challenge/— директория для проверки SSL-сертификатов. -
/data/nginx/nginx-certbot.env— файл переменных окружения для контейнера Nginx.
Процесс установки приложения¶
Установка выполняется в несколько этапов и включает настройку ядра системы:
-
Подготовка загрузчика: Настройка
grub-pcдля корректного определения системного диска. -
Обновление системы: Отключение корпоративных репозиториев Proxmox (для использования бесплатных версий), обновление списка пакетов и выполнение полного обновления (
full-upgrade) текущей ОС. -
Настройка репозиториев: Добавление официального репозитория
pve-no-subscriptionи соответствующих GPG-ключей для обеспечения безопасности загрузки. -
Установка ядра Proxmox: Установка специализированного ядра (в зависимости от версии Debian:
pve-kernel-5.15,proxmox-default-kernelили аналогичных). Удаление стандартных ядер Debian для предотвращения конфликтов при загрузке. -
Установка компонентов виртуализации: Установка пакета
proxmox-ve, почтового сервераpostfixи клиентаopen-iscsi. -
Настройка системных служб: Установка и запуск
chronyдля синхронизации времени (на Debian 12+). Обновление конфигурации загрузчика черезupdate-grub.
Права доступа и безопасность¶
-
Удален пакет
os-proberдля повышения безопасности процесса загрузки. -
Настроен брандмауэр и системные ограничения для Docker (параметр
Delegate=yesв системной службе). -
Конфигурационные файлы Nginx имеют права доступа
0644, а директории —0755.
Базы данных¶
В данной конфигурации база данных не развертывается как отдельный сервис, так как Proxmox является гипервизором.
Контейнеры Docker и их запуск¶
Для обеспечения безопасного доступа через SSL используется контейнерный прокси-сервер:
| Имя образа | Порты (внутри сети хоста) | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | 80, 443 (через host mode) | 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 |
Кастомные скрипты и дополнительные настройки¶
После установки основного ПО выполняется автоматическая настройка проксирования:
-
Скрипт на языке Python динамически редактирует конфигурационные файлы Nginx в директории
/data/nginx/user_conf.d/. -
В конфигурацию добавляется блок для проверки SSL-сертификатов через
.well-known/acme-challenge/. -
Настраивается проксирование трафика на внутренний порт Proxmox (
https://127.0.0.1:8006) с включенным параметромproxy_ssl_server_name onи отключенной проверкой сертификата для обеспечения корректной работы через HTTPS.
Инструкция по обновлению приложения¶
Для обновления системы необходимо выполнить следующие действия:
-
Обновить список пакетов:
apt update. -
Выполнить полное обновление системных компонентов и ядра:
apt full-upgrade -y. -
Перезагрузить сервер для применения изменений в ядре.
Расположение конфигурационных файлов и данных¶
-
Конфигурация проксирования:
/data/nginx/user_conf.d/{prefix}{Server_ID_from_Invapi}.hostkey.in.conf. -
Данные SSL-сертификатов: том
nginx_secretsвнутри контейнера Nginx. -
Переменные окружения Nginx:
/data/nginx/nginx-certbot.env.
Доступные порты для подключения¶
| Порт | Протокол | Назначение |
|---|---|---|
| 443 | HTTPS | Веб-интерфейс управления (через прокси) |
| 8006 | HTTPS | Внутренний порт Proxmox VE |
Запуск, остановка приложения¶
Управление прокси-сервером осуществляется через Docker Compose:
-
Запуск:
docker compose up -d(в директории/root/nginx). -
Проверка конфигурации Nginx:
docker exec nginx-nginx-1 nginx -t.