---
title: "Hướng dẫn upgrade cho máy chủ CyberPanel (Cập nhật mới nhất 2025)"
description: "Bài viết hướng dẫn chi tiết cách upgrade CyberPanel lên phiên bản mới nhất (2.4 Build 4) giúp tăng hiệu năng, bảo mật và sửa lỗi phổ biến như “Latest commit does not match” hoặc “sudo: unable to resolve host”. Bao gồm các bước kiểm tra phiên bản, fix hostname, backup dữ liệu, và chạy script preUpgrade.sh qua SSH để nâng cấp an toàn. Kèm checklist trước – sau update, xử lý lỗi thường gặp và mẹo quản trị hệ thống dành cho admin server."
url: https://cloudfly.vn/huong-dan-upgrade-cho-may-chu-cyberpanel-cap-nhat-moi-nhat-2025
image: https://media.cloudfly.vn/posts/Hướng_dẫn_upgrade_cho_máy_chủ_CyberPanel.jpg
---

# Hướng dẫn upgrade cho máy chủ CyberPanel (Cập nhật mới nhất 2025)

![](https://media.cloudfly.vn/posts/Hướng_dẫn_upgrade_cho_máy_chủ_CyberPanel.jpg)  
**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

![](https://media.cloudfly.vn/posts/image_MacN8yq.png)

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  
    ![](https://media.cloudfly.vn/posts/image_2yL7oid.png)
2.  Sửa file hosts:  
    nano /etc/hosts

     3. Thêm dòng:  
            127.0.0.1   instance-60183297  
![](https://media.cloudfly.vn/posts/image_ZcCswTJ.png)

     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.  
![](https://media.cloudfly.vn/posts/image_mPxVZRX.png)

## **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)  
    ![](https://media.cloudfly.vn/posts/image_JuElCT8.png)
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**.  
    ![](https://media.cloudfly.vn/posts/image_BH0vhmi.png)

      3. Reboot server:  
          reboot  
![](https://media.cloudfly.vn/posts/image_72h5dOW.png)  
  
       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.  
![](https://media.cloudfly.vn/posts/image_7iVwHTI.png)

## **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/](https://cloudfly.vn/)

FACEBOOK: [https://www.facebook.com/cloudfly.vn](https://www.facebook.com/cloudfly.vn)

TELEGRAM CHANNELS: [https://t.me/cloudflyvn](https://t.me/cloudflyvn)
