From 05487728a7034f6801252ae71002ef96c9a20712 Mon Sep 17 00:00:00 2001 From: Bkk1234 Date: Sat, 21 Nov 2026 22:10:40 +0700 Subject: [PATCH] =?UTF-8?q?fix(docker):=20=E0=B9=81=E0=B8=A2=E0=B8=81=20co?= =?UTF-8?q?mpose=20=E0=B9=80=E0=B8=9B=E0=B9=87=E0=B8=99=20base=20(Dokploy)?= =?UTF-8?q?=20+=20override=20(=E0=B9=83=E0=B8=99=E0=B9=80=E0=B8=84?= =?UTF-8?q?=E0=B8=A3=E0=B8=B7=E0=B9=88=E0=B8=AD=E0=B8=87)=20=E2=80=94=20?= =?UTF-8?q?=E0=B9=81=E0=B8=81=E0=B9=89=20port=20already=20allocated?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- README.md | 22 ++++++++++++++++------ docker-compose.override.yml | 10 ++++++++++ docker-compose.yml | 17 +++++++++++------ 3 files changed, 37 insertions(+), 12 deletions(-) create mode 100644 docker-compose.override.yml diff --git a/README.md b/README.md index 67879f5..d52a9af 100644 --- a/README.md +++ b/README.md @@ -98,7 +98,7 @@ AGENTS.md กฎสำหรับ agent/AI ที่แก้โค้ ```bash cp .env.example .env # ครั้งแรกเท่านั้น -docker compose up -d --build +docker compose up -d --build # base + override (ในเครื่อง) # → http://localhost:8095 (แก้พอร์ตด้วย HOST_PORT) docker compose logs -f # ดู log docker compose down # หยุด @@ -106,15 +106,25 @@ docker compose down # หยุด | env | ค่าตั้งต้น | หน้าที่ | | ------------ | --------- | -------------------------------------------------- | -| `HOST_PORT` | `8095` | พอร์ตที่แมปออกเครื่อง host | +| `HOST_PORT` | `8095` | พอร์ตที่แมปออกเครื่อง host (มีเฉพาะ override) | | `PORT` | `8080` | พอร์ตที่ Nitro ฟังในคอนเทนเนอร์ (`process.env.PORT`) | -| `TZ` | — | โซนเวลาในคอนเทนเนอร์ (ส่งผ่าน `env_file: .env`) | +| `TZ` | `Asia/Bangkok` | โซนเวลาในคอนเทนเนอร์ | ทั้งสองตัวอยู่ใน `.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` -- **ข้อมูลไม่หาย**: `./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` +### ไฟล์ compose แยก 2 ชั้น + +| ไฟล์ | ใครใช้ | มีอะไร | +| --------------------------- | ----------------------------------------- | ---------------------------------------------------------------------- | +| `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 ` อยู่แล้ว) +- **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) - log ที่ขึ้น `DEPLOY_SETTINGS_REQUIRED` / `[automations] queued-run sweep failed` มาจากตัวจับเวลา automation/trigger ของ agent-native ที่ต้องใช้ hosted Postgres — ไม่กระทบหน้าเว็บ (ตั้ง `DATABASE_URL` ถ้าจะใช้จริง) diff --git a/docker-compose.override.yml b/docker-compose.override.yml new file mode 100644 index 0000000..2429faa --- /dev/null +++ b/docker-compose.override.yml @@ -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 diff --git a/docker-compose.yml b/docker-compose.yml index 5532f3e..9327b52 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -4,7 +4,7 @@ services: context: . dockerfile: Dockerfile image: alterflixhub-web:latest - container_name: alterflixhub-web + # ห้ามใส่ container_name: ชื่อต้องไม่ตายตัว ไม่งั้น Dokploy / หลายอินสแตนซ์บนเครื่องเดียวชนกัน env_file: - path: .env required: false @@ -15,12 +15,14 @@ services: NODE_ENV: production TZ: ${TZ:-Asia/Bangkok} # SITE_URL / SHARE_ORIGIN ตั้งใน .env เมื่อต้องบังคับโดเมน - ports: - # HOST_PORT = พอร์ตที่แมปออกเครื่อง host (แยกจาก PORT เพื่อหลบพอร์ตที่ถูกยึด) - - "${HOST_PORT:-8095}:${PORT:-8080}" + # ไม่ publish พอร์ตออก host: reverse proxy (Dokploy/Traefik) ต่อเข้าพอร์ตนี้ผ่าน network ของ compose + # ต้องเปิดพอร์ตออก host (รันในเครื่อง) → docker-compose.override.yml จัดการให้อัตโนมัติ + expose: + - "${PORT:-8080}" volumes: - # เนื้อหาที่แก้ผ่านหลังบ้าน + รูปอัปโหลด + สถิติ + pglite - - ./data:/app/data + # named volume: Docker คัดลอก ownership (uid 1000 = user node) จาก image ให้ → เขียนไฟล์ได้ + # (bind mount ./data บน Linux จะเป็น root:root ทำให้แอปเขียน content/uploads ไม่ได้) + - data:/app/data restart: unless-stopped healthcheck: test: @@ -31,3 +33,6 @@ services: start_period: 20s retries: 3 +volumes: + data: +