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

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

ที่มา: https://anasaki.live/docs/studio/troubleshooting

## ดู log ก่อน

```sh
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](/docs/studio/env-variables) |
| 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` ([ความปลอดภัย](/docs/studio/site-settings)) |
| ทุกคนถูกออกจากระบบพร้อมกัน | `JWT_SECRET` ถูกเปลี่ยน — เป็นเรื่องปกติ เข้าสู่ระบบใหม่ |
| ล็อกอินไม่ได้ ขึ้นว่า &#34;ผิดหลายครั้งเกินไป&#34; | ใส่รหัสผิด 10 ครั้งใน 15 นาทีจาก IP เดียวกัน (ตอบช้าลงตั้งแต่ครั้งที่ 4) รอ 15 นาที หรือล็อกอินจากเครือข่ายอื่น — ถ้าเกิดกับทุกคนพร้อมกัน ดู &#34;หลัง reverse proxy&#34; ด้านล่าง |
| อัปเกรดเป็น 2.3.0 แล้วต้องล็อกอินใหม่ | ปกติ: หน้าจัดการเก็บ session ในคุกกี้ `HttpOnly` แทน localStorage (สคริปต์ในหน้าอ่านไม่ได้) ล็อกอินใหม่ครั้งเดียว — สคริปต์และ CLI ยังใช้ `Authorization: Bearer` ได้เหมือนเดิม |
| ลืมรหัสผ่านและอีเมลยังไม่ได้ตั้ง | ให้ผู้ดูแลคนอื่นตั้งรหัสผ่านใหม่ให้ที่ **ผู้ใช้งาน** |
| เข้าสู่ระบบแล้วขึ้นว่าบัญชีถูกระงับ | ผู้ดูแลระงับบัญชีไว้ — ให้ผู้ดูแลกด **เปิดใช้งาน** ที่หน้าผู้ใช้งาน ทุกครั้งที่พยายามเข้าสู่ระบบจะอยู่ใน **บันทึกกิจกรรม** |

## อีเมล

| อาการ | สาเหตุ / วิธีแก้ |
| --- | --- |
| ส่งอีเมลทดสอบไม่สำเร็จ | ตรวจเซิร์ฟเวอร์ พอร์ต การเข้ารหัส; Gmail ต้องใช้ &#34;รหัสผ่านสำหรับแอป&#34;; บาง VPS บล็อกพอร์ต 25/465/587 ขาออก |
| ลิงก์ในอีเมลตั้งรหัสผ่านพาไปที่อยู่ผิด (เช่น `localhost`) | ตั้ง `SITE_URL=https://โดเมนของคุณ` ใน `.env` |
| ผู้ใช้ไม่เห็นอีเมล | ให้ดูโฟลเดอร์จดหมายขยะ; ลิงก์ลืมรหัสผ่านใช้ได้ 2 ชั่วโมง ลิงก์ต้อนรับ 3 วัน |

## หลัง reverse proxy

| อาการ | สาเหตุ / วิธีแก้ |
| --- | --- |
| สถิติทุกคนมาจาก IP เดียว / ถูกจำกัดการล็อกอินทั้งเว็บ | ตั้ง `TRUST_PROXY=true` (เฉพาะเมื่อพอร์ต 8090 ไม่เปิดตรงสู่อินเทอร์เน็ต) อยู่หลัง Cloudflare ดู [อยู่หลัง Cloudflare](/docs/studio/env-variables) |
| สคริปต์เรียก 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`) — ปรับให้ใหญ่กว่า &#34;ขนาดไฟล์สูงสุด&#34; ใน ตั้งค่าเว็บไซต์ → ไฟล์และสื่อ |

## ปลั๊กอิน

| อาการ | สาเหตุ / วิธีแก้ |
| --- | --- |
| หน้าร้านปลั๊กอินขึ้นว่าเชื่อมต่อ Store ไม่ได้ | เซิร์ฟเวอร์ออกอินเทอร์เน็ตไม่ได้ — ยังติดตั้งจากไฟล์ `.zip` ที่แท็บ **อัปโหลด .zip** ได้ |
| ติดตั้งไม่ได้ ขึ้นว่าลายเซ็นของแพ็กเกจไม่ถูกต้อง / ไม่มีลายเซ็น | แพ็กเกจถูกแก้ระหว่างทาง หรือไม่ได้มาจากร้านที่เว็บเชื่อถือ (CMS 2.4.0) ลองใหม่อีกครั้ง ถ้าใช้ Store ของตัวเอง ตรวจ `STORE_URL` / `STORE_PUBLIC_KEY` ([ติดตั้ง อัปเดต และลบปลั๊กอิน](/docs/store/install-plugins)) |
| ปลั๊กอินปิดเองหลังอัปเดต | เวอร์ชันใหม่ขอสิทธิ์เพิ่ม — กด **อนุมัติและเปิดใช้** ([สิทธิ์ที่ปลั๊กอินขอ](/docs/store/plugin-permissions)) |
| เปิดใช้ไม่สำเร็จ / ต้องใช้ปลั๊กอินอื่นก่อน | ติดตั้งและเปิดปลั๊กอินที่ต้องใช้ก่อน (หน้าต่างจะเสนอ **ติดตั้งทั้งหมด**) |
| แถบ &#34;มีปลั๊กอิน N ตัวรอย้าย…&#34; ไม่หาย | ดู [อัปเดตเวอร์ชันและย้ายจากปลั๊กอินในตัว](/docs/studio/upgrade) |
| บล็อกปลั๊กอินในหน้าเว็บหายไป | ปลั๊กอินถูกปิดหรือลบ — เปิดปลั๊กอินอีกครั้ง บล็อกจะกลับมา |

## โค้ดของเว็บไซต์ (Site Code)

| อาการ | สาเหตุ / วิธีแก้ |
| --- | --- |
| โค้ดที่เผยแพร่ทำให้เว็บพัง | เปิด **Safe mode** ที่หน้าโค้ดของเว็บไซต์; ถ้าเข้าหน้าจัดการไม่ได้ ให้เพิ่ม `SITE_CODE_DISABLED: &#34;true&#34;` ใต้ `environment:` ของ service `studio` ใน `docker-compose.yml` แล้ว `docker compose up -d` |
| หน้าฐานข้อมูลขึ้น &#34;โหมดสำรอง&#34; และใช้ SQL console ไม่ได้ | ยังไม่ได้ตั้งฐานข้อมูลแยก — ดู [ฐานข้อมูลของ Site Code](/docs/developers/database) |
| ค่าลับที่บันทึกไว้อ่านไม่ได้หลังย้ายเครื่อง | ไฟล์ `site-code.key` (หรือ `SITE_CODE_SECRET_KEY`) ไม่ได้ย้ายมาด้วย — ใช้กุญแจเดิม หรือกรอกค่าลับใหม่ |

ปัญหาอื่นของนักพัฒนา ดู [Site Code](/docs/developers/site-code) และ [anasaki-code CLI](/docs/developers/cli)
