Руководство по установке

Системные требования

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

• Ubuntu 20.04 LTS или 22.04 LTS или 24.04 LTS
• Как минимум 2 ГБ ОЗУ и 20 ГБ дискового пространства
• Архитектурой x86_64/amd64

Установка в интерактивном режиме

Вы можете установить панель управления BeAdmin через терминал в интерактивном режиме. В этом случае во время установки система запросит у вас email основного пользователя, под которым вы сможете заходить в панель. Вы также сможете указать доменное имя вашего сайта, тогда панель будет доступна по его адресу, например https://mysite.com:8080. В этом случае будет автоматически выпущен SSL-сертификат для подключения по HTTPS. Если у вас еще нет доменного имени, оставьте поле как есть.

1. Подключитесь к серверу по SSH:

• под пользователем root или
• под другим пользователем с правами sudo и выполните команду sudo -i

Как подключиться по SSH?

Как правило, ваш хостинг-провайдер предоставляет данные для подключения на странице управления сервером (команда в формате ssh root@ip_address). Далее вам нужно открыть терминал или консоль на вашем локальном компьютере и выполнить подключение.

Подробнее см. Как подключиться к серверу по SSH?

2. Скопируйте и вставьте следующую команду в терминал и нажмите Enter:

wget  -O /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg "https://nexus.beadmin.com/repository/public-keys/beadmin-nexus-public.gpg"
chmod 644 /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg

echo "deb [signed-by=/etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg] https://nexus.beadmin.com/repository/beadmin/ stable main" > /etc/apt/sources.list.d/beadmin.list && \
apt update && apt install -y --no-install-recommends beadmin && \
systemctl enable --now beadmin

Эта команда запустит процесс установки, который займет около 15-30 секунд. Система установит необходимые пакеты с помощью пакетного менеджера apt.

3. Следуйте инструкциям установки.

На этом этапе вы можете указать доменное имя вашего сервера, если оно у вас уже есть, например, mysite.com. В этом случае после установки будет автоматически выдан SSL-сертификат, который обеспечит доступ к серверу по HTTPS. Если у вас пока нет доменного имени, оставьте поле пустым (сертификат не будет выпущен).

На заметку

Не забудьте создать DNS-запись типа A, указывающую на IP-адрес вашего сервера, в панели управления вашего хостинг-провайдера. В противном случае сервер не будет доступен по доменному имени.

Далее введите email основного пользователя в качестве логина. Введите его или оставьте значение по умолчанию admin@local.host и нажмите Enter.

Внимание

Всегда указывайте действительный email. Если на предыдущем шаге вы ввели доменное имя, но указали недействительный email, генерация SSL-сертификата завершится ошибкой, и будет выдан самоподписанный сертификат. Ваш сервер останется доступным по HTTPS, но большинство браузеров отобразят предупреждение.

Нажмите Enter и дождитесь завершения установки. После этого вы сможете зайти в BeAdmin по адресу https://ip_сервера:8080 или https://ваш_домен:8080. Приятного использования!

Незащищенное подключение

Если вы не указывали домен или подключаетесь к серверу напрямую по IP-адресу, в браузере может появиться предупреждение "Ваше соединение не защищено". Это происходит потому, что SSL-сертификат является самоподписанным, и браузер не может подтвердить его подлинность.

Нажмите "Дополнительно", затем "Перейти на ip_сервера (небезопасно)".

Установка в неинтерактивном режиме

Этот вариант подходит, если вам нужна установка в один клик или вы являетесь веб-хостинг провайдером и требуется полностью автоматизированная настройка.

1. Подключитесь к серверу по SSH:

• под пользователем root или
• под пользователем с правами sudo и выполните команду sudo -i

2. Подготовьте команду установки:

Замените mysite.com в первой опциональной строке на нужное вам доменное имя. В этом случае SSL-сертификат будет выдан автоматически. Или удалите эту строку, если не хотите указывать домен (вы сможете добавить его позже в панели BeAdmin).

Замените admin@local.host и your_password во второй опциональной строке на email основного администратора и его пароль. Всегда используйте действительный email, особенно если указали доменное имя в предыдущей строке. В противном случае будет выдан самоподписанный SSL-сертификат. Если вас устраивает admin@local.host, можете оставить строку без изменений.

wget  -O /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg "https://nexus.beadmin.com/repository/public-keys/beadmin-nexus-public.gpg"
chmod 644 /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg

echo "deb [signed-by=/etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg] https://nexus.beadmin.com/repository/beadmin/ stable main" > /etc/apt/sources.list.d/beadmin.list && \

# (optional line)
echo "beadmin beadmin/ssl_acme_domain string mysite.com" | debconf-set-selections && \
# (optional lines)
echo "beadmin beadmin/default_user string admin@local.host" | debconf-set-selections && \
echo "beadmin beadmin/default_password password your_password" | debconf-set-selections && \

apt update && DEBIAN_FRONTEND=noninteractive apt install -y --no-install-recommends beadmin && \

systemctl enable --now beadmin

3. Скопируйте команду, вставьте её в терминал и нажмите Enter.

Установка обычно занимает около минуты. После завершения вы сможете зайти в BeAdmin по адресу https://ip_сервера:8080 или https://ваш_домен:8080. Приятного использования!