Установка WildFly · 7 min read · Sep 08, 2025

Как установить сервер приложений WildFly с обратным прокси Nginx на Debian 12

WildFly, ранее JBoss, является бесплатным и открытым сервером приложений, который помогает вам создавать и развертывать веб-приложения на Java. Он написан на Java и соответствует спецификациям Java EE (Enterprise Edition). WildFly был создан JBoss, но теперь разрабатывается компанией RedHat. Это мощный, готовый к производству, модульный и легковесный сервер приложений, который предоставляет все необходимые инструменты и функции для запуска и развертывания веб-приложений на Java.

WildFly является кроссплатформенным сервером приложений, который предоставляет инструменты для Java-приложений, такие как EJB, JPA, Servlets, JAX-RS, Batch и безопасность.

В этом руководстве вы узнаете, как установить WildFly или среду выполнения приложений JBoss на сервере Debian 12 шаг за шагом. Вы установите WildFly, включите консоль управления, создадите администратора WildFly и установите и настроите Nginx в качестве обратного прокси.

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

Перед тем как продолжить, соберите следующее:

  • Сервер Debian 12 с 4 ГБ или более памяти.
  • Пользователь без прав root с правами администратора sudo.

Установка Java OpenJDK

WildFly является гибкой и легковесной средой выполнения Java для создания приложений. В этом разделе вы установите и используете Java OpenJDK 17 для установки WildFly на вашем сервере Debian.

Сначала выполните следующую команду, чтобы обновить ваш репозиторий Debian.

sudo apt update

Теперь установите пакет Java OpenJDK, выполнив команду ниже. Это установит пакет default-jdk, который эквивалентен версии Java OpenJDK 17 LTS (Long Term Supports).

sudo apt install default-jdk

Введите y, чтобы продолжить установку.

установка java openjdk

После установки Java проверьте версию Java, используя команду ниже. Вы должны увидеть, что Java OpenJDK 17 установлена.

java -version

проверка версии java

Установка и настройка WildFly

После установки Java OpenJDK вы можете начать установку WildFly, выполнив следующие задачи:

  • Добавление пользователя и группы wildfly
  • Загрузка бинарного пакета WildFly
  • Настройка установки WildFly
  • Запуск WildFly как службы Systemd

Давайте начнем.

Добавление пользователя и группы wildfly

Сначала вы создадите нового системного пользователя и группу wildfly, которые будут использоваться для запуска вашей установки WildFly.

Выполните команду ниже, чтобы добавить новую группу и пользователя с именем wildfly.

sudo groupadd -r wildfly  
sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Загрузка бинарного пакета WildFly

После добавления пользователя systemd вы загрузите бинарный пакет WildFly через wget. Обязательно посетите страницу загрузки WildFly, чтобы получить последнюю версию.

Перед этим установите unzip с помощью следующей команды apt.

sudo apt install unzip -y

После этого посетите страницу загрузки WildFly и скопируйте ссылку на последнюю версию WildFly. Загрузите бинарный пакет WildFly с помощью команды wget, как показано ниже. В этом примере вы установите WildFly 30.0.0.

wget https://github.com/wildfly/wildfly/releases/download/30.0.0.Final/wildfly-30.0.0.Final.zip

Затем распакуйте бинарный пакет WildFly и переместите извлеченную директорию в /opt/wildfly.

unzip wildfly-30.0.0.Final.zip  
sudo mv wildfly-30.0.0.Final /opt/wildfly

Наконец, выполните команду ниже, чтобы изменить владельца директории /opt/wildfly на пользователя wildfly.

sudo chown -RH wildfly: /opt/wildfly

Настройка установки WildFly

В этом примере вы установите WildFly на одном компьютере в автономном режиме. Таким образом, каждая конфигурация, которую вы измените здесь, относится к конфигурациям WildFly в автономном режиме.

Запустите следующую команду редактора nano, чтобы открыть файл /opt/wildfly/bin/standalone.conf.

sudo nano /opt/wildfly/bin/standalone.conf

Измените значение Xmx512m в переменной окружения JBOSS_JAVA_SIZING, чтобы увеличить максимальный размер кучи памяти WildFly по умолчанию, как показано ниже.

Обязательно настройте максимальный размер кучи памяти в соответствии с вашим текущим сервером. В следующем примере максимальный размер кучи памяти установлен на 4 ГБ.

  JBOSS_JAVA_SIZING="-Xms64m -Xmx4096m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"

Сохраните и выйдите из файла, когда закончите.

Теперь создайте новую директорию конфигурации /etc/wildfly с помощью команды ниже.

sudo mkdir -p /etc/wildfly

Скопируйте файл конфигурации WildFly в /etc/wildfly/wildfly.conf и откройте его с помощью следующей команды редактора nano.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/  
sudo nano /etc/wildfly/wildfly.conf

Измените значение по умолчанию WILDFLY_BIND на 127.0.0.1 и добавьте переменную WILDFLY_CONSOLE_BIND, чтобы включить консоль управления WildFly. И WildFly, и консоль администратора будут работать на localhost.

# Адрес для привязки  
WILDFLY_BIND=127.0.0.1  
  
# Включить админ  
WILDFLY_CONSOLE_BIND=127.0.0.1

Когда закончите, сохраните файл и выйдите из редактора.

запуск wildfly standalone

Далее скопируйте скрипт запуска WildFly в /opt/wildfly/bin/launch.sh и сделайте его исполняемым с помощью команды chmod ниже.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/  
sudo chmod +x /opt/wildfly/bin/*.sh

Откройте скрипт запуска WildFly /opt/wildfly/bin/launch.sh с помощью следующей команды редактора nano.

sudo nano /opt/wildfly/bin/launch.sh

Вставьте новый параметр команды ‘-bmanagement $4‘, чтобы включить консоль управления WildFly, как показано ниже.

if [[ "$1" == "domain" ]]; then  
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4  
else  
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4  
fi

Сохраните и закройте файл, когда закончите.

Наконец, выполните команду ниже, чтобы изменить владельца директории установки WildFly /opt/wildfly на пользователя wildfly.

sudo chown -RH wildfly: /opt/wildfly

Запуск WildFly как службы Systemd

После настройки WildFly в автономном режиме вы создадите файл службы systemd для WildFly. Это позволит вам запускать WildFly в фоновом режиме и легко управлять WildFly с помощью утилиты systemctl.

Скопируйте файл службы systemd WildFly в /etc/systemd/system/wildfly.service и измените его с помощью команды редактора nano ниже.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/  
sudo nano /etc/systemd/system/wildfly.service

В опции ExecStart добавьте новый параметр запуска $WILDFLY_CONSOLE_BIND, чтобы включить консоль администратора WildFly.

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

Когда закончите, сохраните файл и выйдите из редактора.

Далее выполните команду systemctl ниже, чтобы перезагрузить менеджер systemd.

sudo systemctl daemon-reload

Затем запустите и активируйте службу wildfly с помощью команды ниже.

sudo systemctl start wildfly  
sudo systemctl enable wildfly

wildfly systemd

Проверьте службу wildfly, чтобы убедиться, что служба работает, выполнив следующую команду.

sudo systemctl status wildfly

Если служба wildfly работает, будет отображен следующий вывод.

служба wildfly

Вы также можете проверить список открытых портов на вашей системе, выполнив следующую команду.

ss -antpl | grep -i java

Вы должны увидеть несколько портов 8080, 8443 и 9990, которые использует WildFly.

Добавление управления пользователями WildFly

После установки WildFly вы создадите нового администратора для WildFly с помощью скрипта /opt/wildfly/bin/add-user.sh.

Запустите скрипт /opt/wildfly/bin/add-user.sh следующим образом.

sh /opt/wildfly/bin/add-user.sh

Теперь вам будет предложено следующее:

  • Введите a, чтобы создать нового пользователя управления WildFly.
  • Введите имя пользователя и пароль администратора, затем повторите его.
  • Нажмите ENTER, когда вас спросят о конфигурации группы.
  • Введите yes, чтобы добавить вашего пользователя в ManagementRealm.

После завершения процесса вы должны увидеть, что ваш новый пользователь был добавлен в конфигурацию WildFly.

добавить администратора

Настройка Nginx как обратного прокси

На этом этапе вы завершили установку WildFly, включили консоль управления и создали администратора. Следующий шаг — установить Nginx и настроить его как обратный прокси для WildFly.

Выполните команду apt ниже, чтобы установить Nginx на ваш сервер Debian. Введите y, чтобы продолжить установку.

sudo apt install nginx

установка nginx

После установки Nginx вы настроите его как обратный прокси для WildFly.

Создайте новую конфигурацию заголовков прокси Nginx /etc/nginx/conf.d/proxy_headers.conf с помощью команды редактора nano ниже.

sudo nano /etc/nginx/conf.d/proxy_headers.conf

Вставьте следующую конфигурацию в файл.

proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
add_header Front-End-Https on;
add_header Cache-Control no-cache;

Сохраните и выйдите из файла, когда закончите.

Далее запустите следующую команду редактора nano, чтобы создать новую конфигурацию блока сервера Nginx /etc/nginx/sites-available/wildfly.

sudo nano /etc/nginx/sites-available/wildfly

Вставьте конфигурацию ниже, чтобы настроить Nginx как обратный прокси для вашей установки WildFly. Обязательно измените домен в опции server_name, вы можете использовать локальное доменное имя.

server {  
    listen          80;  
    server_name     wildfly.howtoforge.local;  
  
    location / {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:8080;  
    }  
  
    location /management {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/management;  
    }  
  
    location /console {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/console;  
    }  
  
    location /logout {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/logout;  
    }  
  
    location /error {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990;  
    }  
  
}

Сохраните и закройте файл, когда закончите.

Теперь выполните команду ниже, чтобы активировать файл виртуального хоста wildfly и проверить синтаксис Nginx.

sudo ln -s /etc/nginx/sites-available/wildfly /etc/nginx/sites-enabled/  
sudo nginx -t

Если у вас правильный синтаксис Nginx, будет отображен вывод “синтаксис в порядке — тест успешен“.

настройка nginx

Наконец, выполните команду ниже, чтобы перезапустить службу Nginx и применить внесенные изменения. Затем проверьте службу Nginx, чтобы убедиться, что служба работает.

sudo systemctl restart nginx  
sudo systemctl status nginx

Если Nginx работает, вы должны получить вывод active (running).

проверка nginx

Доступ к WildFly через клиент

На вашем клиентском компьютере откройте файл hosts с помощью текстового редактора. Для пользователей Windows откройте файл C:\Windows\System32\drivers\etc\hosts от имени администратора, а для пользователей Linux или macOS откройте файл /etc/hosts с правами sudo.

Вставьте следующую конфигурацию и обязательно измените локальное доменное имя и IP-адрес на свои данные.

192.168.5.15  wildfly.howtoforge.local

Сохраните и закройте файл, когда закончите.

Запустите веб-браузер и посетите ваш локальный домен WildFly (например: http:wildfly.howtoforge.local/). Если ваша установка успешна, вы должны увидеть страницу индекса WildFly по умолчанию, которая выглядит следующим образом:

wildfly jboss

Теперь нажмите на ссылку Консоль управления, чтобы получить доступ к консоли управления WildFly. Это откроет новую вкладку, и вы будете перенаправлены в консоль управления WildFly с URL-адресом /console.

Введите ваше имя пользователя администратора и пароль для консоли управления WildFly, затем нажмите Войти.

вход в консоль администратора

Если у вас правильное имя пользователя и пароль, вы должны увидеть консоль управления WildFly, как показано ниже.

консоль администратора wildfly

Далее нажмите на меню Выполнение и выберите ваш сервер. Вы должны увидеть подтверждение, что WildFly работает.

статус выполнения

Наконец, выберите меню Статус, и вы должны увидеть детальный статус вашей установки WildFly, включая изменение конфигурации кучи на 4 ГБ.

статус выполнения

Заключение

В заключение, вы завершили установку WildFly на Debian 12 шаг за шагом. Вы установили WildFly, включили консоль управления и создали администратора WildFly. Кроме того, вы также настроили Nginx как обратный прокси для WildFly. Теперь вы можете развертывать и запускать ваши приложения JBoss, используя среду выполнения приложений WildFly.

Share: X/Twitter LinkedIn
#Установка WildFly

Get new posts in your inbox

No spam. Unsubscribe anytime.