# ตัวแปรใน .env และการตั้งค่า Docker

> ตัวแปรทุกตัวในไฟล์ .env, การวาง reverse proxy ทำ HTTPS, การเปิดหลายเว็บบนเครื่องเดียว และเว็บทดลอง (demo)

ที่มา: https://anasaki.live/docs/studio/env-variables

`docker-compose.yml` อ่านค่าจากไฟล์ `.env` ในโฟลเดอร์เดียวกันโดยอัตโนมัติ อย่า commit ไฟล์ `.env` ขึ้น git เพราะมีรหัสผ่าน

## ตัวแปรที่ต้องตั้ง

| ตัวแปร | หน้าที่ |
| --- | --- |
| `JWT_SECRET` | กุญแจเซ็น session ของหน้าจัดการ — เปลี่ยนภายหลัง = ทุกคนต้องเข้าสู่ระบบใหม่ |
| `MYSQL_PASSWORD` | รหัสผ่านของผู้ใช้ฐานข้อมูล `anasaki` — ตั้งก่อนเริ่มครั้งแรก เปลี่ยนภายหลังไม่มีผลกับฐานข้อมูลเดิม |
| `MYSQL_ROOT_PASSWORD` | รหัสผ่าน root ของ MySQL (ใช้ภายใน container และอ่านเฉพาะตอนเริ่มครั้งแรก) |
| `CODE_DB_PASSWORD` | รหัสผ่านของผู้ใช้ MySQL `anasaki_code` — ฐานข้อมูลของ Site Code ที่แตะตารางของ CMS ไม่ได้ สร้างโดย `docker/mysql-init/10-site-code.sh` ตอนเริ่มครั้งแรก |

## ตัวแปรที่ไม่บังคับ

| ตัวแปร | ค่าเริ่มต้น | หน้าที่ |
| --- | --- | --- |
| `SITE_URL` | (ว่าง) | ที่อยู่จริงของเว็บ เช่น `https://example.com` (ไม่มี `/` ท้าย) ใช้สร้างลิงก์ในอีเมลตั้งรหัสผ่านใหม่และอีเมลต้อนรับ — **ควรตั้งทุกเว็บที่ใช้จริง** ถ้าไม่ตั้ง ลิงก์จะอิงจาก Host header ซึ่งปลอมได้ |
| `TRUST_PROXY` | `false` | ตั้ง `true` เมื่อมี reverse proxy อยู่หน้าพอร์ต 8090 เพื่อให้ระบบจำกัดการล็อกอินและสถิติเห็น IP จริงจาก `X-Real-IP` / `X-Forwarded-For` |
| `TRUSTED_PROXIES` | (ว่าง = loopback + เครือข่ายภายใน) | IP / CIDR ของ proxy ที่เชื่อ header ได้ คั่นด้วย `,` — หลัง Cloudflare ที่ต่อตรงให้ใส่ช่วง IP ของ Cloudflare |
| `STORE_URL`, `STORE_PUBLIC_KEY` | (ว่าง = Plugin Store ทางการ) | ใช้ Plugin Store ของตัวเอง และกุญแจสาธารณะ (base64) ที่ร้านนั้นใช้เซ็นแพ็กเกจ — ไม่ใส่ `STORE_PUBLIC_KEY` ระบบจะจำกุญแจที่ร้านแสดงครั้งแรก (CMS 2.4.0) |
| `PORT` | `8090` | พอร์ตบนเครื่องที่เปิดให้เว็บและหน้าจัดการ |
| `COMPOSE_PROJECT_NAME` | `anasaki-studio` | ชื่อของการติดตั้งนี้ ใช้ตั้งชื่อ container และ volume ข้อมูล |
| `STUDIO_IMAGE` | `chichat/anasaki-studio:latest` | image ที่ใช้ — ล็อกเวอร์ชันได้ เช่น `chichat/anasaki-studio:2.0.5` (แท็กมีทั้ง `X.Y.Z`, `X.Y`, `X` และ `latest`) |
| `ADMIN_PATH` | (ว่าง) | กู้คืนที่อยู่หน้าจัดการ ถ้าลืม path ที่ตั้งไว้ใน ตั้งค่าเว็บไซต์ → ความปลอดภัย (ใส่เช่น `admin` แล้วรีสตาร์ท) ปกติเว้นว่าง |
| `ADMIN_EMAIL`, `ADMIN_PASSWORD` | (ว่าง) | ตั้งทั้งคู่ = สร้างผู้ดูแลให้อัตโนมัติและข้ามหน้าตั้งค่าเริ่มต้น (เฉพาะตอนฐานข้อมูลยังไม่มีผู้ใช้ และใส่เนื้อหาตัวอย่างให้ด้วย) |
| `SITE_CODE_SECRET_KEY` | (ว่าง) | กุญแจเข้ารหัสค่าลับของ Site Code (AES-256-GCM) ถ้าว่าง ระบบสร้างไฟล์ `site-code.key` ใน volume ปลั๊กอินให้ — **เก็บไว้ให้ดี** ถ้าหาย ค่าลับที่บันทึกไว้จะอ่านไม่ได้ |
| `SITE_CODE_MAIL_SINK` | (ว่าง) | สำหรับนักพัฒนา: `log` = เขียนอีเมลที่ Site Code ส่งลงบันทึกการทำงานแทนการส่งจริง |
| `DEMO_MODE`, `DEMO_EMAIL`, `DEMO_PASSWORD`, `DEMO_RESET_MINUTES` | `false`, …, `60` | เปลี่ยนการติดตั้งนี้เป็นเว็บทดลอง (ดูด้านล่าง) |

> [!WARNING]
> อย่าเปิด `TRUST_PROXY=true` ถ้าพอร์ต 8090 เปิดตรงสู่อินเทอร์เน็ต เพราะใครก็ปลอม header IP ได้

### อยู่หลัง Cloudflare

- **IP จริงของผู้ใช้:** ถ้า Cloudflare ต่อตรงมาที่ Anasaki Studio (ไม่มี Caddy/Nginx คั่น) ตั้ง `TRUST_PROXY=true` และใส่ช่วง IP ของ Cloudflare ([cloudflare.com/ips](https://www.cloudflare.com/ips/)) ใน `TRUSTED_PROXIES` ถ้าไม่ตั้ง ระบบจะเห็นทุกคนเป็น IP ของ Cloudflare ตัวจำกัดการล็อกอินผิด (10 ครั้ง / IP + อีเมล / 15 นาที) จะนับรวมกันทั้งเว็บ ถ้ามี Caddy อยู่หลัง Cloudflare ให้ Caddy ส่ง `X-Real-IP` จาก `CF-Connecting-IP`
- **HSTS:** Anasaki Studio ส่ง `Strict-Transport-Security: max-age=31536000` เองเมื่อ `SITE_URL` เป็น https แต่ถ้าเปิด HSTS ใน Cloudflare (SSL/TLS → Edge Certificates → HTTP Strict Transport Security) ค่าของ Cloudflare จะทับค่านี้ ถ้าตั้ง Max Age เป็น 0 เท่ากับปิด HSTS ทั้งโดเมน ให้ตั้งอย่างน้อย 6 เดือน (เปิด includeSubDomains / preload เฉพาะเมื่อทุก subdomain ใช้ https)
- **สคริปต์เรียก API:** ตั้ง `User-Agent` ของตัวเองทุกครั้ง เพราะ Cloudflare บล็อกค่าเริ่มต้นของบางไลบรารี (`403 error code: 1010`) ดู [API ของหน้าออกแบบ](/docs/developers/designer-api)

## ข้อมูลเก็บที่ไหน

ข้อมูลทั้งหมดอยู่ใน Docker volume 3 ตัว (ชื่อขึ้นต้นด้วย `COMPOSE_PROJECT_NAME`):

| volume | เก็บอะไร |
| --- | --- |
| `mysql-data` | ฐานข้อมูล MySQL 8.4 (ทั้ง `anasaki` และ `anasaki_code`) |
| `uploads` | ไฟล์ที่อัปโหลดในคลังรูปภาพ |
| `plugins` | ไฟล์ปลั๊กอินที่ติดตั้ง และ `site-code.key` |

สำรองได้จาก volume โดยตรง หรือใช้ [ส่งออก / นำเข้าเว็บ](/docs/studio/export-import) ในหน้าจัดการ

## ใช้งานจริงหลัง reverse proxy (HTTPS)

วาง reverse proxy ที่ทำ HTTPS ไว้หน้าพอร์ต 8090 แล้วตั้ง `SITE_URL` กับ `TRUST_PROXY` ตัวอย่างด้วย Caddy (ออกใบรับรอง HTTPS ให้เอง):

```text
example.com {
    reverse_proxy localhost:8090
}
```

```ini
SITE_URL=https://example.com
TRUST_PROXY=true
```

## เปิดหลายเว็บบนเครื่องเดียว

แยกโฟลเดอร์ละเว็บ และใน `.env` ของแต่ละโฟลเดอร์ต้องตั้ง **`COMPOSE_PROJECT_NAME` และ `PORT` ไม่ซ้ำกัน** เช่นเว็บ demo:

```ini
# demo/.env
COMPOSE_PROJECT_NAME=anasaki-demo
PORT=8091
```

> [!WARNING]
> ถ้าชื่อซ้ำกัน `docker compose up` ในโฟลเดอร์ที่สองจะไปแทนที่ container ของเว็บแรกและใช้ฐานข้อมูลเดียวกัน และ **อย่าเปลี่ยน** `COMPOSE_PROJECT_NAME` ของเว็บที่ใช้งานอยู่ เพราะข้อมูลอยู่ใน volume ที่ตั้งชื่อตามค่านี้

## เว็บทดลอง (demo) ให้คนทั่วไปลองเล่น

ตั้งใน `.env` ของเว็บทดลอง:

```ini
DEMO_MODE=true
DEMO_EMAIL=demo@example.com
DEMO_PASSWORD=demo1234
DEMO_RESET_MINUTES=60
```

- หน้าเข้าสู่ระบบแสดงบัญชีทดลองพร้อมปุ่ม **เข้าสู่ระบบด้วยบัญชีทดลอง** — ทุกคนใช้บัญชีเดียวกัน
- ผู้ทดลองแก้เนื้อหา หน้าเว็บ ดีไซน์ เมนู หมวดหมู่ ธีม และอัปโหลดรูปเล็ก ๆ ได้ แต่จัดการผู้ใช้ การตั้งค่าระบบ ปลั๊กอิน โค้ด HTML ดิบ และอีเมล/รหัสผ่านของบัญชีไม่ได้ และ Site Code จะไม่ทำงาน
- ทุก `DEMO_RESET_MINUTES` นาที ทุกอย่างกลับเป็นค่าเริ่มต้น (สถานะตอนเปิดโหมดครั้งแรก) ผู้ดูแลกด **บันทึกสถานะนี้เป็นค่าเริ่มต้น** หรือ **รีเซ็ตตอนนี้** ได้จากแถบด้านบนของหน้าจัดการ

> [!WARNING]
> ใช้บัญชีผู้ดูแลของคุณเองแยกต่างหาก และอย่าเปิดโหมดนี้กับเว็บจริง
