diff --git a/.env.example b/.env.example
index 9e184e0..fa0b0e9 100644
--- a/.env.example
+++ b/.env.example
@@ -31,6 +31,7 @@ REGISTRY_USER=
 # 镜像版本标签，与业务发布版本一一对应
 # 开发/体验环境可用 latest；生产环境请固定版本号
 IMAGE_TAG=latest
+MANAGEMENT_HEALTH_MAIL_ENABLED=false
 
 # =============================================================================
 # 服务 Profile — 选择要启动哪些容器
diff --git a/docker-compose.yml b/docker-compose.yml
index f71fe06..db73b3a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -160,6 +160,8 @@ services:
       SDK_TENANT_SERVICE_URL: "http://tenant-service:9001"
       FILE_BASE_URL: "${CONSOLE_DOMAIN}"
       FILE_SERVICE_INTERNAL_URL: "http://file-service:8086"
+      # 邮件通知默认关闭；没有 SMTP 配置时不应让 update-service 整体健康检查失败。
+      MANAGEMENT_HEALTH_MAIL_ENABLED: "${MANAGEMENT_HEALTH_MAIL_ENABLED:-false}"
     volumes:
       - ./data/update:/data/update   # 版本包存储目录
     restart: unless-stopped
diff --git a/docs/configuration.md b/docs/configuration.md
index 9bf10bb..40dfc62 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -137,6 +137,8 @@ Web 代理会覆盖上游缓存头：入口 HTML、manifest 和普通路由使
 
 邮件服务配置，不填则邮件功能不可用，不影响其他服务启动。`tenant-service`
 用于账号邮件，`update-service` 用于租户显式启用的商店状态邮件通知；通知默认关闭，
+未配置 SMTP 时 `MANAGEMENT_HEALTH_MAIL_ENABLED=false`，不会使更新服务整体健康状态
+变为 DOWN。启用邮件通知并完成 SMTP 配置后，可设为 `true` 将邮件连接纳入健康检查。
 邮件发送失败不得影响商店状态同步和平台主流程。
 
 ---