diff --git a/.gitignore b/.gitignore
index b8b8114..00cb86c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,3 +30,7 @@ Thumbs.db
 .vscode/
 .idea/
 *.swp
+
+# ===== 本地 Gitea/runner 数据（docker compose 产生）=====
+docker/gitea-data/
+docker/runner-data/
diff --git a/docker/gitea.docker-compose.yml b/docker/gitea.docker-compose.yml
new file mode 100644
index 0000000..46860fd
--- /dev/null
+++ b/docker/gitea.docker-compose.yml
@@ -0,0 +1,28 @@
+# 本地 Phase 0 验证用 Gitea + act_runner
+# 用法：cd docker && docker compose -f gitea.docker-compose.yml up -d
+# 注意 Windows Docker Desktop：act_runner 挂 docker.sock 可能需改为
+#   - //var/run/docker.sock:/var/run/docker.sock （双斜杠）
+services:
+  gitea:
+    image: gitea/gitea:1
+    environment:
+      - USER_UID=1000
+      - USER_GID=1000
+    volumes:
+      - ./gitea-data:/data
+    ports:
+      - "3000:3000"   # Web
+      - "2222:22"     # SSH
+    restart: unless-stopped
+
+  runner:
+    image: gitea/act_runner:latest
+    environment:
+      - GITEA_INSTANCE_URL=http://gitea:3000
+      - GITEA_RUNNER_REGISTRATION_TOKEN=phase0-local-token
+    volumes:
+      - ./runner-data:/data
+      - /var/run/docker.sock:/var/run/docker.sock
+    depends_on:
+      - gitea
+    restart: unless-stopped