From 830dba58ecff3cc2da0d501eafd68362224c6505 Mon Sep 17 00:00:00 2001 From: Bkk1234 Date: Sat, 21 Nov 2026 16:49:42 +0700 Subject: [PATCH] build: add docker-compose with PORT from env + podman/WSL override --- .dockerignore | 1 + .env.example | 16 ++++++++++++++++ .gitignore | 1 + README.md | 22 ++++++++++++++++++++++ docker-compose.podman.yml | 11 +++++++++++ docker-compose.yml | 25 +++++++++++++++++++++++++ 6 files changed, 76 insertions(+) create mode 100644 .env.example create mode 100644 docker-compose.podman.yml create mode 100644 docker-compose.yml diff --git a/.dockerignore b/.dockerignore index 84e9934..56453ab 100644 --- a/.dockerignore +++ b/.dockerignore @@ -6,6 +6,7 @@ node_modules .env .env.* Dockerfile +docker-compose*.yml .dockerignore README.md AGENTS.md diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..edaeadd --- /dev/null +++ b/.env.example @@ -0,0 +1,16 @@ +# คัดลอกเป็น .env แล้วแก้ค่าตามเครื่อง (ไฟล์ .env ไม่ขึ้น git) + +# พอร์ตที่เปิดทั้งฝั่งโฮสต์และใน container (แอปอ่านตัวเดียวกัน) +PORT=8090 + +# 127.0.0.1 = เฉพาะเครื่องนี้ · 0.0.0.0 = ให้เครื่องอื่น/LAN เข้าได้ +BIND_ADDRESS=127.0.0.1 + +# รหัสเผยแพร่หลังบ้าน — ถ้าเว้นว่างจะอนุญาตเฉพาะ request จาก loopback +ADMIN_TOKEN= + +# 1 = หลังบ้าน commit + push ขึ้น Gitea (ต้องมี .git ใน /app) · 0 = เขียนไฟล์อย่างเดียว +PUBLISH_PUSH=0 + +# ชื่อ container +CONTAINER_NAME=hobbypj-contents diff --git a/.gitignore b/.gitignore index ac8893d..8bdf0c5 100644 --- a/.gitignore +++ b/.gitignore @@ -5,3 +5,4 @@ Thumbs.db *.log .env .env.* +!.env.example diff --git a/README.md b/README.md index dcbaff1..468ecc2 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,25 @@ node server/publish.mjs # → http://localhost:8090 เปิดแบบไฟล์นิ่งก็ได้ (`python -m http.server 8090`) แต่จะ **เผยแพร่จากหน้าเว็บไม่ได้** เพราะไม่มีเซิร์ฟเวอร์มารับการบันทึก — ใช้ปุ่ม “ดาวน์โหลด JSON” แทน +## รันด้วย container + +```bash +cp .env.example .env # ตั้ง PORT / ADMIN_TOKEN / BIND_ADDRESS ตามต้องการ +docker compose up -d --build # → http://localhost:${PORT:-8090} +docker compose logs -f +docker compose down +``` + +- พอร์ตฝั่งโฮสต์และพอร์ตใน container มาจาก `PORT` ตัวเดียว (แอปอ่าน `process.env.PORT`) +- `./data` ถูก mount เป็น `/app/data` — ข้อมูลที่แก้ผ่านหลังบ้านจึงอยู่ที่โฮสต์ ไม่หายเมื่อ recreate container +- image ไม่มี `.git` และตั้ง `PUBLISH_PUSH=0` เป็นค่าเริ่มต้น → หลังบ้านเขียน JSON ได้ แต่ไม่ commit/push + ถ้าต้องการให้ publish ขึ้น Gitea จากใน container ให้ mount โฟลเดอร์ repo (`.git` ด้วย) และตั้ง `PUBLISH_PUSH=1` +- **podman บน Windows/WSL**: bridge network สร้างไม่ได้ (`netavark … firewall backend`) ใช้ override ที่ให้ไปแทน + ```bash + PORT=8090 podman-compose -f docker-compose.yml -f docker-compose.podman.yml up -d + ``` + โหมด `network_mode: host` จะทิ้งพอร์ต mapping และฟังที่ `PORT` บนโฮสต์ตรง ๆ + ## ระบบหลังบ้านทำงานอย่างไร ``` @@ -70,6 +89,9 @@ assets/css/ theme.css (โทเคน/ส่วนประกอ ui/ app.js · router.js · data.js · ui.js · pwa.js · views/ data/projects.json ข้อมูลจริง (แก้ผ่านหลังบ้านเท่านั้น) server/publish.mjs เซิร์ฟเวอร์หลังบ้าน (static + API + git) +Dockerfile image สำหรับรันเซิร์ฟเวอร์ (node:22-alpine + git) +docker-compose.yml compose (PORT จาก env) · docker-compose.podman.yml = override บน WSL +.env.example ตัวอย่างค่าตั้ง: PORT · BIND_ADDRESS · ADMIN_TOKEN · PUBLISH_PUSH fonts/ K2D ฝังในโปรเจค (SIL OFL 1.1) icons/ ไอคอน PWA (สร้างจากสคริปต์ PIL ไม่ใช้ emoji) ``` diff --git a/docker-compose.podman.yml b/docker-compose.podman.yml new file mode 100644 index 0000000..4d6c1e6 --- /dev/null +++ b/docker-compose.podman.yml @@ -0,0 +1,11 @@ +# override สำหรับ podman บน Windows/WSL (เครื่องนี้) +# +# podman-compose -f docker-compose.yml -f docker-compose.podman.yml up -d +# +# ทำไมต้องมี: podman rootless บน WSL สร้าง bridge network ใหม่ไม่ได้ +# netavark: Must provide a valid firewall backend, got iptables +# → ต่อกับ network namespace ของโฮสต์แทน (พอร์ตมาจาก PORT ตรง ๆ ไม่ต้อง publish) +# ใช้กับ Docker Desktop ไม่ต้องใช้ไฟล์นี้ +services: + hobbypj-contents: + network_mode: host diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..630a6e0 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,25 @@ +services: + hobbypj-contents: + build: + context: . + dockerfile: Dockerfile + image: hobbypj-contents:1.0.0 + container_name: ${CONTAINER_NAME:-hobbypj-contents} + restart: unless-stopped + + # พอร์ตทั้งหมดมาจาก env ตัวเดียว (ค่าเริ่มต้น 8090) + environment: + PORT: ${PORT:-8090} + HOST: 0.0.0.0 + ADMIN_TOKEN: ${ADMIN_TOKEN:-} + PUBLISH_PUSH: ${PUBLISH_PUSH:-0} + NODE_ENV: production + ports: + # ฝั่งโฮสต์ผูกกับ loopback ก่อน ถ้าต้องให้เครื่องอื่นเข้าตั้ง BIND_ADDRESS=0.0.0.0 + - "${BIND_ADDRESS:-127.0.0.1}:${PORT:-8090}:${PORT:-8090}" + + # คงไฟล์ข้อมูลจริงไว้ที่โฮสต์ (แก้ผ่านหลังบ้านแล้วไม่หายเมื่อ recreate container) + volumes: + - ./data:/app/data + + stop_grace_period: 5s