diff --git a/docker/gitea.docker-compose.yml b/docker/gitea.docker-compose.yml
index 46860fd..6a99b50 100644
--- a/docker/gitea.docker-compose.yml
+++ b/docker/gitea.docker-compose.yml
@@ -1,17 +1,24 @@
 # 本地 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 （双斜杠）
+# 说明：
+#   - Gitea Web: http://localhost:3001 （宿主 3001，避开 Astro dev 占用的 3000）
+#   - docker.sock 用单斜杠即可：compose 文件内 YAML 值不经 shell，
+#     Docker Desktop for Windows 下实测可正常访问宿主 daemon（已验证）
+#   - GITEA_RUNNER_REGISTRATION_TOKEN 在 gitea 与 runner 两端设相同值：
+#     gitea 启动时将其作为全局 registration token，runner 用它完成注册
 services:
   gitea:
     image: gitea/gitea:1
     environment:
       - USER_UID=1000
       - USER_GID=1000
+      - GITEA__security__INSTALL_LOCK=true                      # 跳过首装页面，以默认 SQLite 配置启动
+      - GITEA__server__ROOT_URL=http://localhost:3001/          # 对外访问地址（宿主端口）
+      - GITEA_RUNNER_REGISTRATION_TOKEN=phase0-local-actions-runner-token-0123456789abcdef0123456789      # 全局 registration token，与 runner 端一致
     volumes:
       - ./gitea-data:/data
     ports:
-      - "3000:3000"   # Web
+      - "3001:3000"   # Web（宿主 3001，避开 Astro dev 占用的 3000）
       - "2222:22"     # SSH
     restart: unless-stopped
 
@@ -19,7 +26,8 @@ services:
     image: gitea/act_runner:latest
     environment:
       - GITEA_INSTANCE_URL=http://gitea:3000
-      - GITEA_RUNNER_REGISTRATION_TOKEN=phase0-local-token
+      - GITEA_RUNNER_REGISTRATION_TOKEN=phase0-local-actions-runner-token-0123456789abcdef0123456789
+      - GITEA_RUNNER_LABELS=ubuntu-latest:docker://node:20-bookworm,ubuntu-24.04:docker://node:20-bookworm,ubuntu-22.04:docker://node:20-bookworm
     volumes:
       - ./runner-data:/data
       - /var/run/docker.sock:/var/run/docker.sock