Giới thiệu

Nếu bạn đang sử dụng CyberPanel để quản lý máy chủ web chạy LiteSpeed hoặc OpenLiteSpeed, việc upgrade lên phiên bản mới nhất là rất quan trọng. Các bản cập nhật không chỉ mang đến hiệu năng tối ưu hơn, mà còn vá lỗi bảo mật, thêm tính năng mới, và đảm bảo tương thích với hệ điều hành & ứng dụng hiện tại.

Trong bài viết này, Cloudfly sẽ hướng dẫn bạn từng bước để upgrade CyberPanel an toàn, đặc biệt khi gặp thông báo lỗi phổ biến như:

“Note: Latest commit does not match, please upgrade CyberPanel”

hoặc lỗi:

sudo: unable to resolve host instance-xxxxxx: Name or service not known

1. Kiểm tra phiên bản hiện tại của CyberPanel

Đầu tiên, đăng nhập vào CyberPanel qua trình duyệt, sau đó truy cập:

Dashboard → Version Management

Tại đây bạn sẽ thấy thông tin như sau:

Current Version: 2.3

Build: 2

Current Commit: sudo: unable to resolve host instance-60183297

Latest Version: 2.4

Latest Build: 4

Nếu xuất hiện dòng cảnh báo đỏ:

"Latest commit does not match, please upgrade CyberPanel"

Điều này nghĩa là bạn đang dùng phiên bản cũ hơn (2.3), cần nâng cấp lên 2.4 để đồng bộ commit mới nhất.

2. Chuẩn bị trước khi nâng cấp

Trước khi tiến hành upgrade, hãy đảm bảo:

Sao lưu toàn bộ dữ liệu:

• Snapshot VPS/Cloud Server
• Backup Web, Database, Email, DNS Records
• Ghi lại Current Version & Build để rollback khi cần.

Kiểm tra tài nguyên:

Đảm bảo server có đủ:

• RAM ≥ 1GB
• Dung lượng trống ≥ 1GB
• Mạng ổn định, không mất kết nối SSH

3. Sửa lỗi hostname trước khi nâng cấp (rất quan trọng)

Nếu bạn gặp lỗi như ảnh:

sudo: unable to resolve host instance-60183297: Name or service not known

 

→ Điều này nghĩa là hostname của server chưa được ánh xạ trong file /etc/hosts.

🛠 Cách khắc phục:

Đăng nhập SSH với quyền root:
ssh root@your-server-ip

Kiểm tra hostname hiện tại:

hostname

1. Cập nhật hostname đúng:
   hostnamectl set-hostname instance-60183297
   
2. Sửa file hosts:
   nano /etc/hosts

     3. Thêm dòng:
            127.0.0.1   instance-60183297

     4. Lưu lại
            (Ctrl + O, Enter, Ctrl + X)

     5. Kiểm tra:
            ping -c 1 $(hostname)

Nếu ping thành công → bạn đã fix lỗi hostname.

4. Tiến hành upgrade CyberPanel

Bạn có 2 cách nâng cấp, tuy nhiên Cloudfly khuyến nghị dùng SSH (CLI) để đảm bảo ổn định.

🔹Upgrade bằng SSH (khuyến nghị)

Đăng nhập SSH với quyền root:
ssh root@your-server-ip

1. Chạy lệnh upgrade chính thức:
   sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)
   
2. Chờ hệ thống chạy script (mất vài phút) → khi hoàn tất, màn hình báo Thành công như hình bên dưới.
   

      3. Reboot server:
          reboot


       4. Kiểm tra lại
           Truy cập vào tài khoản admin và kiểm tra lại phiên bản:
           Bấm vào versionManagment.

Kết luận

Việc upgrade CyberPanel không chỉ giúp bạn sở hữu phiên bản mới nhất với nhiều tính năng mà còn đảm bảo bảo mật hệ thống, vá lỗi, tối ưu hiệu năng và tương thích tốt hơn với các ứng dụng web.

Trước khi nâng cấp, hãy luôn:

• Kiểm tra và fix lỗi hostname (nếu có cảnh báo unable to resolve host)
• Backup đầy đủ dữ liệu và snapshot VPS
• Thực hiện nâng cấp qua SSH bằng script chính thức để tránh lỗi UI

Sau khi update, bạn nên kiểm tra lại version, trạng thái dịch vụ, và theo dõi changelog để nắm rõ những điểm mới trong phiên bản hiện tại

CloudFly - Đơn giản hóa ứng dụng trên đám mây

HOTLINE: 0904.558.448

WEBSITE: https://cloudfly.vn/

FACEBOOK: https://www.facebook.com/cloudfly.vn

TELEGRAM CHANNELS: https://t.me/cloudflyvn