Cách cài đặt WildFly với Nginx làm Proxy ngược trên Debian 10

[theanh]

WildFly là một ứng dụng chạy thời gian thực miễn phí, mã nguồn mở và đa nền tảng được viết bằng Java và phát triển bởi Red Hat cho phép bạn phát triển các ứng dụng tuyệt vời từ một IDE duy nhất. Nó nhẹ, nhanh, linh hoạt và dựa trên các hệ thống con có thể cắm được. Nó chạy trên hệ điều hành Windows và Linux và nhằm mục đích cung cấp cho người dùng một môi trường chạy thời gian thực Java nhanh và ổn định. Wildfly đi kèm với một bộ tính năng phong phú bao gồm, Thời gian chạy nhanh, có thể tùy chỉnh, Khả năng mở rộng, Cấu hình & Quản lý thống nhất, Tải đồng thời, Liên kết nhanh, Quản lý tên miền và nhiều tính năng khác.

Trong hướng dẫn này, chúng tôi sẽ chỉ cho bạn các bước để cài đặt Wildfly với Nginx làm proxy ngược trên Debian 10.

Yêu cầu​

• Một máy chủ chạy Debian 10.
• Một mật khẩu gốc được thiết lập cho máy chủ của bạn.

Bắt đầu​

Trước khi bắt đầu, bạn sẽ cần cập nhật hệ thống của mình lên phiên bản mới nhất. Bạn có thể thực hiện việc này bằng cách chạy lệnh sau:

apt-get update -y
apt-get upgrade -y

Sau khi máy chủ của bạn được cập nhật, hãy khởi động lại máy chủ để áp dụng các thay đổi.

Cài đặt Java​

WildFly yêu cầu Java phiên bản 8 phải được cài đặt trên máy chủ của bạn. Theo mặc định, Java 8 không có trong kho lưu trữ mặc định của Debian 10. Vì vậy, bạn sẽ cần tải Java 8 từ trang web chính thức của họ.

Sau khi tải Java 8, hãy giải nén mã nguồn Java vào thư mục /usr/lib/jvm bằng lệnh sau:

mkdir /usr/lib/jvm/
tar -zxvf jdk-8u221-linux-x64.tar.gz -C /usr/lib/jvm/

Tiếp theo, hãy chạy lệnh sau để thay đổi phiên bản Java mặc định:

update-alternatives --config java

Chọn phiên bản Java 8 và nhấn Enter. Bạn sẽ thấy đầu ra sau:

Có 2 lựa chọn cho java thay thế (cung cấp /usr/bin/java). Trạng thái ưu tiên của đường dẫn lựa chọn-----------------------------------------------------------------------* 0 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 chế độ tự động 1 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 chế độ thủ công 2 /usr/lib/jvm/jdk1.8.0_221/bin/java 1 chế độ thủ côngNhấn  để giữ lựa chọn hiện tại[*] hoặc nhập số lựa chọn: 2update-alternatives: sử dụng /usr/lib/jvm/jdk1.8.0_221/bin/java để cung cấp /usr/bin/java (java) ở chế độ thủ công

Tiếp theo, hãy kiểm tra phiên bản Java bằng lệnh sau:

java -version

Bạn sẽ nhận được kết quả sau:

java version "1.8.0_221"Java(TM) SE Runtime Environment (bản dựng 1.8.0_221-b11)Java HotSpot(TM) 64-Bit Server VM (bản dựng 25.221-b11, chế độ hỗn hợp)

Cài đặt Wildfly​

Đầu tiên, bạn sẽ cần tạo người dùng và nhóm cho Wildfly. Bạn có thể tạo nó bằng lệnh sau:

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

Tiếp theo, tải xuống phiên bản Wildfly mới nhất bằng lệnh sau:

wget https://download.jboss.org/wildfly/17.0.1.Final/wildfly-17.0.1.Final.zip

Sau khi tải xuống hoàn tất, hãy giải nén tệp đã tải xuống bằng lệnh sau:

unzip wildfly-17.0.1.Final.zip

Tiếp theo, sao chép thư mục đã giải nén vào /opt/ bằng lệnh sau:

cp -r wildfly-17.0.1.Final /opt/wildfly

Tiếp theo, hãy thay đổi quyền sở hữu thư mục wildfly thành wildfly user như được hiển thị bên dưới:

chown -RH wildfly:wildfly /opt/wildfly

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình Wildfly​

Tiếp theo, bạn sẽ cần sao chép các tệp cần thiết để cấu hình WildFly.

Đầu tiên, sao chép tệp cấu hình WildFly vào thư mục /etc/wildfly:

mkdir /etc/wildfly
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

Tiếp theo, sao chép tệp launch.sh vào thư mục /opt/wildfly/bin/ bằng lệnh sau:

cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Tiếp theo, cấp quyền thực thi cho tệp launch.sh:

sh -c 'chmod +x /opt/wildfly/bin/*.sh'

Tiếp theo, sao chép tệp đơn vị systemd Wildfly vào thư mục /etc/systemd/system/:

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

Tiếp theo, tải lại daemon systemd bằng lệnh sau:

systemctl daemon-reload

Tiếp theo, khởi động dịch vụ WildFly và cho phép dịch vụ này khởi động khi khởi động bằng lệnh sau:

systemctl start wildfly
systemctl enable wildfly

Bây giờ bạn có thể kiểm tra trạng thái của dịch vụ Wildfly bằng lệnh sau:

systemctl status wildfly

Bạn sẽ nhận được kết quả đầu ra sau:

? wildfly.service - Máy chủ ứng dụng WildFly Đã tải: đã tải (/etc/systemd/system/wildfly.service; đã tắt; cài đặt trước của nhà cung cấp: đã bật) Đang hoạt động: đang hoạt động (đang chạy) từ Thứ 3 2019-09-10 00:19:27 EDT; 1 giây trước PID chính: 1142 (launch.sh) Nhiệm vụ: 7 (giới hạn: 1138) Bộ nhớ: 24,7M CGroup: /system.slice/wildfly.service ??1142 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 0.0.0.0 ??1143 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 0.0.0.0 ??1200 java -D[Standalone] -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -10/9 00:19:27 debian systemd[1]: Đã khởi động Máy chủ ứng dụng WildFly.

Cấu hình xác thực WildFly​

Tiếp theo, bạn sẽ cần tạo một người dùng quản trị viên cho Wildfly để truy cập bảng điều khiển quản trị WildFly. Bạn có thể tạo bằng lệnh sau:

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

Bạn sẽ thấy đầu ra sau:

Bạn muốn thêm loại người dùng nào? a) Người dùng quản lý (mgmt-users.properties) b) Người dùng ứng dụng (application-users.properties)(a): a

Nhập a và nhấn Enter để tạo người dùng quản lý. Trong quá trình tạo người dùng, bạn sẽ cần cung cấp tên người dùng, mật khẩu và tên nhóm như hiển thị bên dưới:

Nhập thông tin chi tiết của người dùng mới để thêm.Sử dụng miền 'ManagementRealm' như đã tìm thấy từ các tệp thuộc tính hiện có.Tên người dùng: wildflyadminCác khuyến nghị về mật khẩu được liệt kê bên dưới. Để sửa đổi các hạn chế này, hãy chỉnh sửa tệp cấu hình add-user.properties. - Mật khẩu phải khác với tên người dùng - Mật khẩu không được là một trong các giá trị bị hạn chế sau {root, admin, administrator} - Mật khẩu phải chứa ít nhất 8 ký tự, 1 ký tự chữ cái, 1 chữ số, 1 ký hiệu không phải chữ và sốMật khẩu:Nhập lại mật khẩu:Bạn muốn người dùng này thuộc nhóm nào? (Vui lòng nhập danh sách phân cách bằng dấu phẩy hoặc để trống nếu không có)[ ]:Sắp thêm người dùng 'wildflyadmin' cho miền 'ManagementRealm'Điều này có đúng không? cóĐã thêm người dùng 'wildflyadmin' vào tệp '/opt/wildfly/standalone/configuration/mgmt-users.properties'Đã thêm người dùng 'wildflyadmin' vào tệp '/opt/wildfly/domain/configuration/mgmt-users.properties'Đã thêm người dùng 'wildflyadmin' với các nhóm vào tệp '/opt/wildfly/standalone/configuration/mgmt-groups.properties'Đã thêm người dùng 'wildflyadmin' với các nhóm vào tệp '/opt/wildfly/domain/configuration/mgmt-groups.properties'Người dùng mới này có được sử dụng cho một quy trình AS để kết nối với một quy trình AS khác không?ví dụ: cho bộ điều khiển máy chủ phụ kết nối với máy chủ chính hoặc cho kết nối Remoting cho các cuộc gọi EJB từ máy chủ đến máy chủ.có/không? cóĐể biểu diễn người dùng, hãy thêm nội dung sau vào định nghĩa server-identities

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình WildFly để có thể truy cập từ Hệ thống từ xa​

Theo mặc định, Wildfly chỉ có thể truy cập từ hệ thống cục bộ. Vì vậy, bạn sẽ cần cấu hình để có thể truy cập từ hệ thống từ xa. Bạn có thể thực hiện bằng cách chỉnh sửa tệp /etc/wildfly/wildfly.conf:

nano /etc/wildfly/wildfly.conf

Thêm dòng sau vào cuối tệp:

WILDFLY_CONSOLE_BIND=0.0.0.0

Lưu và đóng tệp khi bạn hoàn tất. Sau đó, mở tệp /opt/wildfly/bin/launch.sh như hiển thị bên dưới:

nano /opt/wildfly/bin/launch.sh

Thay đổi tệp như hiển thị bên dưới:

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

Lưu và đóng tệp. Sau đó, mở tệp /etc/systemd/system/wildfly.service.

nano /etc/systemd/system/wildfly.service

Thay đổi tệp như hiển thị bên dưới:

[Unit]Description=Máy chủ ứng dụng WildFlyAfter=syslog.target network.targetBefore=httpd.service[Service]Environment=LAUNCH_JBOSS_IN_BACKGROUND=1EnvironmentFile=-/etc/wildfly/wildfly.confUser=wildflyLimitNOFILE=102642PIDFile=/var/run/wildfly/wildfly.pidExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BINDStandardOutput=null[Cài đặt]WantedBy=multi-user.target

Lưu tệp. Sau đó, tạo thư mục /var/run/wildfly và thiết lập quyền chính xác

mkdir /var/run/wildfly/
chown wildfly:wildfly /var/run/wildfly/

Cuối cùng, tải lại daemon systemd và khởi động lại dịch vụ Wildfly để áp dụng các thay đổi:

systemctl daemon-reload
systemctl restart wildfly

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Truy cập Wildfly​

Wildfly hiện đã được cài đặt và cấu hình để truy cập từ hệ thống từ xa. Theo mặc định, bảng điều khiển quản lý Wildfly đang lắng nghe trên cổng 9990. Bạn có thể truy cập bằng cách truy cập URL

http://192.168.0.4:9990

. Bạn sẽ được chuyển hướng đến trang sau:



Bây giờ, hãy cung cấp tên người dùng và mật khẩu quản trị viên của bạn và nhấp vào nút Đăng nhập vào. Bạn sẽ thấy bảng điều khiển quản lý Wildfly trong màn hình sau:



Bạn cũng có thể truy cập ứng dụng Wildfly bằng cách truy cập URL

http://192.168.0.4:8080

. Bạn sẽ thấy trang sau:

Cấu hình Nginx làm Proxy ngược cho Wildfly​

Tiếp theo, bạn sẽ cần cấu hình Nginx làm proxy ngược để yêu cầu proxy đến từ cổng 80 đến 8080.

Trước tiên, hãy cài đặt Nginx bằng lệnh sau:

apt-get install nginx -y

Sau khi Nginx đã được cài đặt, hãy tạo một tệp máy chủ ảo mới cho Nginx bằng lệnh sau:

nano /etc/nginx/sites-available/wildfly.conf

Thêm các dòng sau:

upstream wildfly { server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;}server { listen 80; server_name 192.168.0.4; location / { proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://wildfly/; }}

Lưu và đóng tệp khi bạn hoàn tất. Sau đó, hãy kiểm tra Nginx xem có lỗi cú pháp nào không bằng lệnh sau:

nginx -t

Bạn sẽ nhận được kết quả sau:

nginx: cú pháp tệp cấu hình /etc/nginx/nginx.conf là oknginx: kiểm tra tệp cấu hình /etc/nginx/nginx.conf thành công

Tiếp theo, bật máy chủ ảo Nginx và khởi động lại Nginx bằng lệnh sau:

ln -s /etc/nginx/sites-available/wildfly.conf /etc/nginx/sites-enabled/
systemctl restart nginx

Bây giờ bạn có thể truy cập ứng dụng Wildfly mà không cần chỉ định cổng 8080.

Vậy là xong. Bạn đã cài đặt và cấu hình Wildfly thành công với Nginx làm proxy ngược trên Debian 10. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.