diff --git a/.env.docker.example b/.env.docker.example
new file mode 100644
index 0000000..cb65b84
--- /dev/null
+++ b/.env.docker.example
@@ -0,0 +1,25 @@
+# Docker / docker-compose 示例环境变量
+# 1. 建议复制为项目根目录 `.env` 后再按实际环境修改；
+# 2. 该文件只提供“容器部署”所需的最小示例；
+# 3. 如你已经有本地 `.env`，只需补齐下面缺失项即可，无需删除现有内容。
+
+TZ=Asia/Shanghai
+ABOT_ENVIRONMENT=production
+
+# 数据库与 Redis
+ABOT_DB_USER=root
+ABOT_DB_PASSWORD=please_change_me
+ABOT_DB_NAME=message_archive
+ABOT_REDIS_PASSWORD=
+ABOT_REDIS_DB=0
+
+# Dashboard 暴露端口
+DASHBOARD_PORT=8888
+
+# wechat_ipad server 通常跑在宿主机或独立机器上，因此这里单独显式配置。
+WECHAT_SERVER_URL=http://host.docker.internal:8059/
+WECHAT_SERVER_IP=host.docker.internal
+WECHAT_SERVER_PORT=8059
+WECHAT_WXID=
+WECHAT_DEVICE_NAME=ABOTPad
+WECHAT_DEVICE_ID=