ข้อผิดพลาดในการติดตั้ง
ตัวติดตั้งจะหยุดทำงานเมื่อพบปัญหาสำคัญตัวแรกและพิมพ์บรรทัดสีแดงที่ขึ้นต้นด้วย ✗ แก้ไขสาเหตุและรันคำสั่งเดิมอีกครั้ง — ตัวติดตั้งสามารถทำซ้ำได้อย่างปลอดภัย บรรทัดแจ้งข้อมูลจะขึ้นต้นด้วย • และขั้นตอนที่สำเร็จจะขึ้นต้นด้วย ✓
การตรวจสอบเครื่อง
| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
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 |
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 เพื่อความปลอดภัย |
การเปิดใช้งานไลเซนส์
| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
cannot connect to https://nexcmp.com | ไม่มีการเชื่อมต่อ HTTPS ภายนอกไปยังเซิร์ฟเวอร์ไลเซนส์ | ตรวจสอบ DNS, ไฟร์วอลล์ และพร็อกซีบนเซิร์ฟเวอร์: curl -I https://nexcmp.com |
license activation failed (HTTP …): <message> | เซิร์ฟเวอร์ไลเซนส์ปฏิเสธคีย์นี้ | อ่านข้อความ: คีย์ไม่ถูกต้อง, โดเมนไม่ตรงกับไลเซนส์, ไลเซนส์ถูกระงับหรือถูกเพิกถอน ตรวจสอบหน้าไลเซนส์ที่ nexcmp.com/licenses |
no release available for this license yet | ไลเซนส์นี้ไม่มีรีลีสให้ดาวน์โหลด | ติดต่อฝ่ายขาย ดูที่ Support |
การดาวน์โหลดและการตรวจสอบ
| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
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 failed to start — check: journalctl -u nexcmp -n 50 | แผงควบคุมไม่ตอบสนองต่อ /healthz ภายใน 3 นาที | อ่านบันทึกของระบบ สาเหตุทั่วไป: พอร์ต (ค่าเริ่มต้น 3000) ถูกใช้งานอยู่ (`ss -ltnp |
nginx และ TLS
| ข้อความ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | เรกคอร์ด A/AAAA หายไปหรือไม่ถูกต้อง | ดูที่ 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 แล้วรันใหม่อีกครั้ง |
หลังการติดตั้ง
| อาการ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
เบราว์เซอร์ไม่สามารถเปิด https://<domain> | DNS หรือ TLS ยังไม่พร้อม | sudo nexcmp status; ใช้ emergency access |
ERR_TOO_MANY_REDIRECTS | โหมด SSL ของ Cloudflare คือ Flexible | ตั้งค่าเป็น Full (strict) — ดูรายละเอียด |
| วิซาร์ดแจ้งว่า "setup code" ไม่ถูกต้อง | พิมพ์ผิดหรือเป็นโค้ดจากการติดตั้งครั้งก่อน | รัน sudo nexcmp status แล้วคัดลอกโค้ดปัจจุบัน |
| ไลเซนส์แสดง HTTP 421 | ไฟล์ใน /var/lib/nexcmp เป็นของ root | sudo nexcmp fix-owner จากนั้น sudo systemctl restart nexcmp |