เริ่มต้น
ตัวแปรใน .env และการตั้งค่า Docker
ตัวแปรทุกตัวในไฟล์ .env, การวาง reverse proxy ทำ HTTPS, การเปิดหลายเว็บบนเครื่องเดียว และเว็บทดลอง (demo)
ในหน้านี้
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 | เปลี่ยนการติดตั้งนี้เป็นเว็บทดลอง (ดูด้านล่าง) |
อย่าเปิด TRUST_PROXY=true ถ้าพอร์ต 8090 เปิดตรงสู่อินเทอร์เน็ต เพราะใครก็ปลอม header IP ได้
อยู่หลัง Cloudflare#
- IP จริงของผู้ใช้: ถ้า Cloudflare ต่อตรงมาที่ Anasaki Studio (ไม่มี Caddy/Nginx คั่น) ตั้ง
TRUST_PROXY=trueและใส่ช่วง IP ของ Cloudflare (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 ของหน้าออกแบบ
ข้อมูลเก็บที่ไหน#
ข้อมูลทั้งหมดอยู่ใน Docker volume 3 ตัว (ชื่อขึ้นต้นด้วย COMPOSE_PROJECT_NAME):
| volume | เก็บอะไร |
|---|---|
mysql-data | ฐานข้อมูล MySQL 8.4 (ทั้ง anasaki และ anasaki_code) |
uploads | ไฟล์ที่อัปโหลดในคลังรูปภาพ |
plugins | ไฟล์ปลั๊กอินที่ติดตั้ง และ site-code.key |
สำรองได้จาก volume โดยตรง หรือใช้ ส่งออก / นำเข้าเว็บ ในหน้าจัดการ
ใช้งานจริงหลัง reverse proxy (HTTPS)#
วาง reverse proxy ที่ทำ HTTPS ไว้หน้าพอร์ต 8090 แล้วตั้ง SITE_URL กับ TRUST_PROXY ตัวอย่างด้วย Caddy (ออกใบรับรอง HTTPS ให้เอง):
example.com {
reverse_proxy localhost:8090
}
SITE_URL=https://example.com
TRUST_PROXY=true
เปิดหลายเว็บบนเครื่องเดียว#
แยกโฟลเดอร์ละเว็บ และใน .env ของแต่ละโฟลเดอร์ต้องตั้ง COMPOSE_PROJECT_NAME และ PORT ไม่ซ้ำกัน เช่นเว็บ demo:
# demo/.env
COMPOSE_PROJECT_NAME=anasaki-demo
PORT=8091
ถ้าชื่อซ้ำกัน docker compose up ในโฟลเดอร์ที่สองจะไปแทนที่ container ของเว็บแรกและใช้ฐานข้อมูลเดียวกัน และ อย่าเปลี่ยน COMPOSE_PROJECT_NAME ของเว็บที่ใช้งานอยู่ เพราะข้อมูลอยู่ใน volume ที่ตั้งชื่อตามค่านี้
เว็บทดลอง (demo) ให้คนทั่วไปลองเล่น#
ตั้งใน .env ของเว็บทดลอง:
DEMO_MODE=true
[email protected]
DEMO_PASSWORD=demo1234
DEMO_RESET_MINUTES=60
- หน้าเข้าสู่ระบบแสดงบัญชีทดลองพร้อมปุ่ม เข้าสู่ระบบด้วยบัญชีทดลอง — ทุกคนใช้บัญชีเดียวกัน
- ผู้ทดลองแก้เนื้อหา หน้าเว็บ ดีไซน์ เมนู หมวดหมู่ ธีม และอัปโหลดรูปเล็ก ๆ ได้ แต่จัดการผู้ใช้ การตั้งค่าระบบ ปลั๊กอิน โค้ด HTML ดิบ และอีเมล/รหัสผ่านของบัญชีไม่ได้ และ Site Code จะไม่ทำงาน
- ทุก
DEMO_RESET_MINUTESนาที ทุกอย่างกลับเป็นค่าเริ่มต้น (สถานะตอนเปิดโหมดครั้งแรก) ผู้ดูแลกด บันทึกสถานะนี้เป็นค่าเริ่มต้น หรือ รีเซ็ตตอนนี้ ได้จากแถบด้านบนของหน้าจัดการ
ใช้บัญชีผู้ดูแลของคุณเองแยกต่างหาก และอย่าเปิดโหมดนี้กับเว็บจริง
