diff --git a/ruoyi-admin/src/main/resources/application-dev.yml b/ruoyi-admin/src/main/resources/application-dev.yml
index bb04b95..ab26ddb 100644
--- a/ruoyi-admin/src/main/resources/application-dev.yml
+++ b/ruoyi-admin/src/main/resources/application-dev.yml
@@ -206,6 +206,38 @@ mail:
   # Socket连接超时值，单位毫秒，缺省值不超时
   connectionTimeout: 0
 
+--- # 设备域 · APP 端配置（前缀 device.app，对应 org.dromara.device.config.AppProperties）
+# 所有项在代码中均有默认值，此处显式列出仅为便于运维调参；整段删除不影响启动。
+device:
+  app:
+    # ---------------- APP 邮箱验证码（邮箱注册 / 邮箱登录 / 邮箱找回密码） ----------------
+    email:
+      # 是否仅打印日志而不真实发信：开发环境默认 true，便于在无 SMTP 条件下联调。
+      # 【生产环境(prod)必须为 false】——否则应用拒绝启动，防止验证码明文写入日志。
+      mock: true
+      # 谷歌邮箱 Gmail SMTP
+      host: ${DEVICE_APP_EMAIL_HOST:smtp.gmail.com}
+      # 465 走 SSL；若改用 587 端口，请同时设 ssl-enable=false 且 starttls-enable=true
+      port: ${DEVICE_APP_EMAIL_PORT:465}
+      # 发信账号（Gmail 地址）。凭据一律由环境变量注入，禁止写入本文件
+      user: ${DEVICE_APP_EMAIL_USER:}
+      # 发信凭据：Gmail 的 16 位「应用专用密码」（非账号登录密码），由环境变量注入
+      pass: ${DEVICE_APP_EMAIL_PASS:}
+      # 发件人，留空则回落到 user。Gmail 要求发件人与认证账号一致，否则拒收
+      from: ${DEVICE_APP_EMAIL_FROM:}
+      ssl-enable: true
+      starttls-enable: false
+      # smtp.gmail.com 在国内机房通常不可达，必须快速失败，避免挂死 HTTP 请求线程
+      connection-timeout: 5000
+      timeout: 10000
+      # 验证码位数 / 有效期（分钟）/ 重发间隔（秒）
+      code-length: 6
+      expiry-minutes: 5
+      resend-seconds: 60
+      # 允许注册的邮箱域名白名单，留空（或不配）表示不限制域名。
+      # 若产品要求「只允许谷歌邮箱注册」，取消下行注释即可，无需改代码：
+      # allowed-domains: gmail.com,googlemail.com
+
 --- # sms 短信 支持 阿里云 腾讯云 云片 等等各式各样的短信服务商
 # https://sms4j.com/doc3/ 差异配置文档地址 支持单厂商多配置，可以配置多个同时使用
 sms:
diff --git a/ruoyi-admin/src/main/resources/application-prod.yml b/ruoyi-admin/src/main/resources/application-prod.yml
index e581b18..74a3e79 100644
--- a/ruoyi-admin/src/main/resources/application-prod.yml
+++ b/ruoyi-admin/src/main/resources/application-prod.yml
@@ -209,6 +209,39 @@ mail:
   # Socket连接超时值，单位毫秒，缺省值不超时
   connectionTimeout: 0
 
+--- # 设备域 · APP 端配置（前缀 device.app，对应 org.dromara.device.config.AppProperties）
+# 所有项在代码中均有默认值，此处显式列出仅为便于运维调参；整段删除不影响启动。
+device:
+  app:
+    # ---------------- APP 邮箱验证码（邮箱注册 / 邮箱登录 / 邮箱找回密码） ----------------
+    email:
+      # 【必须为 false】生产环境开启 mock 会把邮箱验证码明文写入日志，
+      # 此时 org.dromara.device.config.AppEmailProdGuard 将直接拒绝启动（属预期保护）。
+      mock: false
+      # 谷歌邮箱 Gmail SMTP
+      host: ${DEVICE_APP_EMAIL_HOST:smtp.gmail.com}
+      # 465 走 SSL；若改用 587 端口，请同时设 ssl-enable=false 且 starttls-enable=true
+      port: ${DEVICE_APP_EMAIL_PORT:465}
+      # 发信账号（Gmail 地址）。凭据一律由环境变量注入，禁止写入本文件
+      user: ${DEVICE_APP_EMAIL_USER:}
+      # 发信凭据：Gmail 的 16 位「应用专用密码」（非账号登录密码），由环境变量注入
+      pass: ${DEVICE_APP_EMAIL_PASS:}
+      # 发件人，留空则回落到 user。Gmail 要求发件人与认证账号一致，否则拒收
+      from: ${DEVICE_APP_EMAIL_FROM:}
+      ssl-enable: true
+      starttls-enable: false
+      # smtp.gmail.com 在国内机房通常不可达：若部署在国内，请评估改用国内 SMTP，
+      # 或确认服务器具备出海能力后再上线邮箱注册功能。
+      connection-timeout: 5000
+      timeout: 10000
+      # 验证码位数 / 有效期（分钟）/ 重发间隔（秒）
+      code-length: 6
+      expiry-minutes: 5
+      resend-seconds: 60
+      # 允许注册的邮箱域名白名单，留空（或不配）表示不限制域名。
+      # 若产品要求「只允许谷歌邮箱注册」，取消下行注释即可，无需改代码：
+      # allowed-domains: gmail.com,googlemail.com
+
 --- # sms 短信 支持 阿里云 腾讯云 云片 等等各式各样的短信服务商
 # https://sms4j.com/doc3/ 差异配置文档地址 支持单厂商多配置，可以配置多个同时使用
 sms: