From 9e637f09dff95e1a8ce8388541d44f09920d12bd Mon Sep 17 00:00:00 2001
From: Yun Chan <yunchan@twentyoz.kr>
Date: Sat, 15 Aug 2026 12:39:36 +0900
Subject: [PATCH] deploy: .env template + gitignore hardening (.env* ignored,
 template whitelisted)

---
 .env.example | 31 +++++++++++++++++++++++++++++++
 .gitignore   |  3 +++
 2 files changed, 34 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..59470dc
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,31 @@
+# VideoDownloader 배포/빌드 환경 설정 템플릿
+# 이 파일을 .env 로 복사한 뒤 실제 값을 채운다. .env 는 git 에 커밋되지 않는다(.gitignore).
+# 값에 따옴표는 붙이지 않는다.
+
+# ── Cloudflare Pages (다운로드 사이트 배포) ──────────────────────────
+# https://dash.cloudflare.com/profile/api-tokens → Create Token
+# 권한: Account → Cloudflare Pages → Edit (+ Zone → Cache Purge)
+CLOUDFLARE_API_TOKEN=
+CLOUDFLARE_ACCOUNT_ID=
+CLOUDFLARE_PAGES_PROJECT=
+CLOUDFLARE_ZONE_ID=
+
+# ── Cloudflare Wrangler (별도 토큰이 있을 때만) ─────────────────────
+CF_API_TOKEN=
+
+# ── 빌드머신 1: macOS (arm64) ────────────────────────────────────────
+# Tailscale IP 우선(원격 겸용). 같은 LAN에 있으면 LAN IP가 빠름.
+# 예시: 100.x.x.x (Tailscale) / 192.168.0.x (LAN)
+MAC_OS_HOST=
+MAC_OS_LAN_HOST=
+MAC_OS_USER=
+MAC_OS_PASSWORD=
+
+# ── 빌드머신 2: Linux (x86_64) ───────────────────────────────────────
+LINUX_OS_HOST=
+LINUX_OS_USER=
+LINUX_OS_PASSWORD=
+
+# ── GitHub (릴리스 업로드 — 연동 시점에 주석 해제) ──────────────────
+# GITHUB_TOKEN=
+# GITHUB_REPO=owner/videodownloader
diff --git a/.gitignore b/.gitignore
index 3bc8470..d153448 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,3 +8,6 @@ publish/
 TestResults/
 app.log
 requests.log
+.env*
+*.env
+!.env.example