配置私有化实例的 SMTP 邮件服务

配置方式

Teable 支持两种方式配置邮件服务：

系统管理（推荐）

可视化配置，支持在线测试。无需重启。

环境变量

通过 .env 文件配置。需要重启容器。

方式一：系统管理（推荐）

最简单的配置方式是通过系统管理：

使用管理员账号登录（默认为第一个注册的用户）
进入 系统管理 → 实例设置
找到 邮件配置 部分
按需配置 通知邮箱 和 自动化邮箱：点击对应行右侧的按钮，在弹出的窗口中填写 SMTP 信息并保存

配置窗口支持在线测试：保存前输入测试邮箱并点击发送，即可验证 SMTP 设置是否正确。

通知邮箱：用于用户验证、重置密码、邀请、系统通知等邮件，也是登录页 使用邮箱验证码登录 的前提。
自动化邮箱：作为自动化发送邮件操作的默认邮件服务。单个发送邮件操作也可以配置自己的自定义邮件服务器。

配置来源和优先级

建议优先在 系统管理 → 实例设置 → 邮件配置 中配置邮件服务。不同来源的生效顺序如下：

发送邮件动作内的自定义邮件服务器：只作用于当前自动化的这一个发送邮件动作。
系统管理 → 实例设置 → 邮件配置 → 自动化邮箱：当发送邮件动作没有单独配置邮件服务器时，自动化邮件默认使用这里的配置。
系统管理 → 实例设置 → 邮件配置 → 通知邮箱：用于用户验证、重置密码、邀请、系统通知等邮件；如果未配置自动化邮箱，也会作为自动化邮件的回退配置。
环境变量 BACKEND_MAIL_*：部署级默认邮件配置。只有在系统管理中没有配置对应邮箱时，才作为兜底配置使用。

配置字段说明

字段	说明	示例
服务器地址	SMTP 服务器地址	`smtp.qq.com`
端口	SMTP 端口	`465` (SSL) 或 `587` (TLS)
SSL/TLS	是否使用 SSL/TLS	`true`
用户名	SMTP 认证用户	`noreply@company.com`
密码	SMTP 密码或授权码	`xxxxxxxxxxxxxx`
发件人地址	发件地址	`noreply@company.com`
发件人名称	显示名称	`系统通知`

方式二：环境变量

如果你更倾向于基于文件的配置，可以使用环境变量：

推荐优先在 系统管理 → 实例设置 → 邮件配置 中配置通知邮箱和自动化邮箱。环境变量主要作为部署级默认配置和兜底配置。

BACKEND_MAIL_HOST=smtp.example.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@company.com
BACKEND_MAIL_SENDER_NAME=系统通知
BACKEND_MAIL_AUTH_USER=username
BACKEND_MAIL_AUTH_PASS=your_password

修改环境变量后，需要重启 Teable 容器才能生效。

SMTP 服务商配置示例

阿里云邮件推送

# 获取方式：阿里云控制台 → 邮件推送 → SMTP设置 → 生成密码
BACKEND_MAIL_HOST=smtpdm.aliyun.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@yourdomain.com  # 需在控制台验证过的发信地址
BACKEND_MAIL_SENDER_NAME=系统通知
BACKEND_MAIL_AUTH_USER=your_smtp_username   # 控制台显示的SMTP账号
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx       # 控制台生成的SMTP密码

QQ 邮箱

# 获取方式：登录网页版QQ邮箱 → 设置 → 账户 → 开启「POP3/SMTP服务」→ 获取授权码
BACKEND_MAIL_HOST=smtp.qq.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=your_qq@qq.com
BACKEND_MAIL_SENDER_NAME=系统通知
BACKEND_MAIL_AUTH_USER=your_qq@qq.com
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # 16位SMTP授权码

163 邮箱

# 获取方式：登录163邮箱 → 设置 → POP3/SMTP → 开启「客户端授权密码」
BACKEND_MAIL_HOST=smtp.163.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=yourname@163.com
BACKEND_MAIL_SENDER_NAME=系统通知
BACKEND_MAIL_AUTH_USER=yourname@163.com
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # 客户端授权密码

Gmail

# 获取方式：Google账号 → 安全 → 两步验证 → 应用专用密码
BACKEND_MAIL_HOST=smtp.gmail.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=you@gmail.com
BACKEND_MAIL_SENDER_NAME=系统通知
BACKEND_MAIL_AUTH_USER=you@gmail.com
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # 16位应用密码

AWS SES

# 获取方式：AWS Console → Simple Email Service → SMTP Settings → Create SMTP Credentials
BACKEND_MAIL_HOST=email-smtp.us-east-1.amazonaws.com  # 替换为你的区域
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@yourdomain.com  # 需在 SES 验证过的发信地址
BACKEND_MAIL_SENDER_NAME=系统通知
BACKEND_MAIL_AUTH_USER=your_smtp_username   # AWS SMTP 用户名
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx       # AWS SMTP 密码

自托管许可证

快速开始

系统管理

配置

合规与遥测

维护

已弃用

配置私有化实例的 SMTP 邮件服务

配置方式

系统管理（推荐）

环境变量

方式一：系统管理（推荐）

配置来源和优先级

配置字段说明

方式二：环境变量

SMTP 服务商配置示例

相关文档

​配置方式

系统管理（推荐）

环境变量

​方式一：系统管理（推荐）

​配置来源和优先级

​配置字段说明

​方式二：环境变量

​SMTP 服务商配置示例

​相关文档

配置方式

方式一：系统管理（推荐）

配置来源和优先级

配置字段说明

方式二：环境变量

SMTP 服务商配置示例

相关文档