diff --git a/.env.example b/.env.example
index fbd1def..3c9551c 100644
--- a/.env.example
+++ b/.env.example
@@ -1,17 +1,34 @@
-# --- 数据库（Neon.tech 或其他 PostgreSQL）---
-PGHOST=ep-xxxx.ap-southeast-2.aws.neon.tech
+# --- 数据库 ---
+# 默认配置指向本地 Docker(配合 docker compose up -d postgres),开箱即用。
+# 如使用 Neon 云数据库,把下面 8 行注释掉,启用底部的 Neon 配置块。
+PGHOST=localhost
 PGPORT=5432
-PGUSER=neondb_owner
+PGUSER=involution
 PGPASSWORD=change_me
-PGDATABASE=neondb
-PGSSLMODE=require
+PGDATABASE=involution_hell
+PGSSLMODE=disable
+
+# Spring Boot JDBC 连接(由上面的 PG 变量转换而来)
+SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/involution_hell
+# 首次启动需为 always 以执行 schema.sql 初始化建表,之后可改为 never
+SPRING_SQL_INIT_MODE=always
+
+# --- 数据库（Neon.tech 或其他 PostgreSQL）---
+# PGHOST=ep-xxxx.ap-southeast-2.aws.neon.tech
+# PGPORT=5432
+# PGUSER=neondb_owner
+# PGPASSWORD=change_me
+# PGDATABASE=neondb
+# PGSSLMODE=require
 
 # Spring Boot JDBC 连接（由上面的 PG 变量转换而来）
-SPRING_DATASOURCE_URL=jdbc:postgresql://ep-xxxx.ap-southeast-2.aws.neon.tech/neondb?sslmode=require
+# SPRING_DATASOURCE_URL=jdbc:postgresql://ep-xxxx.ap-southeast-2.aws.neon.tech/neondb?sslmode=require
 # 首次部署时设为 always 以初始化 schema.sql，之后改为 never
-SPRING_SQL_INIT_MODE=never
+# SPRING_SQL_INIT_MODE=never
 
 # --- 本地开发用 Docker PostgreSQL（无 Neon 账号的开发者使用）---
+# 这些变量被 docker-compose.yml 读取,用于创建本地 Postgres 容器。
+# POSTGRES_PASSWORD 没有默认值,必须显式设置,否则容器启动失败。
 POSTGRES_DB=involution_hell
 POSTGRES_USER=involution
 POSTGRES_PASSWORD=change_me
@@ -61,6 +78,13 @@ MANAGEMENT_ENDPOINT_HEALTH_PROBES_ENABLED=true
 # when-authorized 生产推荐；开发时可改为 always
 MANAGEMENT_ENDPOINT_HEALTH_SHOW_DETAILS=when-authorized
 
+# --- pgAdmin(可选的数据库 Web 管理界面)---
+# docker-compose.yml 的 pgadmin 服务用这两个变量。
+# 即使你不启动 pgadmin 服务,docker compose 命令在解析 yml 时也会校验
+# PGADMIN_PASSWORD,所以这个变量必须设置,否则 docker compose ps / up 等命令都会报错。
+PGADMIN_EMAIL=admin@involutionhell.com
+PGADMIN_PASSWORD=change_me
+
 # --- 网关（Caddy）---
 CADDY_HTTP_PORT=80
 CADDY_HTTPS_PORT=443