แก้ปัญหา

Repository sync หรือ ตรวจ App อัตโนมัติ ล้มเหลว

ตรวจว่า Git ใน Setup ถูกติดตั้งแล้ว, URL/protocol และ HTTPS credential ถูกต้อง, branch มีอยู่ และ directory อยู่ภายใน repository การตรวจ runtime อ่านเฉพาะ metadata จาก shallow checkout เท่านั้น และยังตรวจ SSH repository ไม่ได้จนกว่าจะมี deploy-key support จึงให้ใช้ HTTPS ไปก่อน

Build หรือ candidate health ล้มเหลว

เปิด deployment log ก่อน ตรวจว่า repository directory ที่เลือกมี package.json, start script และแอป listen ที่ PORT ที่ Portal กำหนด Native project ต้องตอบ HTTP health path เป็น 2xx หรือ 3xx ปิด health check เฉพาะเมื่อแอปไม่มี HTTP endpoint จริง

Mail Setup ขึ้น ready แต่เมลไม่ถึง

ผล readiness บอกเฉพาะ SMTP ขาออกและ local firewall policy ตรวจ mail hostname ว่าเป็น DNS-only, MX/SPF/DKIM/DMARC และ PTR ให้ถูกต้อง แล้วส่งและรับเมลจริงกับ provider ภายนอก ตรวจ cloud-provider firewall แยกต่างหาก และห้ามใช้ fixture Mail inbox เป็น receive test

Domain หรือ certificate ล้มเหลว

ตรวจ DNS จาก Domains ยืนยันว่า port 80 เข้า target host ได้ และเอา CDN proxy/forced HTTPS ออกชั่วคราวก่อน HTTP-01 certificate แรก ตรวจว่า Nginx virtual host อื่นยังไม่ได้ใช้ชื่อนั้น Portal จะเก็บ managed Nginx configuration เดิมไว้หาก TLS activation ล้มเหลว

Portal update ดูไม่ปกติ

ตรวจทั้งสาม service, loopback health และ static HTTPS page: sudo systemctl is-active dashboard-portal hostmgr-deploy-helper nginx, curl -fsS http://127.0.0.1:3100/api/health และ curl -fsSI https://YOUR-PORTAL-DOMAIN/ อย่าถือว่า health JSON สำเร็จเป็น acceptance check เพียงอย่างเดียว