fix(docker): แยก compose เป็น base (Dokploy) + override (ในเครื่อง) — แก้ port already allocated

Dokploy รัน `docker compose -f ./docker-compose.yml up -d --build` บน server
แล้วล้มที่ "Bind for 0.0.0.0:8095 failed: port is already allocated"

- docker-compose.yml: ถอด `ports:` ออก ใช้ `expose: ${PORT}` แทน (reverse proxy ต่อผ่าน compose network)
  · ถอด `container_name` (ชนกันเมื่อมีหลาย deployment บนเครื่องเดียว)
  · เปลี่ยน bind mount ./data → named volume `data` (Docker คัดลอก ownership uid 1000 จาก image
    ทำให้ user `node` เขียน content/uploads/pglite ได้; bind mount บน Linux เป็น root:root = เขียนไม่ได้)
- docker-compose.override.yml (ใหม่): `ports: ${HOST_PORT}:${PORT}` + bind ./data — เฉพาะรันในเครื่อง
  (Dokploy ระบุ `-f ./docker-compose.yml` ตรง ๆ จึงไม่โหลด override)
- README: อธิบาย compose 2 ชั้น, เหตุผลที่ห้าม publish พอร์ต/ใส่ container_name, และเตือนว่า data/ ไม่อยู่ใน git
This commit is contained in:
Bkk1234 committed 2026-11-21 22:10:40 +07:00
1 parent b99e0940f7
commit 05487728a7
3 files changed
+37 -12

No files matched your search

+16 -6
View File
@@ -98,7 +98,7 @@ AGENTS.md กฎสำหรับ agent/AI ที่แก้โค้
```bash ```bash
cp .env.example .env # ครั้งแรกเท่านั้น cp .env.example .env # ครั้งแรกเท่านั้น
docker compose up -d --build docker compose up -d --build # base + override (ในเครื่อง)
# → http://localhost:8095 (แก้พอร์ตด้วย HOST_PORT) # → http://localhost:8095 (แก้พอร์ตด้วย HOST_PORT)
docker compose logs -f # ดู log docker compose logs -f # ดู log
docker compose down # หยุด docker compose down # หยุด
@@ -106,15 +106,25 @@ docker compose down # หยุด
| env | ค่าตั้งต้น | หน้าที่ | | env | ค่าตั้งต้น | หน้าที่ |
| ------------ | --------- | -------------------------------------------------- | | ------------ | --------- | -------------------------------------------------- |
| `HOST_PORT` | `8095` | พอร์ตที่แมปออกเครื่อง host | | `HOST_PORT` | `8095` | พอร์ตที่แมปออกเครื่อง host (มีเฉพาะ override) |
| `PORT` | `8080` | พอร์ตที่ Nitro ฟังในคอนเทนเนอร์ (`process.env.PORT`) | | `PORT` | `8080` | พอร์ตที่ Nitro ฟังในคอนเทนเนอร์ (`process.env.PORT`) |
| `TZ` | — | โซนเวลาในคอนเทนเนอร์ (ส่งผ่าน `env_file: .env`) | | `TZ` | `Asia/Bangkok` | โซนเวลาในคอนเทนเนอร์ |
ทั้งสองตัวอยู่ใน `.env` หรือสั่งตรงหน้า command ก็ได้: `PORT=9001 HOST_PORT=9001 docker compose up -d` ทั้งสองตัวอยู่ใน `.env` หรือสั่งตรงหน้า command ก็ได้: `PORT=9001 HOST_PORT=9001 docker compose up -d`
- **ไฟล์**: `Dockerfile` (3 stage: deps → build → runtime, `node:22-bookworm-slim`, รันด้วย user `node`) · `docker-compose.yml` · `.dockerignore` ### ไฟล์ compose แยก 2 ชั้น
- **ข้อมูลไม่หาย**: `./data` ถูก mount เป็น volume → `content/content.json`, `uploads/`, `analytics/`, `pglite/` ยังอยู่หลัง `docker compose down` (ลบ volume = `docker compose down -v` เท่านั้นถึงจะหาย)
- **แก้เนื้อหาด้วยหลังบ้านแล้วไม่ต้อง rebuild** — `data/` เป็น mount ไม่ได้อบใน image · แต่ถ้าแก้ **โค้ด** ต้อง `docker compose up -d --build` | ไฟล์ | ใครใช้ | มีอะไร |
| --------------------------- | ----------------------------------------- | ---------------------------------------------------------------------- |
| `docker-compose.yml` | **server / Dokploy** (`-f ./docker-compose.yml`) | `expose: PORT` อย่างเดียว ไม่ publish พอร์ต · named volume `data` · ไม่มี `container_name` |
| `docker-compose.override.yml` | **ในเครื่อง** (compose โหลดเองอัตโนมัติ) | `ports: HOST_PORT:PORT` + bind `./data` ให้เห็นไฟล์จริง |
- **ทำไมไม่ publish พอร์ตในไฟล์ base** — server มักมีพอร์ตนั้นถูกยึดอยู่แล้ว (`Bind for 0.0.0.0:8095 failed: port is already allocated`) และ Dokploy/Traefik ต่อเข้าพอร์ตในคอนเทนเนอร์ผ่าน network ของ compose อยู่แล้ว จึงใช้ `expose` พอ
- **ห้ามใส่ `container_name`** — ชื่อจะชนกันเมื่อมีหลาย deployment บนเครื่องเดียว (Dokploy ใช้ `-p <project>` อยู่แล้ว)
- **named volume บน server** — Docker คัดลอก ownership (uid 1000 = `node`) จาก image ให้ ทำให้แอปเขียน `content/`, `uploads/`, `pglite/` ได้ · bind mount `./data` บน Linux จะเป็น `root:root` แล้วเขียนไม่ได้
- **ข้อมูลไม่หาย**: ลบ volume = `docker compose down -v` เท่านั้นถึงจะหาย
- **แก้เนื้อหาด้วยหลังบ้านแล้วไม่ต้อง rebuild** — `data/` เป็น volume ไม่ได้อบใน image · แต่ถ้าแก้ **โค้ด** ต้อง `docker compose up -d --build`
- **ข้อมูลตั้งต้นบน server**: `data/` ไม่อยู่ใน git → volume เริ่มว่าง แอปจะ `seedContent()` จาก `app/lib/content-seed.ts` (เนื้อหาตัวอย่าง) ไม่ใช่ `content.json` ที่แก้ในเครื่อง — ต้องคัดลอก `data/content/content.json` ขึ้นไป หรือใส่ใหม่ผ่านหลังบ้านก่อนเปิดใช้งานจริง
- ถ้าพอร์ต 8080 บน host ถูกยึดอยู่แล้ว ให้ตั้ง `HOST_PORT` อื่น (ค่าตั้งต้น 8095) - ถ้าพอร์ต 8080 บน host ถูกยึดอยู่แล้ว ให้ตั้ง `HOST_PORT` อื่น (ค่าตั้งต้น 8095)
- log ที่ขึ้น `DEPLOY_SETTINGS_REQUIRED` / `[automations] queued-run sweep failed` มาจากตัวจับเวลา automation/trigger ของ agent-native ที่ต้องใช้ hosted Postgres — ไม่กระทบหน้าเว็บ (ตั้ง `DATABASE_URL` ถ้าจะใช้จริง) - log ที่ขึ้น `DEPLOY_SETTINGS_REQUIRED` / `[automations] queued-run sweep failed` มาจากตัวจับเวลา automation/trigger ของ agent-native ที่ต้องใช้ hosted Postgres — ไม่กระทบหน้าเว็บ (ตั้ง `DATABASE_URL` ถ้าจะใช้จริง)
+10
View File
@@ -0,0 +1,10 @@
# รันในเครื่อง (dev/preview) — compose โหลดไฟล์นี้อัตโนมัติเมื่อเรียก `docker compose up` เฉย ๆ
# Dokploy เรียก `-f ./docker-compose.yml` ตรง ๆ → ไม่โหลดไฟล์นี้ (จึงไม่ชนพอร์ตบน server)
services:
web:
ports:
# HOST_PORT = พอร์ตที่แมปออกเครื่อง host (8095 เพราะ 8080 มักถูกยึด)
- "${HOST_PORT:-8095}:${PORT:-8080}"
volumes:
# ในเครื่องเห็นไฟล์จริงที่ ./data (ใช้งาน/สำรองง่าย); บน server ใช้ named volume
- ./data:/app/data
+11 -6
View File
@@ -4,7 +4,7 @@ services:
context: . context: .
dockerfile: Dockerfile dockerfile: Dockerfile
image: alterflixhub-web:latest image: alterflixhub-web:latest
container_name: alterflixhub-web # ห้ามใส่ container_name: ชื่อต้องไม่ตายตัว ไม่งั้น Dokploy / หลายอินสแตนซ์บนเครื่องเดียวชนกัน
env_file: env_file:
- path: .env - path: .env
required: false required: false
@@ -15,12 +15,14 @@ services:
NODE_ENV: production NODE_ENV: production
TZ: ${TZ:-Asia/Bangkok} TZ: ${TZ:-Asia/Bangkok}
# SITE_URL / SHARE_ORIGIN ตั้งใน .env เมื่อต้องบังคับโดเมน # SITE_URL / SHARE_ORIGIN ตั้งใน .env เมื่อต้องบังคับโดเมน
ports: # ไม่ publish พอร์ตออก host: reverse proxy (Dokploy/Traefik) ต่อเข้าพอร์ตนี้ผ่าน network ของ compose
# HOST_PORT = พอร์ตที่แมปออกเครื่อง host (แยกจาก PORT เพื่อหลบพอร์ตที่ถูกยึด) # ต้องเปิดพอร์ตออก host (รันในเครื่อง) → docker-compose.override.yml จัดการให้อัตโนมัติ
- "${HOST_PORT:-8095}:${PORT:-8080}" expose:
- "${PORT:-8080}"
volumes: volumes:
# เนื้อหาที่แก้ผ่านหลังบ้าน + รูปอัปโหลด + สถิติ + pglite # named volume: Docker คัดลอก ownership (uid 1000 = user node) จาก image ให้ → เขียนไฟล์ได้
- ./data:/app/data # (bind mount ./data บน Linux จะเป็น root:root ทำให้แอปเขียน content/uploads ไม่ได้)
- data:/app/data
restart: unless-stopped restart: unless-stopped
healthcheck: healthcheck:
test: test:
@@ -31,3 +33,6 @@ services:
start_period: 20s start_period: 20s
retries: 3 retries: 3
volumes:
data: