Cách cài đặt WildFly Application Server với Nginx Reverse Proxy trên Debian 12

[theanh]

WildFly, trước đây là JBoss, là một máy chủ ứng dụng mã nguồn mở và miễn phí giúp bạn xây dựng và triển khai các ứng dụng web Java. Nó được viết bằng Java và tuân thủ các thông số kỹ thuật của Java EE (Phiên bản doanh nghiệp). WildFly được tạo ra bởi JBoss nhưng hiện được phát triển bởi RedHat. Đây là một máy chủ ứng dụng mạnh mẽ, sẵn sàng sản xuất, dạng mô-đun và nhẹ, cung cấp tất cả các công cụ và tính năng cần thiết để chạy và triển khai các ứng dụng web Java.

WildFly là một máy chủ ứng dụng đa nền tảng cung cấp các công cụ cho các ứng dụng Java như EJB, JPA, Servlets, JAX-RS, Batch và bảo mật.

Trong hướng dẫn này, bạn sẽ tìm hiểu cách cài đặt WildFly hoặc JBoss application runtime trên máy chủ Debian 12 theo từng bước. Bạn sẽ cài đặt WildFly, bật bảng điều khiển quản trị, tạo người dùng quản trị WildFly và cài đặt cũng như cấu hình Nginx làm proxy ngược.

Điều kiện tiên quyết​

Trước khi tiếp tục, hãy thu thập những thông tin sau:

• Máy chủ Debian 12 có bộ nhớ 4GB trở lên.
• Người dùng không phải root có quyền quản trị sudo.

Cài đặt Java OpenJDK​

WildFly là một ứng dụng Java linh hoạt và nhẹ để xây dựng ứng dụng. Trong phần này, bạn sẽ cài đặt và sử dụng Java OpenJDK 17 để cài đặt WildFly trên máy chủ Debian của mình.

Trước tiên, hãy chạy lệnh sau để cập nhật kho lưu trữ Debian của bạn.

sudo apt update

Bây giờ, hãy cài đặt gói Java OpenJDK bằng cách thực thi lệnh bên dưới. Lệnh này sẽ cài đặt gói default-jdk, tương đương với phiên bản Java OpenJDK 17 LTS (Hỗ trợ dài hạn).

sudo apt install default-jdk

Nhập y để tiếp tục cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22222%22%3E%3C/svg%3E


Sau khi bạn đã cài đặt Java, hãy xác minh phiên bản Java bằng lệnh bên dưới. Bạn sẽ thấy Java OpenJDK 17 đã được cài đặt.

java -version

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22734%22%20height=%22154%22%3E%3C/svg%3E

Cài đặt và cấu hình WildFly​

Sau khi cài đặt Java OpenJDK, bạn có thể Bây giờ hãy bắt đầu cài đặt WildFly bằng cách hoàn thành các tác vụ sau:

• Thêm Người dùng và Nhóm wildfly
• Tải xuống Gói nhị phân WildFly
• Cấu hình Cài đặt WildFly
• Chạy WildFly dưới dạng Dịch vụ Systemd

Chúng ta hãy bắt đầu.

Thêm Người dùng và Nhóm wildfly​

Đầu tiên, bạn sẽ tạo một người dùng hệ thống và nhóm wildfly mới sẽ được sử dụng để chạy cài đặt WildFly của bạn.

Thực hiện lệnh bên dưới để thêm một nhóm và người dùng mới có tên là wildfly bằng cách thực hiện lệnh sau. Với thao tác này, bạn cũng sẽ thiết lập thư mục gốc mặc định cho người dùng wildfly thành /opt/wildfly, thư mục này sẽ được sử dụng làm thư mục cài đặt WildFly.

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

Tải xuống gói nhị phân WildFly​

Sau khi thêm người dùng systemd, bạn sẽ tải xuống gói nhị phân WildFly thông qua wget. Hãy nhớ truy cập trang tải xuống WildFly để tải phiên bản mới nhất.

Trước đó, hãy cài đặt unzip thông qua lệnh apt sau.

sudo apt install unzip -y

Sau đó, hãy truy cập trang tải xuống WildFly và sao chép liên kết đến phiên bản mới nhất của WildFly. Tải xuống gói nhị phân WildFly thông qua lệnh wget như sau. Trong ví dụ này, bạn sẽ cài đặt WildFly 30.0.0.

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

Tiếp theo, giải nén gói nhị phân WildFly và di chuyển thư mục đã giải nén đến /opt/wildfly.

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

Cuối cùng, chạy lệnh bên dưới để thay đổi quyền sở hữu thư mục /opt/wildfly thành người dùng wildfly.

sudo chown -RH wildfly: /opt/wildfly

Cấu hình cài đặt WildFly​

Trong ví dụ này, bạn sẽ cài đặt WildFly trên một máy duy nhất ở chế độ độc lập. Vì vậy, mọi cấu hình bạn sửa đổi ở đây đều liên quan đến các cấu hình độc lập của WildFly.

Khởi chạy lệnh nano editor sau để mở tệp /opt/wildfly/bin/standalone.conf.

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

Thay đổi giá trịXmx512mtrongJBOSS_JAVA_SIZING biến môi trường để tăng kích thước bộ nhớ heap tối đa mặc định của WildFly như sau.

Hãy đảm bảo điều chỉnh kích thước bộ nhớ heap tối đa với máy chủ hiện tại của bạn. Ví dụ sau đây đặt bộ nhớ heap tối đa thành 4GB.

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

Lưu và thoát khỏi tệp khi bạn hoàn tất.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22118%22%3E%3C/svg%3E


Bây giờ hãy tạo một thư mục cấu hình mới /etc/wildfly bằng cách sử dụng lệnh bên dưới lệnh.

sudo mkdir -p /etc/wildfly

Sao chép tệp cấu hình WildFly vào /etc/wildfly/wildfly.conf và mở tệp đó bằng lệnh trình chỉnh sửa nano sau.

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

Thay đổi WILDFLY_BIND mặc định thành 127.0.0.1 và thêm biến WILDFLY_CONSOLE_BIND để kích hoạt quản trị bảng điều khiển WildFly. Cả WildFly và bảng điều khiển quản trị sẽ chạy trong máy chủ cục bộ.

# The address to bind to
WILDFLY_BIND=127.0.0.1

# Enable Admin
WILDFLY_CONSOLE_BIND=127.0.0.1

Khi hoàn tất, hãy lưu và thoát khỏi tệp.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22338%22%20height=%22274%22%3E%3C/svg%3E


Tiếp theo, sao chép tập lệnh khởi chạy WildFly vào /opt/wildfly/bin/launch.sh và thực thi thông qua lệnh chmod bên dưới

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

Mở tập lệnh khởi chạy WildFly /opt/wildfly/bin/launch.sh bằng lệnh trình chỉnh sửa nano sau.

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

Chèn tùy chọn lệnh mới '-bmanagement $4' để bật bảng điều khiển quản trị WildFly như thế này.

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

Lưu và đóng tệp khi bạn hoàn tất.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22614%22%20height=%22142%22%3E%3C/svg%3E


Cuối cùng, hãy chạy lệnh bên dưới để thay đổiThư mục cài đặt WildFly/opt/wildfly thuộc quyền sở hữu của người dùng wildfly.

sudo chown -RH wildfly: /opt/wildfly

Chạy WildFly dưới dạng Dịch vụ Systemd​

Sau khi định cấu hình WildFly ở chế độ độc lập, bạn sẽ thiết lập tệp dịch vụ systemd cho WildFly. Điều này cho phép bạn chạy WIldFly ở chế độ nền và quản lý WildFly dễ dàng thông qua tiện ích systemctl.

Sao chép tệp dịch vụ systemd WildFly vào /etc/systemd/system/wildfly.service và sửa đổi tệp đó bằng lệnh trình chỉnh sửa nano bên dưới.

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

Trong tùy chọn ExecStart, hãy thêm tham số bắt đầu mới $WILDFLY_CONSOLE_BIND để bật quản trị viên WildFly console.

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

Khi hoàn tất, hãy lưu tệp và thoát khỏi trình chỉnh sửa.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22149%22%3E%3C/svg%3E


Tiếp theo, hãy chạy lệnh systemctl bên dưới để tải lại systemd quản lý.

sudo systemctl daemon-reload

Sau đó khởi động và kích hoạt dịch vụ wildfly bằng lệnh bên dưới.

sudo systemctl start wildfly
sudo systemctl enable wildfly

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22155%22%3E%3C/svg%3E


Xác minh dịch vụ wildfly để đảm bảo rằng dịch vụ đang chạy bằng cách thực hiện lệnh sau.

sudo systemctl status wildfly

Nếu dịch vụ wildfly đang chạy, đầu ra sau sẽ được hiển thị.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22200%22%3E%3C/svg%3E


Bạn cũng có thể xác minh danh sách các cổng mở trên hệ thống của mình bằng cách thực hiện lệnh sau.

ss -antpl | grep -i java

Bạn sẽ thấy nhiều cổng 8080, 8443 và 9990 mà WildFly sử dụng.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22113%22%3E%3C/svg%3E

Thêm Quản lý người dùng WildFly​

Sau khi cài đặt WildFly, bạn sẽ tạo một người dùng quản trị mới cho WildFly thông qua tập lệnh /opt/wildfly/bin/add-user.sh.

Chạy tập lệnh /opt/wildfly/bin/add-user.sh như sau.

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

Bây giờ bạn sẽ được yêu cầu thực hiện các thao tác sau:

• Nhập a để tạo một người dùng quản lý WildFly mới.
• Nhập tên người dùng quản trị và mật khẩu của bạn, sau đó lặp lại.
• Nhấn ENTER khi được yêu cầu cấu hình nhóm.
• Nhập yes để thêm người dùng của bạn vào ManagementRealm.

Sau khi quá trình hoàn tất, bạn sẽ thấy người dùng mới của mình đã được thêm vào cấu hình WildFly.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22346%22%3E%3C/svg%3E

Thiết lập Nginx làm Proxy ngược​

Tại thời điểm này, bạn đã hoàn tất cài đặt WildFLy, bật bảng điều khiển quản trị và tạo người dùng quản trị. Bước tiếp theo là cài đặt Nginx và cấu hình nó làm proxy ngược cho WildFly.

Thực hiện lệnh apt bên dưới để cài đặt Nginx vào máy chủ Debian của bạn. Nhập y để tiếp tục cài đặt.

sudo apt install nginx

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22641%22%20height=%22313%22%3E%3C/svg%3E


Sau khi Nginx được cài đặt, bạn sẽ cấu hình nó như một proxy ngược cho WildFly.

Tạo một cấu hình tiêu đề proxy Nginx mới /etc/nginx/conf.d/proxy_headers.conf sử dụng lệnh nano editor bên dưới.

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

Chèn cấu hình sau vào tệp.

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

Lưu và thoát tệp khi hoàn tất.

Tiếp theo, khởi chạy lệnh nano editor sau để tạo cấu hình khối máy chủ Nginx mới /etc/nginx/sites-available/wildfly.

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

Chèn cấu hình bên dưới để thiết lập Nginx làm proxy ngược cho cài đặt WildFly của bạn. Hãy chắc chắn thay đổi tên miền trong tùy chọn server_name, bạn có thể sử dụng tên miền cục bộ.

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;
 }

}

Lưu và đóng tệp khi bạn hoàn tất.

Bây giờ hãy chạy lệnh bên dưới để kích hoạt tệp máy chủ ảo wildfly và xác minh cú pháp Nginx của bạn.

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

Nếu cú pháp Nginx của bạn đúng, đầu ra "cú pháp ổn—kiểm tra thành công" sẽ được hiển thị.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22203%22%3E%3C/svg%3E


Cuối cùng, hãy chạy lệnh bên dưới để khởi động lại dịch vụ Nginx và áp dụng các thay đổi bạn đã thực hiện. Sau đó, hãy xác minh dịch vụ Nginx để đảm bảo rằng dịch vụ đang chạy.

sudo systemctl restart nginx
sudo systemctl status nginx

Nếu Nginx đang chạy, bạn sẽ nhận được đầu ra active (running).


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22241%22%3E%3C/svg%3E

Truy cập WildFly qua Client​

Trên máy khách của bạn, hãy mở tệp hosts bằng trình soạn thảo văn bản của bạn. Đối với người dùng Windows, hãy mở tệp C:\Windows\System32\drivers\etc\hosts với tư cách là quản trị viên, còn đối với người dùng Linux hoặc macOS, hãy mở tệp /etc/hosts với quyền sudo.

Chèn cấu hình sau và đảm bảo thay đổi tên miền cục bộ và địa chỉ IP bằng thông tin của bạn.

192.168.5.15 wildfly.howtoforge.local

Lưu và đóng tệp khi bạn hoàn tất.

Khởi chạy trình duyệt web và truy cập tên miền cục bộ WildFly của bạn (ví dụ: http:wildfly.howtoforge.local/). Nếu cài đặt thành công, bạn sẽ thấy trang chỉ mục WildFly mặc định như sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22600%22%3E%3C/svg%3E


Bây giờ hãy nhấp vào liên kết Bảng điều khiển quản trị để truy cập bảng điều khiển quản trị WildFly. Thao tác này sẽ mở một tab mới và bạn sẽ được chuyển hướng đến bảng điều khiển quản trị WildFly với đường dẫn URL /console.

Nhập tên người dùng và mật khẩu quản trị của bạn cho bảng điều khiển quản trị WildFly, sau đó nhấp vào Đăng nhập.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22343%22%3E%3C/svg%3E


Nếu bạn có tên người dùng và mật khẩu đúng, bạn sẽ thấy bảng điều khiển quản trị WildFly như sau.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22515%22%3E%3C/svg%3E


Tiếp theo, nhấp vào menu Runtime và chọn máy chủ của bạn. Bạn sẽ thấy xác nhận rằng WildFly đã hoạt động.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22517%22%3E%3C/svg%3E


Cuối cùng, hãy chọn menu Trạng thái và bạn sẽ thấy trạng thái chi tiết của cài đặt WildFly, bao gồm cả cấu hình heap đã thay đổi thành 4GB.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22518%22%3E%3C/svg%3E

Kết luận​

Tóm lại, giờ bạn đã hoàn tất cài đặt WildFly trên Debian 12 từng bước. Bạn đã cài đặt WildFly, bật bảng điều khiển quản trị và tạo người dùng quản trị WildFly. Ngoài ra, bạn cũng đã cấu hình Nginx làm proxy ngược cho Wildfly. Từ bây giờ, bạn có thể triển khai và chạy các ứng dụng JBoss của mình bằng thời gian chạy ứng dụng WildFly.