跳到主要内容
版本：2.x

邮件

概述​

邮件标签页配置平台的 SMTP 邮件服务器连接。配好后，平台可以发送系统邮件。标签页内置测试邮件功能，配置完成后可立即验证是否生效。

邮件配置的核心是一个主开关（"启用邮件"）——只有开启后，下方的 SMTP 详细配置才会出现；关闭时邮件功能完全停用。

配置项说明​

配置项之间存在条件联动——某些字段只有在特定开关开启后才会显示或变为必填。下文按层级说明。

主开关​

启用邮件​

属性说明
业务含义邮件功能的总开关——开启后平台才能发送邮件
何时使用需要系统邮件功能时开启；暂时不需要时可关闭
默认值关闭
这是所有邮件配置的前置条件

以下所有 SMTP 配置项只有在此开关开启后才会显示。关闭时它们全部隐藏，且邮件功能完全停用。

SMTP 连接配置​

启用邮件后，以下配置项出现：

SMTP 主机​

属性说明
业务含义SMTP 服务器的主机名或 IP 地址
条件启用邮件后必填
示例smtp.gmail.com、smtp.qq.com、192.168.1.10

SMTP 端口​

属性说明
业务含义SMTP 服务器的端口号
取值范围1 – 65535
默认值25
常见端口25（明文）、465（SSL/TLS）、587（STARTTLS）

端口需要与下方"SMTP 安全模式"配合使用。

SMTP 安全模式​

属性说明
业务含义SMTP 连接的加密方式
可选值无加密、STARTTLS、SSL/TLS
默认值无加密
安全模式对应端口含义
无加密25不加密，明文传输（仅内网或测试环境使用）
STARTTLS587先明文连接，再升级为加密（推荐）
SSL/TLS465从头到尾加密连接

验证 SSL 证书​

属性说明
业务含义是否验证 SMTP 服务器的 SSL/TLS 证书
何时使用安全模式非"无加密"时显示；使用自签名证书时需要关闭
默认值关闭
自签名证书

如果 SMTP 服务器使用的是自签名证书（常见于内网邮件服务器），请关闭此选项，否则连接会因证书验证失败而被拒绝。公网邮件服务（如 Gmail、QQ 邮箱）建议开启。

SMTP 认证配置（启用认证后显示）​

SMTP 认证​

属性说明
业务含义是否使用用户名 / 密码进行 SMTP 认证
何时使用大多数公网邮件服务都要求认证；内网匿名中继可关闭
默认值关闭

开启 SMTP 认证后，以下两个字段出现：

SMTP 用户名​

属性说明
业务含义SMTP 认证的用户名（通常是邮箱地址）
条件启用认证后必填
示例user@example.com

SMTP 密码​

属性说明
业务含义SMTP 认证的密码或应用专用密码
条件启用认证后必填
显示方式已配置时显示 ******** 掩码
应用专用密码

部分邮件服务商（如 Gmail、QQ 邮箱）不允许直接使用登录密码做 SMTP 认证，需要生成"应用专用密码"或"授权码"。请参考对应服务商的文档获取。

发件人配置​

发件人地址​

属性说明
业务含义所有外发邮件的"发件人"邮箱地址
条件启用邮件后必填
格式有效的邮箱地址
示例noreply@example.com

发件人名称​

属性说明
业务含义外发邮件的"发件人"显示名称（收件人看到的名称）
默认值ITOM Platform
示例运维平台、ITOM Admin

测试邮件​

启用邮件后，SMTP 配置区域下方会出现"发送测试邮件"面板——用于验证当前 SMTP 配置是否能正常发送邮件。

常见错误排查​

错误提示可能原因解决方法
SMTP 主机未找到主机地址拼写错误或 DNS 无法解析检查"SMTP 主机"地址是否正确
连接被拒绝端口号错误或防火墙阻止检查"SMTP 端口"和"安全模式"是否匹配
连接超时网络不可达或服务器响应慢检查网络连通性，或稍后重试
SMTP 认证失败用户名或密码错误检查用户名 / 密码，或使用应用专用密码
SSL/TLS 连接错误证书问题或安全模式不匹配检查"安全模式"和"验证 SSL 证书"设置
网络不可达平台服务器无法访问 SMTP 服务器检查网络出口、代理或防火墙规则
先保存再测试

测试邮件使用的是已保存的 SMTP 配置，不是当前未保存的修改。因此，修改 SMTP 配置后需要先点击"保存"，再发送测试邮件。