# เริ่มต้นใช้งาน Anasaki Studio

> ติดตั้ง Anasaki Studio บนเซิร์ฟเวอร์ของคุณด้วย Docker ภายในไม่กี่นาที ผ่านหน้าตั้งค่าเริ่มต้น แล้วเริ่มสร้างเว็บได้ทันที

ที่มา: https://anasaki.live/docs/studio/getting-started

Anasaki Studio คือระบบสร้างและจัดการเว็บไซต์แบบโอเพนซอร์ส (MIT) — จัดการเนื้อหา ออกแบบหน้าเว็บได้อิสระแบบ Figma และเพิ่มความสามารถด้วยปลั๊กอินจาก Plugin Store ติดตั้งบนเซิร์ฟเวอร์ของคุณเองด้วย Docker โดยไม่ต้องดาวน์โหลดซอร์สโค้ด

> [!NOTE]
> **อยากลองก่อนติดตั้ง?** เข้า [เว็บ demo](https://democms.anasaki.live/admin/) ด้วยอีเมล `demo@example.com` รหัสผ่าน `demo1234` — ลองออกแบบหน้า เขียนบทความ และติดตั้งปลั๊กอินได้ทุกอย่าง เว็บรีเซ็ตกลับเป็นค่าเริ่มต้นทุก 60 นาที

## สิ่งที่ต้องมี

- เซิร์ฟเวอร์หรือเครื่องที่ลง **Docker** และ **Docker Compose** ได้ (แนะนำ RAM อย่างน้อย 1 GB)
- image สำเร็จรูป `chichat/anasaki-studio` รองรับทั้ง `linux/amd64` และ `linux/arm64` — ใช้ได้กับ VPS ทั่วไป, Raspberry Pi 4/5 และ Mac M-series
- ถ้าจะเปิดใช้งานจริงบนอินเทอร์เน็ต: โดเมน และ reverse proxy ที่ทำ HTTPS (เช่น Caddy, Nginx, Cloudflare)

## ติดตั้ง

1. สร้างโฟลเดอร์ แล้วดาวน์โหลด 3 ไฟล์ที่ต้องใช้ ได้แก่ `docker-compose.yml`, `.env.example` (บันทึกเป็น `.env`) และสคริปต์ `docker/mysql-init/10-site-code.sh`
    0 
2. เปิด `.env` แล้วใส่ค่าที่ **ต้องตั้ง** ทั้ง 4 ตัว (สุ่มค่าได้ด้วย `openssl rand -hex 32` หรือ `openssl rand -hex 16`)
    1 
3. สั่งเริ่มระบบ
    2 
4. เปิด `http://ที่อยู่เซิร์ฟเวอร์:8090/admin/` ระบบจะพาเข้า **หน้าตั้งค่าเริ่มต้น** ส่วนเว็บไซต์จริงอยู่ที่ `http://ที่อยู่เซิร์ฟเวอร์:8090/`

> [!WARNING]
> `docker compose up` จะไม่ยอมเริ่มถ้า `JWT_SECRET`, `MYSQL_PASSWORD`, `MYSQL_ROOT_PASSWORD` หรือ `CODE_DB_PASSWORD` ยังว่าง (ระบบไม่มีรหัสผ่านตั้งต้นให้) และควรใช้ **ตัวอักษรกับตัวเลขเท่านั้น** เพราะรหัสผ่านฐานข้อมูลเป็นส่วนหนึ่งของ connection string

> [!NOTE]
> เก็บโฟลเดอร์ `docker/mysql-init/` ไว้ข้าง `docker-compose.yml` เสมอ — ตอนเริ่มครั้งแรก สคริปต์ในโฟลเดอร์นี้จะสร้างฐานข้อมูล `anasaki_code` และผู้ใช้ MySQL แยกสำหรับ Site Code (ซึ่งแตะตารางของ CMS ไม่ได้) ดูเพิ่มที่ [ฐานข้อมูลของ Site Code](/docs/developers/database)

## หน้าตั้งค่าเริ่มต้น

ใช้เวลาไม่ถึง 1 นาที มี 4 ขั้นตอน แล้วตามด้วยปลั๊กอินแนะนำ:

1. **ภาษา** — เลือกภาษาของหน้าจัดการ (ไทย / English) เปลี่ยนภายหลังได้ และผู้ใช้แต่ละคนเลือกเองได้
2. **ข้อมูลเว็บ** — ชื่อเว็บและคำโปรย ติ๊ก **ใส่เนื้อหาตัวอย่าง (หน้าแรก บทความ เมนู)** ถ้าอยากเริ่มจากเว็บตัวอย่าง (แนะนำสำหรับมือใหม่ ลบทิ้งได้ภายหลัง) ถ้าไม่ติ๊กจะได้หน้าแรกว่าง ๆ
3. **บัญชีผู้ดูแล** — ชื่อ อีเมล และรหัสผ่าน (อย่างน้อย 8 ตัวอักษร) บัญชีนี้ทำได้ทุกอย่าง
4. **ตรวจสอบ** — ดูข้อมูลอีกครั้ง แล้วกด **ติดตั้งและเริ่มใช้งาน**
5. **ปลั๊กอินแนะนำ** — รายการปลั๊กอินทางการที่ Plugin Store แนะนำ (เช่น SEO แบบฟอร์ม สถิติ) พร้อมสิทธิ์ที่แต่ละตัวขอ ติ๊กเลือกแล้วกด **ติดตั้งที่เลือก** หรือกด **ข้าม** ก็ได้ — ติดตั้งเพิ่มหรือถอนภายหลังได้ที่หน้า **ปลั๊กอิน**

> [!NOTE]
> ถ้าเซิร์ฟเวอร์เชื่อมต่อ Plugin Store ไม่ได้ หรือ Store ยังไม่มีปลั๊กอินแนะนำ หน้าตั้งค่าก็ยังจบได้ตามปกติ ดูรายละเอียดปลั๊กอินแต่ละตัวที่ [ปลั๊กอินทางการ](/docs/store/official-plugins)

ถ้าต้องการติดตั้งแบบอัตโนมัติ (ไม่ผ่านหน้าตั้งค่า) ให้ตั้ง `ADMIN_EMAIL` และ `ADMIN_PASSWORD` ใน `.env` ทั้งคู่ ระบบจะสร้างผู้ดูแลพร้อมเนื้อหาตัวอย่างให้เมื่อฐานข้อมูลยังไม่มีผู้ใช้

### เลือกแบบเว็บ (2.5)

ในหน้าตั้งค่าเริ่มต้นเลือก **แบบเว็บ** ตามธุรกิจ — ร้านกาแฟ ร้านค้าออนไลน์ บริการ/คลินิก บล็อกข่าว บริษัท คอร์สเรียน ผลงาน หรือองค์กร/มูลนิธิ ระบบสร้างหน้าแรก เมนู ประเภทเนื้อหา และตัวอย่างข้อมูลที่เข้ากับธุรกิจ (แก้ได้ทั้งหมด) และติ๊กปลั๊กอินที่ต้องใช้ไว้ให้ในขั้นถัดไป

## สิ่งที่ควรทำต่อ

- **ตั้งค่าเว็บไซต์ → ทั่วไป** — ชื่อเว็บ คำโปรย โลโก้ ไอคอน และเขตเวลา ([ตั้งค่าเว็บไซต์](/docs/studio/site-settings))
- **หน้าเว็บ → ออกแบบ** — ปรับหน้าแรกให้เป็นแบบของคุณ ([ออกแบบหน้าเว็บ](/docs/studio/designer))
- **บทความ / ข่าว → เขียนบทความใหม่** — ระบบนำไปแสดงในหน้าแรกและหน้าบล็อกให้เอง ([เขียนบทความ หมวดหมู่ และเมนู](/docs/studio/content))
- **ตั้งค่าเว็บไซต์ → ความปลอดภัย** — เปลี่ยนที่อยู่หน้าจัดการจาก `/admin` เป็นคำที่เดายาก
- **ตั้งค่าเว็บไซต์ → อีเมล** — ใส่ SMTP เพื่อใช้ลืมรหัสผ่าน อีเมลต้อนรับ และการแจ้งเตือนจากปลั๊กอิน
- ตั้ง `SITE_URL` (และ `TRUST_PROXY=true` ถ้ามี reverse proxy) ก่อนเปิดใช้จริง — ดู [ตัวแปรใน .env และการตั้งค่า Docker](/docs/studio/env-variables)

## อัปเดตเวอร์ชัน

```sh
docker compose pull && docker compose up -d
```

ข้อมูลทั้งหมด (ฐานข้อมูล ไฟล์ที่อัปโหลด และปลั๊กอิน) อยู่ใน Docker volume จึงไม่หายตอนอัปเดต ดูขั้นตอนเต็มและข้อควรระวังที่ [อัปเดตเวอร์ชัน](/docs/studio/upgrade)
