Apache Tomcat là gì? Cách hoạt động, tính năng và cài đặt

Apache Tomcat là một máy chủ ứng dụng web và bộ chứa Servlet mã nguồn mở, chuyên dùng để chạy các ứng dụng viết bằng Java Servlet, JSP và WebSocket. Bài viết này của Tenten sẽ giúp bạn hiểu rõ Apache Tomcat là gì, cơ chế cách hoạt động, khám phá các tính năng nổi […]

Apache Tomcat là gì? Cách hoạt động, tính năng và cài đặt
Summarize this post with AI
Tóm tắt nhanh

Apache Tomcat là một máy chủ ứng dụng web và trình chứa Servlet (Servlet Container) mã nguồn mở do Apache Software Foundation phát triển.

Apache Tomcat dùng để triển khai ứng dụng web Java, xử lý yêu cầu HTTP, thực thi Servlet và JSP, phục vụ nội dung động cho người dùng.

Cách hoạt động của Apache Tomcat: Tiếp nhận yêu cầu HTTP, xác định ứng dụng đích, chuyển yêu cầu đến Servlet hoặc JSP xử lý, sau đó trả phản hồi về trình duyệt.

Kiến trúc của Apache Tomcat: Tổ chức theo mô hình phân cấp gồm Server, Service, Connector, Engine, Host, Context và Wrapper. Các thành phần chính gồm Catalina quản lý Servlet, Coyote xử lý kết nối và Jasper biên dịch JSP.

Các tính năng nổi bật của Apache Tomcat: Hỗ trợ công nghệ web Java, chạy trên nhiều hệ điều hành, xử lý kết nối HTTP và cung cấp các cơ chế quản lý phiên, cấu hình và triển khai ứng dụng.

Ưu điểm của Apache Tomcat: Tương thích với hệ sinh thái Java, miễn phí và mã nguồn mở, tiêu tốn tài nguyên tương đối thấp, dễ tích hợp với framework và thư viện, có cộng đồng hỗ trợ cùng tài liệu kỹ thuật phong phú.

Nhược điểm của Apache Tomcat: Không cung cấp đầy đủ tính năng của máy chủ ứng dụng Jakarta EE, khả năng quản lý cụm máy chủ phức tạp còn hạn chế, xử lý nội dung tĩnh không chuyên biệt như NGINX hoặc Apache HTTP Server.

Apache Tomcat là một máy chủ ứng dụng web và bộ chứa Servlet mã nguồn mở, chuyên dùng để chạy các ứng dụng viết bằng Java Servlet, JSP và WebSocket. Bài viết này của Tenten sẽ giúp bạn hiểu rõ Apache Tomcat là gì, cơ chế cách hoạt động, khám phá các tính năng nổi bật và cách cài đặt chính xác nhất cho lập trình viên.

Tổng quan về Apache Tomcat là gì?

Apache là gì?

Apache (tên đầy đủ là Apache HTTP Server) là một phần mềm web server mã nguồn mở phổ biến do Apache Software Foundation phát triển và duy trì. Apache nhận các yêu cầu HTTP/HTTPS từ người dùng qua mạng và trả về nội dung trang web tương ứng như HTML, CSS, JavaScript, hình ảnh hoặc dữ liệu PHP.

Apache Tomcat là gì?

Apache Tomcat (hay thường gọi là Tomcat) là một máy chủ web và bộ chứa servlet (servlet container) miễn phí, mã nguồn mở, được phát triển bởi Apache Software Foundation. Tomcat được dùng để chạy, triển khai và quản lý các ứng dụng web viết bằng ngôn ngữ Java như Java Servlet, JSP, EL và WebSocket. 

Apache Tomcat là một dự án thuộc hệ sinh thái Apache, thường được sử dụng để xử lý yêu cầu HTTP và vận hành các ứng dụng web Java dựa trên Servlet, JSP. Với đặc điểm gọn nhẹ và linh hoạt, Tomcat được cộng đồng phát triển ứng dụng web Java sử dụng rộng rãi.

Hiểu đơn giản, Apache Tomcat cung cấp môi trường để triển khai và vận hành ứng dụng web Java trên máy chủ. Khi người dùng gửi yêu cầu từ trình duyệt, Tomcat tiếp nhận và chuyển yêu cầu đến Servlet hoặc JSP xử lý, rồi gửi kết quả phản hồi về trình duyệt.

Apache Tomcat là gì

Phân biệt Apache Tomcat và Apache HTTP Server

Mặc dù cùng thuộc hệ sinh thái Apache, Apache Tomcat và Apache HTTP Server có mục đích thiết kế và công nghệ khác nhau. Apache HTTP Server là một máy chủ web đa mục đích chuyên phục vụ nội dung tĩnh, còn Apache Tomcat là một máy chủ servlet chuyên dùng để chạy các ứng dụng web động viết bằng Java (JSP và Servlet).

Bảng so sánh dưới đây sẽ giúp bạn phân biệt rõ hơn Apache Tomcat và Apache HTTP Server:

Tiêu chí

Apache Tomcat

Apache HTTP Server

Vai trò chính

Servlet Container, môi trường chạy ứng dụng web Java

Máy chủ web HTTP đa mục đích

Công nghệ trọng tâm

Servlet, JSP, WebSocket

HTTP, module máy chủ web

Xử lý ứng dụng Java

Chạy ứng dụng web Java tương thích

Không trực tiếp cung cấp Servlet Container mặc định

Nội dung phổ biến

Ứng dụng web Java động

Tệp tĩnh, nội dung web và proxy

Khả năng kết hợp

Có thể đứng sau reverse proxy

Có thể làm reverse proxy cho Tomcat

Trong thực tế, người ta thường kết hợp cả Apache HTTP Server và Apache Tomcat lại với nhau để vừa phục vụ nội dung tĩnh vừa xử lý logic Java hiệu quả.

Apache Tomcat dùng để làm gì?

Apache Tomcat dùng làm máy chủ web (web server) và bộ chứa servlet (servlet container) mã nguồn mở để triển khai và vận hành các ứng dụng web viết bằng ngôn ngữ Java:

  • Triển khai và vận hành ứng dụng web được phát triển bằng Java.
  • Chạy các ứng dụng sử dụng Servlet và JSP.
  • Tiếp nhận yêu cầu HTTP và trả về nội dung tương ứng từ ứng dụng.
  • Hỗ trợ kiểm thử ứng dụng trong môi trường phát triển và triển khai trên máy chủ.
  • Kết hợp với Nginx hoặc Apache HTTP Server để làm reverse proxy trong một số kiến trúc hệ thống.

Apache Tomcat hoạt động như thế nào?

Apache Tomcat hoạt động bằng cách tiếp nhận yêu cầu từ trình duyệt web hoặc ứng dụng client, chuyển yêu cầu đến ứng dụng web tương ứng, xử lý thông qua Servlet Container và gửi kết quả phản hồi về client. Quá trình này diễn ra theo trình tự sau:

  • Tiếp nhận yêu cầu: Tomcat lắng nghe các yêu cầu HTTP/HTTPS thông qua cổng mạng được cấu hình. Các cổng mặc định phổ biến là 8080 cho HTTP và 8443 cho HTTPS, tùy cấu hình máy chủ.
  • Xác định ứng dụng web: Tomcat dựa vào tên miền và đường dẫn URL để xác định ứng dụng cần xử lý yêu cầu.
  • Chuyển yêu cầu đến Servlet Container: Yêu cầu được điều phối đến thành phần xử lý của Tomcat để tìm Servlet tương ứng trong ứng dụng web.
  • Tìm và tải Servlet hoặc JSP: Tomcat xác định Servlet cần thực thi. Với JSP, hệ thống sẽ biên dịch thành Servlet nếu chưa được biên dịch hoặc cần biên dịch lại.
  • Khởi tạo và xử lý yêu cầu: Servlet được khởi tạo khi cần và thực thi logic ứng dụng, chẳng hạn như truy vấn cơ sở dữ liệu, kiểm tra thông tin đăng nhập hoặc xử lý dữ liệu sản phẩm.
  • Trả kết quả cho Tomcat: Sau khi xử lý, Servlet trả về dữ liệu và thông tin phản hồi để Tomcat tạo HTTP response.
  • Gửi phản hồi đến client: Tomcat gửi kết quả về trình duyệt web hoặc ứng dụng đã gửi yêu cầu ban đầu.

Apache Tomcat hoạt động như thế nào

Kiến trúc của Apache Tomcat 

Kiến trúc Apache Tomcat được tổ chức theo mô hình phân cấp, gồm các thành phần quản lý máy chủ, tiếp nhận kết nối và xử lý ứng dụng web Java. Mỗi thành phần đảm nhiệm một vai trò riêng, phối hợp để tiếp nhận yêu cầu HTTP, điều phối đến ứng dụng phù hợp và trả kết quả cho client.

Server, Service, Connector và Container

Kiến trúc bên trong của Tomcat được cấu trúc theo mô hình cây phân cấp, quản lý trực tiếp thông qua tệp cấu hình server.xml:

  • Server: Đại diện cho toàn bộ instance đang chạy của Tomcat, đóng vai trò là điểm bắt đầu của ứng dụng, quản lý vòng đời của toàn bộ hệ thống và có thể chứa một hoặc nhiều Service.
  • Service: Thành phần trung gian nhóm một hoặc nhiều Connector chung với duy nhất một Engine. Service kết nối luồng nhận dữ liệu từ các cổng mạng với logic xử lý bên trong.
  • Connector & Engine (Cổng kết nối và Lõi xử lý):
    • Connector: Điểm tiếp nhận yêu cầu từ client trên một cổng mạng cụ thể, chịu trách nhiệm giao tiếp socket, dịch dữ liệu mạng thành đối tượng yêu cầu của Tomcat và chuyển tiếp cho Engine.
    • Engine: Lõi xử lý yêu cầu tối cao của một Service. Engine nhận yêu cầu từ Connector, phân tích và chuyển hướng yêu cầu đó đến Host thích hợp dựa trên thông tin định tuyến.
  • Host: Đại diện cho một tên miền ảo (Virtual Host) chạy trên Tomcat. Một Engine có thể chứa nhiều Host để chạy đồng thời nhiều tên miền trên cùng một cổng server.
  • Context: Đại diện cho một ứng dụng web cụ thể đang chạy trên một Host. Mỗi tệp .war hoặc thư mục ứng dụng trong webapps khi deploy sẽ trở thành một Context.
  • Wrapper: Thành phần cấp thấp nhất, đại diện và quản lý vòng đời của một Servlet đơn lẻ bên trong ứng dụng web.

Kiến trúc của Apache Tomcat

Catalina, Coyote và Jasper

Bên cạnh cấu trúc phân cấp, Apache Tomcat còn có các thành phần cốt lõi đảm nhiệm việc xử lý Servlet, quản lý kết nối và thực thi JSP:

  • Catalina: Là lõi Servlet Container của Tomcat, chịu trách nhiệm thực thi các đặc tả Servlet, quản lý vòng đời của ứng dụng và cung cấp môi trường runtime cho các Java Web Component.
  • Coyote: Đóng vai trò là lớp giao tiếp cấp thấp, chịu trách nhiệm lắng nghe kết nối mạng, phân tích cú pháp các giao thức (như HTTP/1.1, HTTP/2, AJP) và chuyển tiếp dữ liệu đến Catalina xử lý.
  • Jasper: Là trình biên dịch JSP của Tomcat, có nhiệm vụ phân tích các file .jsp, biên dịch chúng thành mã nguồn Java Servlet, sau đó dịch tiếp thành bytecode để Catalina có thể thực thi.

Ngoài ra, Tomcat hỗ trợ WebSocket và HTTP/2 ở các phiên bản tương ứng. Tuy nhiên, khả năng sử dụng thực tế phụ thuộc vào phiên bản Tomcat, cấu hình Connector, thư viện và các điều kiện triển khai liên quan; không phải mọi tính năng đều tự động được kích hoạt ngay sau khi cài đặt.

Các tính năng nổi bật của Apache Tomcat

Các tính năng nổi bật của Apache Tomcat:

  • Tuân thủ chuẩn Jakarta EE/Java EE: Hỗ trợ đầy đủ các đặc tả như Java Servlet, JavaServer Pages (JSP), Expression Language (EL) và WebSocket, giúp mã nguồn dễ dàng di chuyển giữa các máy chủ khác nhau. 
  • Kiến trúc module rõ ràng: Gồm 3 thành phần cốt lõi là Catalina (quản lý Servlet container), Coyote(xử lý giao thức HTTP/AJP/WebSocket) và Jasper (biên dịch mã JSP). 
  • Hỗ trợ đa nền tảng: Chạy mượt mà trên nhiều hệ điều hành như Linux, Windows, macOS và BSD nhờ nền tảng máy ảo Java (JVM). 
  • Quản lý phiên và phân cụm (Session Management & Clustering): Cung cấp tính năng sao chép phiên làm việc giữa các node để đảm bảo độ sẵn sàng cao và cân bằng tải. 
  • Bảo mật: Hỗ trợ cơ chế xác thực container (Realm), tích hợp SSL/TLS cho HTTPS, hỗ trợ Java Security Manager và cập nhật bảo mật thường xuyên từ cộng đồng. 
  • Kết nối đa dạng: Hỗ trợ giao tiếp qua HTTP/1.1, HTTP/2, AJP (Apache JServ Protocol) để kết hợp dễ dàng với các web server như Apache HTTP Server hoặc Nginx. 
  • Công cụ quản trị trực tuyến: Tích hợp sẵn ứng dụng Manager và Host Manager giúp lập trình viên triển khai, gỡ hoặc tải lại ứng dụng ngay khi server đang chạy.
  • Tích hợp với IDE và Framework: Hoạt động trơn tru với các công cụ phát triển phổ biến như Eclipse, IntelliJ IDEA và các framework hiện đại như Spring Boot.

Các tính năng nổi bật của Apache Tomcat

Ưu điểm và nhược điểm của Apache Tomcat

Apache Tomcat sở hữu nhiều điểm vượt trội giúp tối ưu hóa quá trình phát triển và triển khai ứng dụng web Java nhưng cũng tồn tại một số hạn chế nhất định về tính năng và cấu hình.

Ưu điểm của Apache Tomcat

Apache Tomcat sở hữu nhiều điểm vượt trội như:

  • Khả năng tương thích tuyệt vời với hệ sinh thái Java 
  • Tính linh hoạt cao, cho phép tích hợp thêm các công cụ và thư viện mở rộng khác.
  • Miễn phí và mã nguồn mở
  • Nhẹ và tối ưu tài nguyên, khởi động nhanh
  • Hiệu năng ổn định, vận hành bền bỉ, đáp ứng tốt cho phần lớn các ứng dụng web Java từ nhỏ đến lớn.
  • Cộng đồng hỗ trợ lớn, tài liệu hướng dẫn phong phú.
  • Cài đặt cấu hình ban đầu tương đối đơn giản và thân thiện với lập trình viên.

Ưu điểm của Apache Tomcat

Nhược điểm của Apache Tomcat

Bên cạnh các thế mạnh nêu trên, Apache Tomcat cũng gặp một số giới hạn mà người dùng cần lưu ý khi vận hành hệ thống:

    • Không phải là một Java EE application server đầy đủ nên thiếu đi các tính năng nâng cao như EJB hay JMS.
    • Khả năng quản lý và cấu hình các cụm máy chủ lớn (clustering) còn nhiều hạn chế so với các giải pháp thương mại.
    • Hiệu suất xử lý các tệp tin tĩnh như hình ảnh hoặc video không tối ưu bằng các web server chuyên dụng như Nginx hay Apache HTTP Server.
    • Giao diện quản trị mặc định qua web còn khá sơ khai và thiếu các công cụ giám sát hiệu năng chuyên sâu.
  • Có quá nhiều tùy chọn thiết lập khác nhau, dễ dẫn đến lỗi cấu hình bảo mật nếu quản trị viên thiếu kinh nghiệm.

Chọn phiên bản Tomcat và Java phù hợp

Khi lựa chọn Apache Tomcat, bạn cần kiểm tra phiên bản Java đang sử dụng, nền tảng API của ứng dụng và tình trạng hỗ trợ của từng nhánh Tomcat. Không nên chọn phiên bản chỉ vì đó là bản mới nhất, bởi ứng dụng cũ có thể sử dụng API không tương thích với các phiên bản Tomcat mới.

Bảng phiên bản được hỗ trợ

Dưới đây là tóm tắt và bảng tương thích giúp bạn chọn phiên bản Apache Tomcat và Java phù hợp:

Tomcat

Nền tảng API

Java tối thiểu

Tình trạng

11.x

Jakarta EE 11

Java 17+

Đang phát triển chính

10.1.x

Jakarta EE 10

Java 11+

Stable (Ổn định)

9.0.x

Java EE 8

Java 8+

Stable, legacy compatibility (Ổn định, khả năng tương thích kê thừa)

Lưu ý: Tình trạng phiên bản được đối chiếu theo tài liệu Apache Tomcat tại thời điểm tháng 10/2026. Tomcat 9.0.x đã được thông báo kết thúc hỗ trợ từ ngày 31/03/2027, vì vậy cần cân nhắc kế hoạch nâng cấp nếu triển khai hệ thống mới.

javax.* và jakarta.* ảnh hưởng thế nào?

Sự thay đổi từ javax.* sang jakarta.* là yếu tố quan trọng khi nâng cấp Tomcat. Từ Tomcat 10 trở đi, các API Servlet và Jakarta EE tương ứng sử dụng namespace jakarta.* thay cho javax.*, khiến nhiều ứng dụng cũ cần chỉnh sửa mã nguồn hoặc thực hiện migration trước khi chạy trên phiên bản mới. 

  • Ứng dụng sử dụng javax.*: Nên ưu tiên Tomcat 9 nếu cần duy trì khả năng tương thích với Java EE 8 mà chưa thể sửa đổi ứng dụng. Nếu chuyển sang Tomcat 10.1 hoặc 11, cần kiểm tra và chuyển đổi các API liên quan.
  • Ứng dụng sử dụng jakarta.*: Chọn Tomcat 10.1 hoặc 11 tùy phiên bản Jakarta API, framework và dependency mà ứng dụng yêu cầu.
  • Ứng dụng dùng framework hoặc thư viện bên thứ ba: Cần kiểm tra phiên bản tương thích với Tomcat mục tiêu, bởi việc đổi namespace trong mã nguồn chưa chắc đã giải quyết được mọi vấn đề phụ thuộc.

Khuyến nghị: Trước khi cài đặt hoặc nâng cấp Tomcat, hãy kiểm tra phiên bản Java, framework, thư viện và namespace API của ứng dụng. Nếu hệ thống đang vận hành ổn định, nên thử nghiệm quá trình nâng cấp trong môi trường staging trước khi triển khai chính thức.

Apache Tomcat thuộc loại máy chủ gì?

Apache Tomcat là máy chủ ứng dụng web Java (Java Web Server), đồng thời là Servlet Container – môi trường thực thi các ứng dụng web Java sử dụng Servlet, JSP và những công nghệ liên quan thuộc nền tảng Jakarta EE. 

Tomcat có thể tiếp nhận và xử lý yêu cầu HTTP trực tiếp hoặc kết hợp với các máy chủ web khác như Apache HTTP Server và NGINX. 

Cụ thể, Apache Tomcat có hai vai trò chính:

  • Máy chủ web HTTP: Tiếp nhận yêu cầu HTTP từ trình duyệt hoặc ứng dụng client, sau đó trả về nội dung phản hồi. Tomcat có thể hoạt động độc lập mà không cần một máy chủ web riêng đứng phía trước.
  • Servlet Container: Quản lý vòng đời Servlet và thực thi mã Java xử lý yêu cầu, tạo nội dung động cho ứng dụng web. Tomcat hỗ trợ các công nghệ như Servlet, JSP và WebSocket tùy phiên bản.

Tomcat không phải là máy chủ ứng dụng Jakarta EE đầy đủ như các nền tảng triển khai nhiều dịch vụ doanh nghiệp khác. Phạm vi chính của Tomcat tập trung vào môi trường chạy ứng dụng web Java. Vì vậy, khi triển khai website Java, bạn có thể sử dụng Tomcat độc lập hoặc đặt sau Apache HTTP Server hay NGINX để phân phối yêu cầu và phối hợp với các thành phần khác trong hệ thống.

Hướng dẫn cài đặt Apache Tomcat chi tiết

Hướng dẫn dưới đây sẽ sử dụng Ubuntu 22.04/24.04 LTS làm môi trường chuẩn và có phần mở rộng cho Windows.

Chuẩn bị Java và kiểm tra môi trường

Trước khi cài đặt Apache Tomcat, bạn cần đảm bảo hệ thống đã cài đặt Java Development Kit (JDK) hoặc Java Runtime Environment (JRE) vì Tomcat được xây dựng hoàn toàn bằng Java.

  • Kiểm tra Java: Mở terminal/command prompt và chạy lệnh java -version. Hệ thống cần hiển thị phiên bản Java đã cài đặt, khuyến khích từ Java 11 hoặc Java 17 trở lên tùy thuộc vào phiên bản Tomcat.
  • Xác định JAVA_HOME: Biến môi trường JAVA_HOME phải trỏ chính xác về thư mục gốc của JDK/JRE. Trên Linux, bạn có thể kiểm tra bằng lệnh echo $JAVA_HOME. Trên Windows, kiểm tra trong mục Environment Variables.
  • Chọn Tomcat branch tương thích:
    • Tomcat 9: Hỗ trợ Java 8 trở lên (Jakarta EE 8).
    • Tomcat 10: Hỗ trợ Java 11 trở lên (Jakarta EE 9).
    • Tomcat 10.1: Hỗ trợ Java 11 trở lên (Jakarta EE 10).

Cài đặt Tomcat trên Ubuntu

Thực hiện các bước sau để thiết lập Tomcat một cách an toàn và tối ưu trên Ubuntu:

Tạo user/group riêng: Không nên chạy Tomcat bằng quyền root để đảm bảo bảo mật.

sudo groupadd tomcat

sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

Tải và giải nén: Tải bản phân phối từ trang chủ Apache Tomcat và giải nén vào thư mục /opt/tomcat.

cd /tmp

wget https://apache.org

sudo mkdir /opt/tomcat

sudo tar -xzvf apache-tomcat-10.1.x.tar.gz -C /opt/tomcat --strip-components=1

Phân quyền: Cấp quyền sở hữu thư mục cho user tomcat vừa tạo

cd /opt/tomcat

sudo chgrp -R tomcat /opt/tomcat

sudo chmod -R g+r conf

sudo chmod g+x conf

sudo chown -R tomcat webapps/ work/ temp/ logs/

Tạo file systemd: Tạo file dịch vụ để quản lý Tomcat qua systemctl

sudo nano /etc/systemd/system/tomcat.service

Dán nội dung sau vào file, chú ý thay đổi đường dẫn JAVA_HOME cho đúng thực tế:

[Unit]

Description=Apache Tomcat Web Application Container

After=network.target

[Service]

Type=forking

User=tomcat

Group=tomcat

Environment="JAVA_HOME=/usr/lib/jvm/java-1.17.0-openjdk-amd64"

Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"

Environment="CATALINA_HOME=/opt/tomcat"

Environment="CATALINA_BASE=/opt/tomcat"

 

ExecStart=/opt/tomcat/bin/startup.sh

ExecStop=/opt/tomcat/bin/shutdown.sh

[Install]

WantedBy=multi-user.target

Khởi động service: Tải lại cấu hình daemon và kích hoạt dịch vụ chạy cùng hệ thống.

sudo systemctl daemon-reload

sudo systemctl start tomcat

sudo systemctl enable tomcat

Kiểm tra systemctl status: Xác nhận trạng thái hoạt động của dịch vụ

sudo systemctl status tomcat

Kiểm tra port và log:

  • Kiểm tra Tomcat đã lắng nghe trên port mặc định chưa: ss -ltn | grep 8080
  • Xem log khởi động thời gian thực: tail -f /opt/tomcat/logs/catalina.out

Cài đặt Tomcat trên Windows

Đối với Windows, sử dụng bộ cài đặt Windows Installer (.exe) là cách nhanh và chính xác nhất để quản lý Tomcat dưới dạng một Windows Service.

Bộ cài đặt: Tải file 32-bit/64-bit Windows Service Installer (định dạng .exe) từ trang chủ Apache Tomcat.

Quy trình cài đặt: 

  • Bước 1: Chạy file .exe bằng quyền Administrator.
  • Bước 2: Tại mục Choose Components, tích chọn Service Startup và Native.
  • Bước 3: Cấu hình Port (mặc định là HTTP: 8080, Administrator: 8005).
  • Bước 4: Điền thông tin tạo tài khoản Manager (Username/Password) nếu cần.
  • Bước 5: Trỏ đường dẫn đến thư mục Java Virtual Machine (nếu bộ cài không tự nhận diện).
  • Bước 6: Chọn thư mục đích để cài đặt Tomcat.

Cách khởi động/dừng service:

  • Cách 1: Mở ứng dụng Services (gõ services.msc vào ô tìm kiếm Windows) > Tìm Apache Tomcat > Chuột phải chọn Start hoặc Stop.
  • Cách 2: Sử dụng công cụ Tomcat9w.exe hoặc Tomcat10w.exe trong thư mục bin để quản lý qua giao diện UI nhỏ gọn.

Đường dẫn log: Log của Tomcat thường nằm trong thư mục logs bên trong thư mục cài đặt, chẳng hạn C:\Program Files\Apache Software Foundation\Tomcat 11.0\logs. Đường dẫn thực tế có thể khác tùy vị trí cài đặt và cấu hình dịch vụ.

Kiểm tra phiên bản và xác nhận Tomcat hoạt động

Sau khi cài đặt, bạn nên kiểm tra phiên bản và truy cập Tomcat qua trình duyệt để xác nhận dịch vụ đã sẵn sàng.

Chạy tập lệnh kiểm tra phiên bản:

  • Trên Linux: Chạy /opt/tomcat/bin/version.sh
  • Trên Windows: Mở CMD, di chuyển tới thư mục bin của Tomcat và chạy version.bat
  • Kết quả mong đợi: Hiển thị thông tin chính xác về phiên bản Server (Server version), hệ điều hành (OS Name), kiến trúc chip và phiên bản JVM.

Kiểm tra port được cấu hình: Mở file conf/server.xml để xác nhận cấu hình Connector. Tìm dòng <Connector port=”8080″ protocol=”HTTP/1.1″ … /> để biết chính xác cổng truy cập (mặc định luôn là 8080).

Truy cập trang mặc định: Mở trình duyệt web và truy cập vào địa chỉ http://localhost:8080 hoặc http://<IP_CỦA_SERVER>:8080. Nếu màn hình hiển thị trang chào mừng của Apache Tomcat với hình biểu tượng chú mèo, quá trình cài đặt đã thành công.

Xem log nếu không truy cập được: Nếu trình duyệt báo lỗi không thể kết nối, hãy kiểm tra ngay:

  • Trên Linux: cat /opt/tomcat/logs/catalina.out
  • Trên Windows: Mở file logs/catalina.log gần nhất để tìm các thông báo lỗi liên quan đến xung đột cổng (Port already in use) hoặc cấu hình sai biến JAVA_HOME.

Các lệnh thường dùng trong Apache Tomcat

Các lệnh và tập lệnh quản lý thường dùng trong Apache Tomcat được chia theo hệ điều hành như sau:

Khởi động và dừng Tomcat

Dưới đây là các lệnh khởi động và dừng Tomcat trên Windows và Linux/macOS mà bạn có thể tham khảo:

Windows:

  • Khởi động: Chạy lệnh startup.bat
  • Dừng: Chạy lệnh shutdown.bat 

Linux/macOS:

  • Khởi động: ./catalina.sh start
  • Khởi động ở chế độ Foreground: ./catalina.sh run
  • Dừng: ./catalina.sh stop
  • Khởi động lại: ./catalina.sh stop sau đó ./catalina.sh start

Các thư mục và file quan trọng

  • bin/: Chứa các script thực thi (startup.bat, shutdown.bat, catalina.sh).
  • conf/: Chứa các file cấu hình hệ thống như server.xml, web.xml, tomcat-users.xml.
  • webapps/: Thư mục chứa các ứng dụng web (giải nén thư mục hoặc file .war).
  • logs/: Chứa các file nhật ký hoạt động (ví dụ: catalina.out, localhost.log).

Theo dõi Nhật ký (Logs) trên Linux

Xem nội dung file log chính theo thời gian thực:
tail -f logs/catalina.out

Triển khai ứng dụng trong Tomcat

Apache Tomcat hỗ trợ triển khai ứng dụng web Java thông qua tệp WAR hoặc thư mục ứng dụng đã giải nén. Trong môi trường production, Tomcat cũng có thể kết hợp với NGINX hoặc Apache HTTP Server để tiếp nhận kết nối và chuyển tiếp yêu cầu đến ứng dụng.

Deploy WAR và exploded directory

Deploy WAR là cách đóng gói ứng dụng web Java thành tệp .war rồi đưa vào thư mục triển khai của Tomcat. Với cấu hình mặc định, bạn có thể đặt tệp WAR trong thư mục webapps.

Ví dụ, sao chép shop.war vào thư mục /opt/tomcat/webapps/:

cp shop.war /opt/tomcat/webapps/

Nếu tính năng tự động triển khai được bật, Tomcat sẽ phát hiện và triển khai ứng dụng. Context path thường dựa trên tên tệp WAR: shop.war tương ứng với đường dẫn /shop. Khi đó, bạn có thể truy cập ứng dụng tại http://localhost:8080/shop, nếu Tomcat đang sử dụng cổng 8080 và không có cấu hình định tuyến khác.

Exploded directory là thư mục chứa nội dung ứng dụng đã giải nén, thường gồm WEB-INF, mã đã biên dịch trong WEB-INF/classes và thư viện trong WEB-INF/lib. Nếu thư mục có tên shop được đặt trong webapps, context path mặc định thường là /shop.

Nên chọn hình thức triển khai tùy theo nhu cầu:

  • WAR: Phù hợp với quy trình phát hành ứng dụng đã đóng gói, giúp quản lý và chuyển giao phiên bản thuận tiện.
  • Exploded directory: Phù hợp khi cần kiểm tra cấu trúc tệp hoặc phát triển, gỡ lỗi ứng dụng.

Dấu hiệu triển khai thành công là ứng dụng được truy cập đúng URL và trả về nội dung mong đợi. Nếu gặp lỗi HTTP 404, HTTP 500 hoặc ứng dụng không xuất hiện, hãy kiểm tra context path, cấu trúc gói triển khai, cấu hình ứng dụng và log của Tomcat. HTTP 404 cũng có thể xuất phát từ URL hoặc mapping không chính xác, không nhất thiết là lỗi triển khai.

Deploy WAR và exploded directory

Tomcat sau Nginx hoặc Apache HTTP Server

Trong môi trường production, Tomcat có thể chạy phía sau NGINX hoặc Apache HTTP Server theo mô hình reverse proxy. Proxy tiếp nhận kết nối HTTPS từ người dùng qua cổng 443, sau đó chuyển tiếp yêu cầu đến Tomcat qua cổng 8080 hoặc một cổng nội bộ khác.

Mô hình này hoạt động như sau:

  • Người dùng gửi yêu cầu HTTPS đến NGINX hoặc Apache HTTP Server.
  • Proxy tiếp nhận yêu cầu và chuyển tiếp đến Tomcat.
  • Tomcat xử lý ứng dụng Java rồi gửi phản hồi về proxy.
  • Proxy trả kết quả cho người dùng qua kết nối HTTPS.

Khi triển khai, bạn nên giới hạn quyền truy cập trực tiếp vào cổng Tomcat, chỉ cho phép các nguồn cần thiết kết nối. Đồng thời, không nên mở Tomcat Manager hoặc các giao diện quản trị ra Internet nếu không có nhu cầu; hãy giới hạn quyền truy cập và áp dụng cơ chế xác thực phù hợp.

Nhúng Tomcat (Embedded Tomcat) là cách tích hợp Tomcat vào ứng dụng Java để ứng dụng có thể tự khởi chạy máy chủ web, thường gặp trong Spring Boot. Cách này khác với standalone Tomcat, nơi Tomcat được cài đặt và quản lý riêng, sau đó tiếp nhận ứng dụng được triển khai vào máy chủ.

Các lỗi thường gặp khi dùng Apache Tomcat

Trong quá trình cài đặt và vận hành Apache Tomcat, bạn có thể gặp lỗi khởi động, triển khai ứng dụng hoặc truy cập dịch vụ. Để xác định nguyên nhân, hãy kiểm tra cấu hình, trạng thái dịch vụ và log của Tomcat thay vì chỉ dựa vào thông báo trên trình duyệt.

Tomcat không khởi động được

Tomcat có thể không khởi động do cấu hình Java sai, cổng kết nối bị chiếm hoặc tài khoản chạy dịch vụ không đủ quyền truy cập.

Một số nguyên nhân thường gặp và cách kiểm tra:

  • Sai JAVA_HOME: Kiểm tra biến môi trường có trỏ đến thư mục JDK phù hợp hay không.
  • Java không tương thích: Đối chiếu phiên bản Java đang cài với yêu cầu của nhánh Tomcat đang sử dụng.
  • Port đã bị chiếm: Kiểm tra cổng Tomcat cấu hình, thường là 8080, bằng lệnh sudo ss -lntp | grep ‘:8080’trên Linux.
  • Thiếu quyền truy cập: Kiểm tra quyền đọc, ghi và thực thi của tài khoản chạy Tomcat đối với thư mục cài đặt, log và thư mục tạm.

Trên Linux, bạn có thể kiểm tra trạng thái dịch vụ và log bằng các lệnh:

sudo systemctl status tomcat

sudo journalctl -u tomcat -n 100 --no-pager

Nếu Tomcat được cài thủ công, hãy kiểm tra thêm các tệp log trong thư mục logs của Tomcat.

Deploy WAR nhưng nhận lỗi 404

Lỗi HTTP 404 thường xuất hiện khi Tomcat không tìm thấy tài nguyên theo URL được yêu cầu. Nếu đã đặt tệp WAR vào thư mục webapps nhưng ứng dụng vẫn trả về 404, bạn nên kiểm tra các nguyên nhân sau:

  • Sai context path: Kiểm tra tên WAR và URL truy cập. Ví dụ, shop.war thường tương ứng với /shop, không phải /.
  • WAR chưa triển khai xong: Chờ quá trình triển khai hoàn tất và kiểm tra xem Tomcat đã tạo thư mục ứng dụng hay chưa.
  • Ứng dụng khởi động lỗi: Lỗi cấu hình, thiếu thư viện hoặc không tương thích Java có thể khiến ứng dụng không khởi động thành công.
  • Sai đường dẫn tài nguyên: Ứng dụng đã chạy nhưng URL hoặc servlet mapping không đúng vẫn có thể trả về 404.

Để xác định nguyên nhân, hãy kiểm tra log của Tomcat trong thư mục logs, đặc biệt là các thông báo liên quan đến quá trình triển khai và khởi động ứng dụng. Trên Linux, có thể dùng:

tail -n 100 /opt/tomcat/logs/catalina.out

Tệp catalina.out không phải lúc nào cũng tồn tại. Nếu không có, bạn hãy kiểm tra các tệp log khác hoặc log của dịch vụ systemd.

Không truy cập được Manager hoặc ứng dụng

Nếu không truy cập được Tomcat Manager hoặc ứng dụng web, nguyên nhân có thể đến từ quyền truy cập, cấu hình xác thực, giới hạn địa chỉ IP hoặc kết nối mạng.

  • Sai quyền hoặc vai trò: Với Tomcat Manager, kiểm tra cấu hình người dùng và các role được khai báo trong tomcat-users.xml. Tài khoản cần có role phù hợp với giao diện quản trị muốn sử dụng.
  • Bị giới hạn địa chỉ truy cập: Manager có thể chỉ cho phép truy cập từ localhost theo cấu hình mặc định. Nếu cần truy cập từ xa, hãy điều chỉnh giới hạn IP theo nhu cầu và chỉ cho phép các địa chỉ đáng tin cậy.
  • Firewall chặn kết nối: Kiểm tra cổng Tomcat đang lắng nghe, quy tắc tường lửa trên máy chủ và các quy tắc mạng liên quan.
  • Reverse proxy cấu hình sai: Nếu sử dụng NGINX hoặc Apache HTTP Server, hãy kiểm tra địa chỉ upstream, cổng Tomcat và các quy tắc chuyển tiếp đường dẫn.

Theo tài liệu bảo mật của Apache Tomcat, Manager là mục tiêu thường bị nhắm đến nếu được bật với mật khẩu yếu hoặc cho phép truy cập công khai. Vì vậy, bạn nên đặt mật khẩu mạnh, giới hạn IP truy cập và không công khai giao diện quản trị khi không cần thiết.

Câu hỏi thường gặp về Apache Tomcat

Apache Tomcat có miễn phí không?
Có. Apache Tomcat hoàn toàn miễn phí và là phần mềm mã nguồn mở thuộc Apache Software Foundation. Bạn có thể tự do tải về, sử dụng và chỉnh sửa cho cả mục đích thương mại.
Apache Tomcat có phải là web server không?
Có. Apache Tomcat vừa là web server, vừa là servlet container. Apache Tomcat có thể xử lý các yêu cầu HTTP tĩnh như một web server thông thường, nhưng nhiệm vụ chính là chạy các ứng dụng Java Web (Servlet/JSP).
Apache Tomcat sử dụng cổng mặc định nào?
Cổng mặc định của Apache Tomcat là 8080 cho các kết nối HTTP. Bạn có thể dễ dàng thay đổi cấu hình cổng này trong tệp server.xml nếu bị trùng lặp.
Apache Tomcat có cần cài Java không?
Có. Bắt buộc phải có Java (JRE hoặc JDK) vì Tomcat được viết bằng Java và dùng để chạy các ứng dụng Java. Phiên bản Java cần cài đặt sẽ phụ thuộc vào phiên bản Tomcat bạn chọn.
Apache Tomcat và Spring Boot có gì khác nhau?
Tomcat là một máy chủ dùng để triển khai và chạy ứng dụng web Java. Trong khi đó, Spring Boot là một framework phát triển ứng dụng và nó thường tích hợp sẵn Tomcat bên trong.
Tâm Trần Đức
Giám đốc Khối Kinh doanh Hạ tầng Internet

Trần Đức Tâm là chuyên gia về hạ tầng Internet, Domain, Hosting, Cloud và chuyển đổi số, với nhiều năm kinh nghiệm phát triển các dịch vụ Internet tại Việt Nam và Nhật Bản. Ông hiện là Giám đốc Khối Kinh doanh Hạ tầng Internet tại GMO-Z.com RUNSYSTEM, từng giữ các vị trí lãnh đạo tại Onamae.com, Tenten.vn và Z.com Việt Nam. Các bài viết của ông tập trung vào tên miền, hosting, VPS, email doanh nghiệp, SSL và hạ tầng Internet.