Anasaki Studio

ตั้งค่าและดูแลระบบ

แก้ปัญหาที่พบบ่อย

รวมอาการที่เจอบ่อยตอนติดตั้งและใช้งาน Anasaki Studio พร้อมสาเหตุและวิธีแก้ — ตั้งแต่ระบบไม่ยอมเริ่ม ลืมที่อยู่หน้าจัดการ จนถึงอีเมลไม่ออก

อ่าน 7 นาทีอัปเดตล่าสุด

ดูเป็น Markdown

ในหน้านี้

ดู 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: 1010Cloudflare บล็อก 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