HƯỚNG DẪN KHẮC PHỤC LỖI PHIÊN BẢN CUSTOMBUILD TRÊN DIRECTADMIN

Ngày đăng: 26 Th03 2026

Khi quản trị máy chủ sử dụng DirectAdmin, bạn có thể gặp thông báo lỗi:

" Your DirectAdmin version is older than minimal required for this version of CustomBuild "

Lỗi này xuất hiện khi script CustomBuild yêu cầu một phiên bản DirectAdmin tối thiểu cao hơn phiên bản hiện tại bạn đang cài đặt.

1. Tìm hiểu về CustomBuild

CustomBuild là một công cụ mạnh mẽ (dưới dạng script) tích hợp trong DirectAdmin, đóng vai trò "quản kho" cho toàn bộ hệ thống. Nhiệm vụ chính bao gồm:

Cài đặt & Cập nhật: Quản lý các dịch vụ cốt lõi như Web Server (Apache, Nginx, OpenLiteSpeed), PHP, MySQL/MariaDB.
Tùy biến hệ thống: Cho phép lựa chọn phiên bản PHP, bật/tắt các module Apache và tối ưu hóa hiệu suất Server.
Bảo mật: Cập nhật các bản vá lỗi cho các dịch vụ đang chạy.

2. Phân tích nguyên nhân lỗi

Thông báo lỗi xảy ra khi có sự không đồng bộ giữa Phiên bản DirectAdmin và Script CustomBuild:

Phiên bản DirectAdmin hiện tại quá cũ.
Bạn đang chạy bản CustomBuild mới hơn, đòi hỏi các API hoặc tính năng chỉ có trên DirectAdmin đời cao.

Giải pháp tối ưu: Nếu License của bạn hợp lệ, hãy thực hiện update DirectAdmin để đảm bảo tính bảo mật và tương thích lâu dài. Hướng dẫn dưới đây chỉ nên dùng làm phương án xử lý tạm thời.

3. Quy trình khắc phục (Bypass Version Check)

Phương pháp này sẽ giúp bạn bỏ qua bước kiểm tra phiên bản (Bypass) để tiếp tục thực hiện các thao tác cài đặt/nâng cấp dịch vụ.

Bước 1: Kết nối SSH vào Server

Sử dụng các phần mềm như PuTTY, Bitvise hoặc Terminal để đăng nhập vào VPS/Server với quyền root.
Link hướng dẫn tham khảo: Hướng dẫn SSH máy chủ bằng phần mềm putty

Bước 2: Truy cập thư mục điều hành

Chạy lệnh sau để di chuyển vào thư mục quản lý của CustomBuild:

cd /usr/local/directadmin/custombuild

Bước 3: Chỉnh sửa file thực thi

Sử dụng trình soạn thảo vi để can thiệp vào mã nguồn của script build:

vi build

Bước 4: Loại bỏ hàm kiểm tra phiên bản (doDAVersionCheck)

Trong giao diện chỉnh sửa của vi, thực hiện các thao tác sau:

Tìm kiếm: Nhấn phím / sau đó nhập doDAVersionCheck và nhấn Enter.
Xác định: Tìm đến đoạn mã định nghĩa function (hàm) này.
Xóa bỏ: Xóa toàn bộ nội dung từ tên hàm cho đến dấu đóng ngoặc nhọn } cuối cùng của hàm đó.

Mẹo: Bạn có thể nhấn phím dd để xóa nhanh từng dòng trong vi.

Bước 5: Lưu thay đổi và Thoát

Nhấn phím Esc để thoát chế độ chỉnh sửa.
Nhập lệnh :wq hoặc :x và nhấn Enter để lưu lại và thoát ra ngoài.

Bước 6: Kiểm tra sau khi cấu hình.

Bạn có thể nhập lệnh test ví dụ: ./build rewrite_confs

Nếu không còn lỗi version đã cấu hình thành công.

4. Cơ chế hoạt động của giải pháp

Hàm doDAVersionCheck thực chất là một "chốt chặn" logic. Nó so sánh biến số phiên bản DA hiện tại với giá trị hằng số yêu cầu. Bằng cách xóa bỏ hàm này, chúng ta đã loại bỏ điều kiện dừng của script, giúp CustomBuild có thể thực thi các lệnh tiếp theo mà không bị gián đoạn bởi thông báo lỗi phiên bản.

5. Tổng kết và Khuyến nghị

Việc can thiệp trực tiếp vào file build là cách nhanh nhất để xử lý sự cố trong các trường hợp khẩn cấp hoặc hệ thống không thể nâng cấp. Tuy nhiên, bạn cần lưu ý:

Tính ổn định: Một số tính năng mới của CustomBuild có thể không hoạt động hoàn hảo trên nền tảng DA cũ.
Bảo mật: Hệ thống cũ luôn tiềm ẩn rủi ro bị tấn công cao hơn.

CloudFly đơn vị tiên phong tại Việt Nam cung cấp dịch vụ Cloud Server và Cloud Hosting tùy chỉnh cấu hình

CLOUDFLY tự hào là đơn vị tiên phong tại Việt Nam cung cấp dịch vụ Cloud Server, Cloud Hosting tùy chỉnh cấu hình. Chúng tôi nhận được sự tin tưởng và hợp tác với hơn 15.000 khách hàng trong và ngoài nước. Sẵn sàng đồng hành và đem lại những giải pháp tối ưu nhất cho bạn.

Nếu quý khách hàng gặp khó khăn hay có bất kì thắc mắc nào. Hãy liên hệ theo thông tin bên dướ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

Chia sẻ