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

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

Для корректной работы панели управления необходимо обеспечить выполнение следующих условий:

• Операционная система: Ubuntu.

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

• Доменное имя: Наличие настроенного домена или поддомена для доступа к панели.

• Порты: Должен быть открыт порт 2087 для доступа к интерфейсу управления.

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

Для доступа к панели используется следующий шаблон доменного имени:

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

Установка OpenPanel выполняется с помощью автоматизированного установочного скрипта. Процесс включает следующие этапы:

1. Проверка системы: Проверяется наличие уже установленных компонентов OpenPanel (директории /etc/openpanel, /usr/local/admin или /usr/local/opencli).

2. Загрузка установщика: С официального ресурса https://openpanel.org загружается установочный скрипт в директорию /root/installation_script.sh.

3. Валидация: Проверяется целостность и синтаксис скачанного скрипта перед запуском.

4. Запуск установки: Выполняется основной процесс развертывания с передачей параметров домена, имени пользователя (admin) и пароля. Если в системе обнаружены следы предыдущей частичной установки, запускается режим восстановления (--repair).

5. Ожидание завершения: Система ожидает появления конфигурационного файла Caddyfile по пути /etc/openpanel/caddy/Caddyfile.

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

В процессе работы приложения используется контейнерная среда для обеспечения веб-сервера:

• Контейнер Caddy:

• Назначение: Веб-сервер и управление SSL-сертификатами.

• Действие при настройке: После завершения установки выполняется перезапуск контейнера caddy для применения изменений в конфигурации.

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

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

• Оптимизация конфигурации Caddy:

• Удаление устаревших интервалов из параметра on_demand_tls в файле /etc/openpanel/caddy/Caddyfile.

• Удаление пустых блоков проксирования для веб-почты (WEBMAIL), если функция отключена.

• Удаление упоминаний домена веб-почты из конфигурации, если параметр openpanel_disable_webmail_tls имеет значение true.

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

Для обновления OpenPanel используется стандартная процедура перезапуска сервисов после внесения изменений в конфигурацию. Если требуется обновление компонентов через Docker, необходимо выполнить:

docker restart caddy

(Примечание: Для полноценного обновления версии самого приложения рекомендуется использовать официальные инструкции разработчика или запуск установочного скрипта с флагом восстановления).

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

Основные файлы системы расположены по следующим путям:

• /etc/openpanel/caddy/Caddyfile — основной конфигурационный файл веб-сервера.

• /root/installation_script.sh — установочный скрипт (после установки может быть удален).

• /root/openpanel_install.log — лог-файл процесса установки.

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