Lỗi cài đặt

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ủ

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.
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

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.
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ợ.

Tải xuống và xác thực

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ụ

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

nginx và 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, 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

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.
ERR_TOO_MANY_REDIRECTS	Chế độ SSL của Cloudflare là Flexible	Đặt thành Full (strict) — chi tiết.
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.