ดู log ก่อน#
docker compose ps # สถานะ container ทั้งสองตัว (mysql, studio)
docker compose logs -f studio # log ของ Anasaki Studio
docker compose logs mysql # log ของฐานข้อมูล
ติดตั้งและเริ่มระบบ#
| อาการ | สาเหตุ / วิธีแก้ |
|---|
docker compose up ขึ้นข้อความ set JWT_SECRET / set MYSQL_PASSWORD / set CODE_DB_PASSWORD | ยังไม่ได้ใส่ค่าที่ต้องตั้งใน .env (หรือ .env ไม่ได้อยู่โฟลเดอร์เดียวกับ docker-compose.yml) — ดู ตัวแปรใน .env |
| studio รอไม่ยอมขึ้น / ต่อฐานข้อมูลไม่ได้ | MySQL ยังเริ่มไม่เสร็จ (studio รอ health check) — ดู docker compose logs mysql; รหัสผ่านที่มีอักขระพิเศษอาจทำให้ connection string ผิด ใช้ตัวอักษรและตัวเลขเท่านั้น |
เปลี่ยน MYSQL_PASSWORD แล้วต่อฐานข้อมูลไม่ได้ | รหัสผ่านถูกอ่านเฉพาะตอนสร้างฐานข้อมูลครั้งแรก ให้ใช้ค่าเดิม หรือเปลี่ยนรหัสใน MySQL ด้วยตัวเองให้ตรงกัน |
เปิด http://…:8090 ไม่ได้ | พอร์ตชน — เปลี่ยน PORT ใน .env; หรือ firewall ของเซิร์ฟเวอร์ปิดพอร์ตไว้ |
| เว็บที่สองบนเครื่องเดียวกันไปทับเว็บแรก | ตั้ง COMPOSE_PROJECT_NAME และ PORT ไม่ซ้ำกันในแต่ละโฟลเดอร์ |
เข้าหน้าจัดการ#
| อาการ | สาเหตุ / วิธีแก้ |
|---|
ลืมที่อยู่หน้าจัดการที่เปลี่ยนไว้ (/admin ขึ้น 404) | ใส่ ADMIN_PATH=admin ใน .env แล้ว docker compose up -d (ความปลอดภัย) |
| ทุกคนถูกออกจากระบบพร้อมกัน | JWT_SECRET ถูกเปลี่ยน — เป็นเรื่องปกติ เข้าสู่ระบบใหม่ |
| ล็อกอินไม่ได้ ขึ้นว่า "ผิดหลายครั้งเกินไป" | ใส่รหัสผิด 10 ครั้งใน 15 นาทีจาก IP เดียวกัน (ตอบช้าลงตั้งแต่ครั้งที่ 4) รอ 15 นาที หรือล็อกอินจากเครือข่ายอื่น — ถ้าเกิดกับทุกคนพร้อมกัน ดู "หลัง reverse proxy" ด้านล่าง |
| อัปเกรดเป็น 2.3.0 แล้วต้องล็อกอินใหม่ | ปกติ: หน้าจัดการเก็บ session ในคุกกี้ HttpOnly แทน localStorage (สคริปต์ในหน้าอ่านไม่ได้) ล็อกอินใหม่ครั้งเดียว — สคริปต์และ CLI ยังใช้ Authorization: Bearer ได้เหมือนเดิม |
| ลืมรหัสผ่านและอีเมลยังไม่ได้ตั้ง | ให้ผู้ดูแลคนอื่นตั้งรหัสผ่านใหม่ให้ที่ ผู้ใช้งาน |
| เข้าสู่ระบบแล้วขึ้นว่าบัญชีถูกระงับ | ผู้ดูแลระงับบัญชีไว้ — ให้ผู้ดูแลกด เปิดใช้งาน ที่หน้าผู้ใช้งาน ทุกครั้งที่พยายามเข้าสู่ระบบจะอยู่ใน บันทึกกิจกรรม |
อีเมล#
| อาการ | สาเหตุ / วิธีแก้ |
|---|
| ส่งอีเมลทดสอบไม่สำเร็จ | ตรวจเซิร์ฟเวอร์ พอร์ต การเข้ารหัส; Gmail ต้องใช้ "รหัสผ่านสำหรับแอป"; บาง VPS บล็อกพอร์ต 25/465/587 ขาออก |
ลิงก์ในอีเมลตั้งรหัสผ่านพาไปที่อยู่ผิด (เช่น localhost) | ตั้ง SITE_URL=https://โดเมนของคุณ ใน .env |
| ผู้ใช้ไม่เห็นอีเมล | ให้ดูโฟลเดอร์จดหมายขยะ; ลิงก์ลืมรหัสผ่านใช้ได้ 2 ชั่วโมง ลิงก์ต้อนรับ 3 วัน |
หลัง reverse proxy#
| อาการ | สาเหตุ / วิธีแก้ |
|---|
| สถิติทุกคนมาจาก IP เดียว / ถูกจำกัดการล็อกอินทั้งเว็บ | ตั้ง TRUST_PROXY=true (เฉพาะเมื่อพอร์ต 8090 ไม่เปิดตรงสู่อินเทอร์เน็ต) อยู่หลัง Cloudflare ดู อยู่หลัง Cloudflare |
สคริปต์เรียก API ได้ 403 error code: 1010 | Cloudflare บล็อก User-Agent เริ่มต้นของไลบรารี — ตั้ง User-Agent เอง เช่น my-script/1.0 |
เบราว์เซอร์ไม่บังคับ https (header Strict-Transport-Security: max-age=0) | HSTS ของ Cloudflare ตั้ง Max Age เป็น 0 — แก้ที่ Cloudflare → SSL/TLS → Edge Certificates |
| อัปโหลดไฟล์ใหญ่แล้วล้มเหลว | proxy จำกัดขนาด request (เช่น Nginx client_max_body_size) — ปรับให้ใหญ่กว่า "ขนาดไฟล์สูงสุด" ใน ตั้งค่าเว็บไซต์ → ไฟล์และสื่อ |
ปลั๊กอิน#
| อาการ | สาเหตุ / วิธีแก้ |
|---|
| หน้าร้านปลั๊กอินขึ้นว่าเชื่อมต่อ Store ไม่ได้ | เซิร์ฟเวอร์ออกอินเทอร์เน็ตไม่ได้ — ยังติดตั้งจากไฟล์ .zip ที่แท็บ อัปโหลด .zip ได้ |
| ติดตั้งไม่ได้ ขึ้นว่าลายเซ็นของแพ็กเกจไม่ถูกต้อง / ไม่มีลายเซ็น | แพ็กเกจถูกแก้ระหว่างทาง หรือไม่ได้มาจากร้านที่เว็บเชื่อถือ (CMS 2.4.0) ลองใหม่อีกครั้ง ถ้าใช้ Store ของตัวเอง ตรวจ STORE_URL / STORE_PUBLIC_KEY (ติดตั้ง อัปเดต และลบปลั๊กอิน) |
| ปลั๊กอินปิดเองหลังอัปเดต | เวอร์ชันใหม่ขอสิทธิ์เพิ่ม — กด อนุมัติและเปิดใช้ (สิทธิ์ที่ปลั๊กอินขอ) |
| เปิดใช้ไม่สำเร็จ / ต้องใช้ปลั๊กอินอื่นก่อน | ติดตั้งและเปิดปลั๊กอินที่ต้องใช้ก่อน (หน้าต่างจะเสนอ ติดตั้งทั้งหมด) |
| แถบ "มีปลั๊กอิน N ตัวรอย้าย…" ไม่หาย | ดู อัปเดตเวอร์ชันและย้ายจากปลั๊กอินในตัว |
| บล็อกปลั๊กอินในหน้าเว็บหายไป | ปลั๊กอินถูกปิดหรือลบ — เปิดปลั๊กอินอีกครั้ง บล็อกจะกลับมา |
โค้ดของเว็บไซต์ (Site Code)#
| อาการ | สาเหตุ / วิธีแก้ |
|---|
| โค้ดที่เผยแพร่ทำให้เว็บพัง | เปิด Safe mode ที่หน้าโค้ดของเว็บไซต์; ถ้าเข้าหน้าจัดการไม่ได้ ให้เพิ่ม SITE_CODE_DISABLED: "true" ใต้ environment: ของ service studio ใน docker-compose.yml แล้ว docker compose up -d |
| หน้าฐานข้อมูลขึ้น "โหมดสำรอง" และใช้ SQL console ไม่ได้ | ยังไม่ได้ตั้งฐานข้อมูลแยก — ดู ฐานข้อมูลของ Site Code |
| ค่าลับที่บันทึกไว้อ่านไม่ได้หลังย้ายเครื่อง | ไฟล์ site-code.key (หรือ SITE_CODE_SECRET_KEY) ไม่ได้ย้ายมาด้วย — ใช้กุญแจเดิม หรือกรอกค่าลับใหม่ |
ปัญหาอื่นของนักพัฒนา ดู Site Code และ anasaki-code CLI