Hướng dẫn Bind Jenkins vào IIS trên Windows bằng Reverse Proxy

Mục tiêu

1. Cho phép truy cập Jenkins từ một subdomain (ví dụ jenkins.tedu.com.vn) thay vì phải gõ http://localhost:8080.

2. Sử dụng IIS làm reverse proxy.

3. Cấu hình Jenkins lắng nghe mọi IP (0.0.0.0) để truy cập từ bên ngoài.

Yêu cầu trước khi bắt đầu

• Windows Server đã cài Jenkins (phiên bản mới).

• IIS đã cài trên server.

• Subdomain đã trỏ về IP server.

• Quyền Admin trên Windows.

Bước 1: Cấu hình Jenkins lắng nghe mọi IP

1. Mở file jenkins.xml (thường nằm trong C:\Program Files (x86)\Jenkins hoặc nơi bạn cài Jenkins).

2. Tìm <arguments> và chỉnh thành:

<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -jar "%BASE%\jenkins.war" --httpPort=8080 --httpListenAddress=0.0.0.0</arguments>

Giải thích:

• --httpPort=8080: cổng Jenkins sẽ lắng nghe.

• --httpListenAddress=0.0.0.0: cho phép tất cả các IP truy cập.

3. Lưu file và restart dịch vụ Jenkins bằng Services hoặc lệnh:

net stop jenkins
net start jenkins

4. Kiểm tra truy cập từ máy khác bằng http://<IP_server>:8080.

Bước 2: Cài đặt IIS Reverse Proxy

2.1 Cài các module cần thiết

• Mở Server Manager → Add Roles and Features → chọn:

  • Web Server (IIS) nếu chưa cài.

  • Application Request Routing (ARR):

    • Cần để IIS làm reverse proxy.

  • URL Rewrite:

    • Dùng để chuyển hướng subdomain đến Jenkins.

2.2 Kích hoạt Reverse Proxy trong ARR

1. Mở IIS Manager.

2. Chọn server → Application Request Routing Cache.

3. Chọn Server Proxy Settings → check Enable proxy → Apply.

Bước 3: Tạo site trong IIS cho subdomain

1. Mở IIS Manager → Sites → Add Website.

2. Cấu hình:

   • Site name: Jenkins

   • Physical path: Có thể để bất kỳ thư mục trống (ví dụ C:\inetpub\jenkins) vì IIS sẽ proxy.

   • Binding:

     • Type: http

     • IP address: All Unassigned

     • Port: 80

     • Host name: jenkins.tedu.com.vn

3. Nhấn OK.

Bước 4: Cấu hình URL Rewrite để proxy đến Jenkins

1. Chọn site Jenkins → double click URL Rewrite.

2. Chọn Add Rule(s)… → Reverse Proxy.

3. Nhập backend server:

   http://localhost:8080
   

4. Apply.

5. Optional: Check Enable SSL Offloading nếu dùng HTTPS.

Lưu ý: Nếu dùng HTTPS, cần cài SSL certificate cho subdomain trong Binding, sau đó trong ARR cũng phải chọn Enable SSL Offloading.

Bước 5: Kiểm tra và tinh chỉnh

1. Restart IIS:

iisreset

2. Truy cập http://jenkins.tedu.com.vn.

3. Nếu thấy Jenkins login page → thành công.

4. Nếu lỗi 404 hoặc không load được, kiểm tra:

   • URL Rewrite có rule đúng chưa.

   • Firewall mở port 80/443.

   • Jenkins đã lắng nghe 0.0.0.0:8080 chưa.

Bước 6: Optional – Chặn truy cập trực tiếp IP/Port

Nếu muốn mọi người chỉ truy cập qua subdomain:

1. Trong Jenkins → Configure Global Security → Disable remote access từ IP trực tiếp.

2. Hoặc dùng firewall chặn port 8080 từ ngoài, chỉ cho IIS proxy.

Tips tối ưu

• Luôn bật Require SSL nếu public ra Internet.

• ARR hỗ trợ caching, load balancing nếu sau này có nhiều Jenkins node.

• URL Rewrite có thể dùng để redirect HTTP → HTTPS tự động.

• Nếu Jenkins chạy trên cổng khác ngoài 8080, nhớ update URL Rewrite.