Chuyển tới nội dung chính

Khắc phục các lỗi thường gặp khi cài đặt cPanel/WHM

Giới Thiệu​

cPanel & WHM (Web Host Manager) là bộ công cụ quản lý hosting mạnh mẽ, được hàng triệu quản trị viên và nhà cung cấp dịch vụ hosting tin dùng. Nó cung cấp giao diện trực quan để quản lý website, email, cơ sở dữ liệu và nhiều hơn nữa. Tuy nhiên, quá trình cài đặt cPanel/WHM đôi khi có thđ gặp phải các lỗi không mong muốn, khiến việc triển khai trở nên khó khăn.

Bài viết này sẽ đi sâu vào các lỗi phổ biến nhất khi cài đặt cPanel/WHM và cung cấp các giải pháp từng bước để khắc phục chúng, giúp bạn hoàn tất quá trình cài đặt một cách suôn sẻ.

📋 Thời gian: 15-30 phút | Độ khó: Trung bình

Yêu Cầu​

Để cài đặt cPanel/WHM thành công và khắc phục các lỗi hiệu quả, bạn cần đảm bảo các điều kiện tiên quyết sau:

  • Hệ điều hành: Một phiên bản hệ điều hành Linux 64-bit sạch (fresh installation) được hỗ trợ. Hiện tại, cPanel/WHM hỗ trợ AlmaLinux OS, Rocky Linux™ và CentOS 7 (CentOS 7 sẽ kết thúc vòng đời vào tháng 6/2024, khuyến nghị sử dụng AlmaLinux hoặc Rocky Linux).
  • Tài nguyên phần cứng tối thiểu:
    • RAM: Tối thiểu 1 GB (khuyến nghị 2 GB trở lên).
    • CPU: Tối thiểu 1 lõi (khuyến nghị 2 lõi trở lên).
    • Dung lượng đĩa: Tối thiểu 20 GB trống (khuyến nghị 40 GB trở lên).
  • Kết nối mạng: Kết nối internet ổn định và địa chỉ IP tĩnh.
  • Hostname: Một hostname hợp lệ có định dạng FQDN (Fully Qualified Domain Name), ví dụ: host.yourdomain.com.
  • Quyền truy cập: Quyền truy cập root vào máy chủ thông qua SSH.

Các Bước Chuẩn Bị Trước Khi Cài Đặt​

Trước khi tiến hành cài đặt cPanel/WHM, việc chuẩn bị kỹ lưỡng sẽ giúp giảm thiểu các lỗi phát sinh.

Bước 1: Cập nhật hệ thống​

Luôn đảm bảo hệ thống của bạn được cập nhật lên phiên bản mới nhất để có các bản vá lỗi và cải thiện hiệu suất.

# Cập nhật tất cả các gói hệ thống
sudo yum update -y

Bước 2: Vô hiệu hóa SELinux​

SELinux (Security-Enhanced Linux) có thể gây xung đột với quá trình cài đặt cPanel. Bạn nên vô hiệu hóa nó trước khi cài đặt.

# Đặt SELinux ở chế độ Permissive ngay lập tức (không cần khởi động lại)
sudo setenforce 0

# Mở file cấu hình SELinux để vô hiệu hóa vĩnh viễn
sudo vi /etc/selinux/config

Tìm dòng SELINUX=enforcing và thay đổi thành SELINUX=disabled. Sau khi thay đổi, bạn cần khởi động lại máy chủ để thay đổi có hiệu lực hoàn toàn (nhưng setenforce 0 đã đủ cho quá trình cài đặt).

# Khởi động lại hệ thống để áp dụng thay đổi SELinux (nđu cần)
# sudo reboot

Bước 3: Đặt hostname hợp lệ​

Hostname của máy chủ phải là một FQDN và không được trùng với tên miền chính mà bạn sẽ host.

# Đặt hostname mới, ví dụ: host.yourdomain.com
sudo hostnamectl set-hostname host.yourdomain.com

# Kiểm tra lại hostname để đảm bảo đã được đặt đúng
hostname

⚠️ Lưu ý: Đảm bảo rằng hostname này có một bản ghi DNS A trỏ về địa chỉ IP công cộng của máy chủ của bạn.

Bước 4: Tải và chạy script cài đặt cPanel​

Sau khi đã chuẩn bị xong, bạn có thể tiến hành tải và chạy script cài đặt cPanel/WHM.

# Di chuyển vào thư mục home
cd /home

# Tải script cài đặt cPanel
curl -o latest -L https://securedownloads.cpanel.net/latest

# Chạy script cài đặt
sh latest

Quá trình này có thể mất khá nhiều thời gian tùy thuộc vào tốc độ mạng và hiệu suất máy chủ.

Troubleshooting - Lỗi thường gặp và cách xử lý​

Dưới đây là một số lỗi phổ biến bạn có thể gặp phải trong quá trình cài đặt cPanel/WHM và cách khắc phục:

1. Lỗi tài nguyên hệ thống thấp hoặc hệ điều hành không tương thích​

  • Mô tả: Quá trình cài đặt dừng lại với thông báo như cPanel requires a specific OS hoặc Not enough RAM/CPU.
  • Nguyên nhân: Máy chủ không đáp ứng yêu cầu tối thiểu về RAM, CPU, dung lượng đĩa hoặc đang chạy một hệ điều hành không được hỗ trợ.
  • Khắc phục:
    • Kiểm tra phiên bản hệ điều hành: 
      cat /etc/os-release
      Đảm bảo là AlmaLinux OS, Rocky Linux hoặc CentOS 7.
    • Kiểm tra RAM: 
      free -h
      Đảm bảo có ít nhất 1GB RAM trống.
    • Kiểm tra CPU: 
      nproc
      Đảm bảo có ít nhất 1 lõi CPU.
    • Kiểm tra dung lượng đĩa trống: 
      df -h
      Đảm bảo có ít nhất 20GB dung lượng trống trên phân vùng /.
    • 💡 Mẹo: Nếu tài nguyên không đủ, bạn cần nâng cấp gói VPS/máy chủ của mình hoặc chọn một nhà cung cấp có cấu hình phù hợp.

2. Lỗi SELinux hoặc Firewall (Tường lửa) chặn cài đặt​

  • Mô tả: Cài đặt bị chặn, các dịch vụ cPanel không thể khởi động hoặc không thể truy cập giao diện WHM sau khi cài đặt.
  • Nguyên nhân: SELinux đang ở chế độ enforcing hoặc tường lửa đang chặn các cổng cần thiết của cPanel.
  • Khắc phục:
    • SELinux: Đảm bảo SELinux đã được vô hiệu hóa hoặc ở chế độ permissive. (Xem lại Bước 2 trong phần "Các Bước Chuẩn Bị").
    • Firewall: cPanel/WHM sử dụng các cổng như 2087 (WHM), 2083 (cPanel), 2096 (Webmail), 80 (HTTP), 443 (HTTPS), 21 (FTP), 22 (SSH).
      • Nếu bạn đang sử dụng firewalld (trên AlmaLinux/Rocky Linux/CentOS): 
        # Mở các cổng cần thiết (ví dụ: WHM, cPanel, Webmail)
        sudo firewall-cmd --permanent --add-port=2087/tcp
        sudo firewall-cmd --permanent --add-port=2083/tcp
        sudo firewall-cmd --permanent --add-port=2096/tcp
        sudo firewall-cmd --permanent --add-service=http
        sudo firewall-cmd --permanent --add-service=https
        sudo firewall-cmd --permanent --add-service=ftp
        sudo firewall-cmd --permanent --add-service=ssh

        # Tải lại cấu hình tường lửa
        sudo firewall-cmd --reload
      • Nếu bạn sử dụng iptables, bạn cần thêm các quy tắc tương tự.
      • ⚠️ Cảnh báo: cPanel sẽ tự cấu hình firewall của nó (CSF - ConfigServer Security & Firewall hoặc cPanel's own firewall). Đảm bảo không có firewall khác chặn các cổng trước khi cài đặt. Tốt nhất là tắt firewall trước khi cài đặt và để cPanel tự quản lý sau đó.

3. Lỗi Hostname không hợp lệ hoặc không phân giải được​

  • Mô tả: Cài đặt dừng lại với thông báo Invalid hostname hoặc Could not resolve hostname.
  • Nguyên nhân: Hostname không phải là FQDN, chứa ký tự không hợp lệ, hoặc bản ghi DNS A cho hostname không trỏ về IP của máy chủ.
  • Khắc phục:
    • Đảm bảo hostname là FQDN (ví dụ: host.yourdomain.com). (Xem lại Bước 3 trong phần "Các Bước Chuẩn Bị").
    • Kiểm tra bản ghi DNS A của hostname: 
      dig host.yourdomain.com +short
      Kết quả phải là địa chỉ IP công cộng của máy chủ của bạn. Nếu không, hãy cập nhật bản ghi DNS tại nhà cung cấp tên miền của bạn.

4. Lỗi kết nối mạng hoặc DNS​

  • Mô tả: Script cài đặt không thể tải các gói cần thiết, hiển thị lỗi Failed to connect, Could not resolve host, hoặc Repository not found.
  • Nguyên nhân: Máy chủ không có kết nối internet, cấu hình DNS resolver không đúng, hoặc sự cố mạng tạm thời.
  • Khắc phục:
    • Kiểm tra kết nối internet: 
      ping google.com
      Nếu không ping được, kiểm tra cấu hình mạng của máy chủ.
    • Kiểm tra cấu hình DNS resolver (/etc/resolv.conf): 
      cat /etc/resolv.conf
      Đảm bảo có ít nhất một nameserver hợp lệ, ví dụ: 
      nameserver 8.8.8.8
      nameserver 8.8.4.4
      Bạn có thể chỉnh sửa file này và thêm các nameserver công cộng của Google hoặc Cloudflare.
    • Thử lại cài đặt sau một thời gian ngắn nếu là sự cố mạng tạm thời.

5. Lỗi đĩa cứng đầy hoặc thiếu inodes​

  • Mô tả: Thông báo lỗi No space left on device hoặc Disk quota exceeded trong quá trình cài đặt.
  • Nguyên nhân: Không đủ dung lượng đĩa trống hoặc không đủ inodes (số lượng file/thư mục tối đa) trên phân vùng.
  • Khắc phục:
    • Kiểm tra dung lượng đĩa trống: 
      df -h
    • Kiểm tra inodes còn trống: 
      df -i
    • Giải phđơng dung lượng: Xóa các file không cần thiết, file log cũ, cache, snapshot cũ.
    • 💡 Mẹo: cPanel yêu cầu khá nhiều dung lượng. Luôn bắt đầu với ít nhất 40GB trống để đảm bảo.

6. Lỗi cài đặt cURL hoặc wget​

  • Mô tả: Khi bạn cố gắng tải script cài đặt cPanel bằng curl hoặc wget, bạn nhận được lỗi command not found.
  • Nguyên nhân: Gói curl hoặc wget chưa được cài đặt trên hệ thống.
  • Khắc phục: 
    sudo yum install curl wget -y
    Sau đó, thử lại lệnh tải script cài đặt cPanel.

Kết Luận​

Việc cài đặt cPanel/WHM có thể phức tạp, nhưng bằng cách chuẩn bị kỹ lưỡng và biết cách khắc phục các lỗi phổ biến, bạn có thể đảm bảo quá trình diễn ra suôn sẻ. Luôn bắt đầu với một hệ điều hành sạch, đủ tài nguyên và đảm bảo các yêu cầu về hostname, DNS được đáp ứng.

✅ Best practices:

  • Luôn kiểm tra file log cài đặt cPanel tại /var/log/cpanel-install.log nếu gặp lỗi. Đây là nguồn thông tin quan trọng nhất để chẩn đoán vấn đề.
  • Đảm bảo máy chủ của bạn có kết nối internet ổn định trong suốt quá trình cài đặt.
  • Sau khi cài đặt thành công, hãy truy cập WHM qua https://your_server_ip:2087 và hoàn tất các bước cấu hình ban đầu.

Chúc bạn thành công với việc triển khai cPanel/WHM!

Xem thêm: