HƯỚNG DẪN CÀI ĐẶT SSL TRÊN VPANEL

Trang Install SSL được dùng khi bạn đã nhận được chứng chỉ từ một Certificate Authority (DigiCert, Sectigo, Let's Encrypt qua manual DNS challenge, hoặc CA nội bộ) và muốn gán vào một domain cụ thể do OpenLiteSpeed phục vụ. vPanel kiểm tra khớp giữa chứng chỉ và khóa riêng, xác minh chain CA bundle, ghi file vào đúng vị trí và reload listener mà không cần restart toàn bộ HTTP server.

---

1. Truy cập trang Install SSL

Đăng nhập Admin Panel trên cổng :2087. Mở SSL/TLS trong thanh menu và nhấn Install SSL.

Các trường

Chứng chỉ, khóa và CA bundle phải ở định dạng PEM. File DER (.der) hoặc PKCS#12 (.pfx) phải convert trước — xem mục xử lý sự cố.

---

2. Cài đặt chứng chỉ

Bước 1: Chọn domain

Chọn domain từ dropdown. Chỉ những domain đã được khai báo trong vPanel mới xuất hiện. Nếu thiếu, hãy thêm ở Domains → Create trước.

Bước 2: Dán chứng chỉ

• Mở file .crt do CA gửi trong trình soạn thảo.
• Copy toàn bộ block, kể cả -----BEGIN CERTIFICATE----- và -----END CERTIFICATE-----.
• Dán vào ô Certificate.

Bước 3: Dán khóa riêng

Nếu CSR được sinh trên chính server này (trang Generate CSR), nhấn Auto-detect from CSR — vPanel sẽ tìm khóa riêng đã lưu và điền tự động.

Nếu không, dán khóa riêng thủ công. Bao gồm đầy đủ block -----BEGIN PRIVATE KEY----- (hoặc -----BEGIN RSA PRIVATE KEY-----).

Bước 4: Dán CA Bundle (khuyến nghị)

• CA thường cấp file ca-bundle.crt hoặc intermediate.crt gồm một hay nhiều chứng chỉ chuỗi.
• Dán toàn bộ nội dung vào CA Bundle.
• Không có CA bundle hợp lệ, một số client (đặc biệt Android và Windows cũ) sẽ báo Untrusted certificate.

Bước 5: Nhấn Install

• vPanel thực hiện nhiều xác thực:
  • Cert–Key khớp — so sánh openssl x509 -modulus với openssl rsa -modulus.
  • Chain hợp lệ — kiểm tra mỗi intermediate ký chứng chỉ đứng trước.
  • Common Name / SAN — kiểm tra chứng chỉ phủ domain đích.
• Xác thực thành công, file được ghi tại /etc/vpanel/ssl/<domain>/ và listener OpenLiteSpeed reload.
• Banner thành công hiển thị ngày hết hạn mới.

---

3. Kiểm tra chứng chỉ

Sau khi cài:

• Mở https://your-domain trong cửa sổ ẩn danh.
• Nhấn biểu tượng ổ khóa và kiểm tra chi tiết chứng chỉ: issuer, subject, expiry.
• Hoặc từ một máy ngoài chạy:

bashCopy
openssl s_client -connect your-domain:443 -servername your-domain -showcerts < /dev/null

Kết quả hiển thị chứng chỉ của bạn, tiếp theo là chain intermediate.

---

4. Gia hạn chứng chỉ

Chứng chỉ thương mại thường có hạn 1 năm. Trước khi hết hạn:

1. Vào lại trang Install SSL.
2. Chọn cùng domain.
3. Dán chứng chỉ + CA bundle mới (khóa riêng giữ nguyên nếu không rekey).
4. Nhấn Install — vPanel ghi đè file cũ.

Nếu muốn gia hạn tự động, hãy dùng AutoSSL (Let's Encrypt) thay vì chứng chỉ thương mại.

---

5. Xử lý sự cố

---

Chúc bạn quản trị Server an toàn và hiệu quả!