chore(deploy): 增强 Docker 构建与发布流程

- 新增 GitHub Actions Docker 工作流，自动执行前端检查、后端测试并发布 GHCR 镜像。
- 为单容器与多容器部署补充镜像配置、使用说明和环境变量示例。
- 优化各 Dockerfile 的构建缓存与镜像体积，提升构建速度并减少无关文件进入镜像。

deploy/.env.example

@@ -1,16 +1,112 @@
+# LanQin Email 部署环境变量示例
+# 用法：cp deploy/.env.example deploy/.env，然后修改 deploy/.env。
+# 注意：.env 里不要写引号；真实密码、Secret Key 不要提交到 Git。
+
+# =========================
+# Docker 镜像
+# =========================
+# 单容器部署镜像。默认 local 表示本机 docker compose up --build 构建。
+# 如果使用 GitHub Actions 发布到 GHCR，改成：ghcr.io/<owner>/<repo>:latest
+LANQIN_IMAGE=lanqin-email:local
+
+# 多容器调试版镜像。只在 docker-compose.stack.yml 中使用。
+LANQIN_API_IMAGE=lanqin-email-api:local
+LANQIN_WEB_IMAGE=lanqin-email-web:local
+LANQIN_POSTFIX_IMAGE=lanqin-email-postfix:local
+LANQIN_DOVECOT_IMAGE=lanqin-email-dovecot:local
+LANQIN_OPENDKIM_IMAGE=lanqin-email-opendkim:local
+
+# =========================
+# 对外访问地址
+# =========================
+# 邮件服务器主机名，一般填你的邮件域名，例如 mail.example.com。
+# 会影响 Postfix myhostname、DNS 展示、邮件链接等。
 LANQIN_PUBLIC_HOSTNAME=mail.example.com
+
+# Webmail 对外访问地址。生产环境建议使用 https。
 LANQIN_PUBLIC_BASE_URL=https://mail.example.com
+
+# =========================
+# 初始管理员
+# =========================
+# 第一次启动时会创建这个管理员账号。
 LANQIN_ADMIN_EMAIL=admin@example.com
+
+# 生产环境必须改掉默认密码。
 LANQIN_ADMIN_PASSWORD=ChangeMe123!
-LANQIN_DATA_DIR=/data
-LANQIN_DB_PATH=/data/lanqin.db
+
+# =========================
+# API / 数据存储
+# =========================
+# API 监听地址。单容器里由 Nginx 反代到 127.0.0.1:8080。
 LANQIN_ADDR=:8080
+
+# 容器内数据目录。docker-compose.yml 已把 lanqin-data 挂到 /data。
+LANQIN_DATA_DIR=/data
+
+# SQLite 数据库路径。
+LANQIN_DB_PATH=/data/lanqin.db
+
+# Session Cookie 名称，一般不用改。
+LANQIN_COOKIE_NAME=lanqin_session
+
+# 登录会话有效期，单位：小时。默认 168 小时，即 7 天。
+LANQIN_SESSION_TTL_HOURS=168
+
+# 是否允许非 HTTPS 下的 Cookie。生产环境建议 false；本地 HTTP 调试可改 true。
 LANQIN_ALLOW_INSECURE_HTTP=false
+
+# =========================
+# 注册与安全
+# =========================
+# 是否开放用户自行注册。
 LANQIN_OPEN_REGISTRATION=false
+
+# 是否启用 2FA 功能总开关。
 LANQIN_TWO_FACTOR_ENABLED=false
+
+# 是否启用 Cloudflare Turnstile 人机验证。
+LANQIN_TURNSTILE_ENABLED=false
+
+# Turnstile Site Key，前端公开使用。未启用时可以留空。
+LANQIN_TURNSTILE_SITE_KEY=
+
+# Turnstile Secret Key，服务端校验使用。未启用时可以留空。
+LANQIN_TURNSTILE_SECRET_KEY=
+
+# =========================
+# SMTP 发信
+# =========================
+# 单容器部署默认提交给容器内 Postfix。
+# 如果要走外部 SMTP，把 Host/Port/Username/Password 改成外部服务配置。
 LANQIN_SMTP_HOST=127.0.0.1
 LANQIN_SMTP_PORT=25
+LANQIN_SMTP_USERNAME=
+LANQIN_SMTP_PASSWORD=
+
+# 外部 SMTP 要求 STARTTLS / TLS 时改 true；本机 Postfix 默认 false。
 LANQIN_SMTP_REQUIRE_TLS=false
+
+# =========================
+# 收件 / Maildir 同步
+# =========================
+# Dovecot Maildir 根目录。docker-compose.yml 已把 maildata 挂到这里。
 LANQIN_MAILDIR_ROOT=/var/mail/vhosts
+
+# 扫描 Maildir 的间隔，单位：秒。
 LANQIN_MAILDIR_SCAN_SECONDS=30
+
+# 无人收件开关。false：未注册邮箱默认拒收；true：未注册收件地址进入全部邮件。
+LANQIN_CATCH_ALL_ENABLED=false
+
+# Webmail 是否自动轮询刷新邮件。
+LANQIN_MAIL_AUTO_REFRESH=true
+
+# 自动刷新间隔，单位：秒。
+LANQIN_MAIL_REFRESH_SECONDS=30
+
+# =========================
+# 系统
+# =========================
+# 容器时区。
 TZ=Asia/Shanghai