---
title: Lỗi cài đặt
description: Mọi thông báo lỗi từ trình cài đặt NexCMP, nguyên nhân và cách xử lý — yêu cầu hệ thống, kích hoạt license, xác minh tải về, dịch vụ và nginx/TLS.
url: https://nexcmp.com/vi/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Lỗi cài đặt {#installation-errors}

Trình cài đặt sẽ dừng lại ở lỗi nghiêm trọng đầu tiên và in dòng chữ màu đỏ bắt đầu bằng `✗`. Hãy khắc phục nguyên nhân và **chạy lại lệnh đó** — trình cài đặt an toàn để chạy lại nhiều lần. Các dòng thông tin bắt đầu bằng `•`, các bước thành công bắt đầu bằng `✓`.

## Kiểm tra máy chủ {#machine-checks}

| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
| `must be run as root (sudo)` | Không chạy dưới quyền root | Thêm `sudo` vào trước lệnh, hoặc chạy với quyền root. |
| `only Ubuntu 22.04/24.04 is supported (this host: …)` | Bản phân phối hoặc phiên bản khác | Hãy sử dụng máy chủ Ubuntu 22.04 hoặc 24.04. |
| `only x86_64 is supported` | CPU ARM hoặc kiến trúc khác | Sử dụng máy chủ x86_64. |
| `requires ≥ 2 GB RAM (host has … MB)` | Không đủ bộ nhớ | Bổ sung thêm RAM. |
| `requires ≥ 8 GB free disk space on / (… GB available)` | Hệ thống tệp root gần đầy | Giải phóng dung lượng hoặc mở rộng `/`. |
| `missing --license` / `missing --domain` | Cài đặt lần đầu thiếu các tham số đó | Truyền cả hai tham số — xem [Cài đặt](https://nexcmp.com/vi/docs/getting-started/installation/#parameters). |
| `unknown argument: …` | Sai chính tả trong tham số | Kiểm tra chính tả; chạy lại với `--help`. |
| `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | Trình quản lý gói đang bị khóa | Chờ vài phút (Ubuntu mới cài sẽ tự động cập nhật sau khi khởi động) rồi chạy lại. |
| `… is a symlink — aborting` | `/opt/nexcmp` hoặc `/etc/nexcmp` là liên kết tượng trưng (symlink) | Thay thế bằng một thư mục thực — trình cài đặt từ chối symlink vì lý do bảo mật. |

## Kích hoạt giấy phép {#license-activation}

| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
| `cannot connect to https://nexcmp.com` | Không có kết nối HTTPS chiều đi tới máy chủ cấp phép | Kiểm tra DNS, firewall và proxy trên máy chủ: `curl -I https://nexcmp.com`. |
| `license activation failed (HTTP …): <message>` | Máy chủ cấp phép từ chối khóa | Đọc thông báo lỗi: sai khóa, tên miền không khớp với giấy phép, giấy phép bị tạm ngưng hoặc thu hồi. Kiểm tra trang quản lý giấy phép tại [nexcmp.com/licenses](https://nexcmp.com/licenses). |
| `no release available for this license yet` | Giấy phép không có bản phát hành nào để tải xuống | Liên hệ bộ phận bán hàng; xem [Hỗ trợ](https://nexcmp.com/vi/docs/troubleshooting/support/). |

## Tải xuống và xác thực {#download-and-verification}

| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
| `failed to download release X` | Sự cố mạng trong quá trình tải xuống | Chạy lại. |
| `sha256 mismatch (… ≠ …)` | Tệp bị lỗi khi truyền hoặc đã bị thay đổi | Chạy lại; nếu lỗi lặp lại, có thể proxy đang sửa đổi dữ liệu tải xuống — hãy thử từ một mạng khác. |
| `release X is unsigned — refusing to install` | Máy chủ không trả về chữ ký | Tuyệt đối không bỏ qua bước này; hãy liên hệ hỗ trợ. |
| `INVALID SIGNATURE for version X — aborting` | Chữ ký Ed25519 không khớp | **Không** cài đặt. Liên hệ hỗ trợ — điều này có nghĩa tệp không phải bản phát hành chính thức. |
| `openssl failed to read public key` | OpenSSL quá cũ hoặc bị lỗi | Cập nhật gói `openssl`. |
| `invalid version: …` | Dữ liệu bất thường từ máy chủ | Chạy lại; liên hệ hỗ trợ nếu lỗi vẫn tiếp diễn. |

## Khởi động dịch vụ {#service-start}

| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
| `service failed to start — check: journalctl -u nexcmp -n 50` | Panel không phản hồi `/healthz` trong vòng 3 phút | Đọc journal. Các nguyên nhân phổ biến: cổng (mặc định 3000) đã bị chiếm dụng (`ss -ltnp | grep 3000`) — hãy cài đặt lại với `--port`; các tệp thuộc sở hữu của root trong `/var/lib/nexcmp` — chạy `sudo nexcmp fix-owner`. |

## nginx và TLS {#nginx-and-tls}

| Thông báo | Nguyên nhân | Cách khắc phục |
|---|---|---|
| `DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS` | Bản ghi A/AAAA bị thiếu hoặc không chính xác | Xem [DNS và Cloudflare](https://nexcmp.com/vi/docs/getting-started/dns-and-cloudflare/), sau đó chạy lại. |
| `certbot could not get a certificate yet — re-run the installer once DNS has settled` | Xác thực Let's Encrypt thất bại (cổng 80 bị chặn, DNS chưa cập nhật, vượt quá rate limit) | Mở cổng 80, chờ DNS cập nhật rồi chạy lại. Kiểm tra `/var/log/letsencrypt/letsencrypt.log`. |
| `certbot could not renew now — keeping the existing certificate` | Lỗi gia hạn tạm thời | Không ảnh hưởng; hãy chạy lại sau. |
| `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | Xung đột với một trang nginx khác (trùng `server_name`, cấu hình bị lặp) | Chạy `sudo nginx -t` và xử lý xung đột, sau đó chạy lại. |
| `apt-get could not install nginx` / `certbot`, hoặc `E: Failed to fetch … 404 Not Found` | Trình quản lý gói bị khóa hoặc index gói của máy chủ đã cũ (thường gặp trên image mẫu đã lâu không cập nhật) | Chạy `sudo apt-get update`, chờ các tiến trình apt khác hoàn tất, sau đó chạy lại trình cài đặt. |
| `openssl could not create the self-signed certificate` | Lỗi OpenSSL | Cập nhật `openssl`; chạy lại. |

## Sau khi cài đặt {#after-installation}

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Trình duyệt không thể mở `https://<domain>` | DNS hoặc TLS chưa sẵn sàng | `sudo nexcmp status`; sử dụng [quyền truy cập khẩn cấp](https://nexcmp.com/vi/docs/getting-started/cli-reference/#emergency-access). |
| `ERR_TOO_MANY_REDIRECTS` | Chế độ SSL của Cloudflare là **Flexible** | Đặt thành **Full (strict)** — [chi tiết](https://nexcmp.com/vi/docs/getting-started/dns-and-cloudflare/). |
| Wizard báo "setup code" không đúng | Nhập sai hoặc dùng mã từ lần cài đặt trước | Chạy `sudo nexcmp status` và sao chép mã hiện tại. |
| License báo HTTP 421 | Các file trong `/var/lib/nexcmp` thuộc quyền sở hữu của root | `sudo nexcmp fix-owner`, sau đó `sudo systemctl restart nexcmp`. |