---
title: ข้อผิดพลาดในการติดตั้ง
description: ข้อความแสดงข้อผิดพลาดทั้งหมดที่ตัวติดตั้ง NexCMP สามารถพิมพ์ได้ สาเหตุและวิธีแก้ไข — ข้อกำหนด การเปิดใช้งานไลเซนส์ การตรวจสอบการดาวน์โหลด บริการ และ nginx/TLS
url: https://nexcmp.com/th/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# ข้อผิดพลาดในการติดตั้ง {#installation-errors}

ตัวติดตั้งจะหยุดทำงานเมื่อพบปัญหาสำคัญตัวแรกและพิมพ์บรรทัดสีแดงที่ขึ้นต้นด้วย `✗` แก้ไขสาเหตุและ**รันคำสั่งเดิมอีกครั้ง** — ตัวติดตั้งสามารถทำซ้ำได้อย่างปลอดภัย บรรทัดแจ้งข้อมูลจะขึ้นต้นด้วย `•` และขั้นตอนที่สำเร็จจะขึ้นต้นด้วย `✓`

## การตรวจสอบเครื่อง {#machine-checks}

| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| `must be run as root (sudo)` | ไม่ได้รันในฐานะ root | ใส่ `sudo` นำหน้าคำสั่ง หรือรันในฐานะ root |
| `only Ubuntu 22.04/24.04 is supported (this host: …)` | ดิสทริบิวชันหรือเวอร์ชันอื่น | ใช้เซิร์ฟเวอร์ Ubuntu 22.04 หรือ 24.04 |
| `only x86_64 is supported` | ARM หรือ CPU อื่น | ใช้เซิร์ฟเวอร์ x86_64 |
| `requires ≥ 2 GB RAM (host has … MB)` | หน่วยความจำน้อยเกินไป | เพิ่ม RAM |
| `requires ≥ 8 GB free disk space on / (… GB available)` | ระบบไฟล์ root เกือบเต็ม | เคลียร์พื้นที่ว่างหรือขยาย `/` |
| `missing --license` / `missing --domain` | ติดตั้งครั้งแรกโดยไม่มีพารามิเตอร์เหล่านั้น | ส่งทั้งสองตัว — ดู [Installation](https://nexcmp.com/th/docs/getting-started/installation/#parameters) |
| `unknown argument: …` | พิมพ์พารามิเตอร์ผิด | ตรวจสอบตัวสะกด; รันด้วย `--help` |
| `apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running)` | ตัวจัดการแพ็กเกจถูกล็อก | รอสักครู่ (Ubuntu ที่เพิ่งติดตั้งใหม่จะรันอัปเดตอัตโนมัติหลังบูต) แล้วรันใหม่อีกครั้ง |
| `… is a symlink — aborting` | `/opt/nexcmp` หรือ `/etc/nexcmp` เป็น symbolic link | แทนที่ด้วยไดเรกทอรีจริง — ตัวติดตั้งไม่อนุญาตให้ใช้ symlink เพื่อความปลอดภัย |

## การเปิดใช้งานไลเซนส์ {#license-activation}

| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| `cannot connect to https://nexcmp.com` | ไม่มีการเชื่อมต่อ HTTPS ภายนอกไปยังเซิร์ฟเวอร์ไลเซนส์ | ตรวจสอบ DNS, ไฟร์วอลล์ และพร็อกซีบนเซิร์ฟเวอร์: `curl -I https://nexcmp.com` |
| `license activation failed (HTTP …): <message>` | เซิร์ฟเวอร์ไลเซนส์ปฏิเสธคีย์นี้ | อ่านข้อความ: คีย์ไม่ถูกต้อง, โดเมนไม่ตรงกับไลเซนส์, ไลเซนส์ถูกระงับหรือถูกเพิกถอน ตรวจสอบหน้าไลเซนส์ที่ [nexcmp.com/licenses](https://nexcmp.com/licenses) |
| `no release available for this license yet` | ไลเซนส์นี้ไม่มีรีลีสให้ดาวน์โหลด | ติดต่อฝ่ายขาย ดูที่ [Support](https://nexcmp.com/th/docs/troubleshooting/support/) |

## การดาวน์โหลดและการตรวจสอบ {#download-and-verification}

| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| `failed to download release X` | เกิดปัญหาเครือข่ายระหว่างดาวน์โหลด | รันใหม่อีกครั้ง |
| `sha256 mismatch (… ≠ …)` | ไฟล์เสียหายเมื่อมาถึงหรือถูกแก้ไข | รันใหม่อีกครั้ง หากเกิดซ้ำ พร็อกซีอาจกำลังเขียนทับการดาวน์โหลด — ลองจากเครือข่ายอื่น |
| `release X is unsigned — refusing to install` | เซิร์ฟเวอร์ไม่ได้ส่งลายเซ็นมา | ห้ามข้ามขั้นตอนเด็ดขาด ติดต่อฝ่ายสนับสนุน |
| `INVALID SIGNATURE for version X — aborting` | ลายเซ็น Ed25519 ไม่ผ่านการตรวจสอบ | ห้ามติดตั้ง **เด็ดขาด** ติดต่อฝ่ายสนับสนุน — นี่หมายความว่าไฟล์ไม่ใช่รีลีสอย่างเป็นทางการ |
| `openssl failed to read public key` | OpenSSL เก่ามากหรือเสียหาย | อัปเดตแพ็กเกจ `openssl` |
| `invalid version: …` | ข้อมูลที่ไม่คาดคิดจากเซิร์ฟเวอร์ | รันใหม่อีกครั้ง ติดต่อฝ่ายสนับสนุนหากยังคงพบปัญหา |

## การเริ่มบริการ {#service-start}

| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| `service failed to start — check: journalctl -u nexcmp -n 50` | แผงควบคุมไม่ตอบสนองต่อ `/healthz` ภายใน 3 นาที | อ่านบันทึกของระบบ สาเหตุทั่วไป: พอร์ต (ค่าเริ่มต้น 3000) ถูกใช้งานอยู่ (`ss -ltnp | grep 3000`) — ติดตั้งใหม่ด้วย `--port`, ไฟล์เป็นเจ้าของโดย root ใน `/var/lib/nexcmp` — รัน `sudo nexcmp fix-owner` |

## nginx และ TLS {#nginx-and-tls}

| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| `DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS` | เรกคอร์ด A/AAAA หายไปหรือไม่ถูกต้อง | ดูที่ [DNS and Cloudflare](https://nexcmp.com/th/docs/getting-started/dns-and-cloudflare/) แล้วรันใหม่อีกครั้ง |
| `certbot could not get a certificate yet — re-run the installer once DNS has settled` | การตรวจสอบของ Let's Encrypt ล้มเหลว (พอร์ต 80 ถูกบล็อก, DNS ยังไม่เผยแพร่, อัตราจำกัด) | เปิดพอร์ต 80, รอให้ DNS อัปเดต, รันใหม่อีกครั้ง ตรวจสอบ `/var/log/letsencrypt/letsencrypt.log` |
| `certbot could not renew now — keeping the existing certificate` | การต่ออายุล้มเหลวชั่วคราว | ไม่เป็นอันตราย รันใหม่อีกครั้งภายหลัง |
| `nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t)` | ไซต์ nginx อื่นเกิดความขัดแย้ง (`server_name` เดียวกัน, การตั้งค่าซ้ำกัน) | รัน `sudo nginx -t` และแก้ไขความขัดแย้ง จากนั้นรันใหม่อีกครั้ง |
| `apt-get could not install nginx` / `certbot` หรือ `E: Failed to fetch … 404 Not Found` | ตัวจัดการแพ็กเกจถูกล็อก หรือดัชนีแพ็กเกจของเซิร์ฟเวอร์เก่าเกินไป (มักพบบนอิมเทมเพลตที่ไม่ได้อัปเดตมาสักระยะ) | รัน `sudo apt-get update`, รอให้กระบวนการ apt อื่นเสร็จสิ้น, แล้วรันตัวinstallerใหม่อีกครั้ง |
| `openssl could not create the self-signed certificate` | ปัญหา OpenSSL | อัปเดต `openssl` แล้วรันใหม่อีกครั้ง |

## หลังการติดตั้ง {#after-installation}

| อาการ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| เบราว์เซอร์ไม่สามารถเปิด `https://<domain>` | DNS หรือ TLS ยังไม่พร้อม | `sudo nexcmp status`; ใช้ [emergency access](https://nexcmp.com/th/docs/getting-started/cli-reference/#emergency-access) |
| `ERR_TOO_MANY_REDIRECTS` | โหมด SSL ของ Cloudflare คือ **Flexible** | ตั้งค่าเป็น **Full (strict)** — [ดูรายละเอียด](https://nexcmp.com/th/docs/getting-started/dns-and-cloudflare/) |
| วิซาร์ดแจ้งว่า "setup code" ไม่ถูกต้อง | พิมพ์ผิดหรือเป็นโค้ดจากการติดตั้งครั้งก่อน | รัน `sudo nexcmp status` แล้วคัดลอกโค้ดปัจจุบัน |
| ไลเซนส์แสดง HTTP 421 | ไฟล์ใน `/var/lib/nexcmp` เป็นของ root | `sudo nexcmp fix-owner` จากนั้น `sudo systemctl restart nexcmp` |