Documentation Index
Fetch the complete documentation index at: https://help.teable.ai/llms.txt
Use this file to discover all available pages before exploring further.
配置方式
Teable 支持两种方式配置邮件服务：
管理面板（推荐）
可视化配置，支持在线测试。无需重启。
方式一：管理面板（推荐）
最简单的配置方式是通过管理面板：
- 使用管理员账号登录（默认为第一个注册的用户）
- 进入 管理面板 → 实例设置
- 找到 邮箱 部分
- 分别按需配置通知邮箱和自动化邮箱
管理面板配置支持在线测试 — 保存前可以验证 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邮箱 → 设置 → 账户 → 开启「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邮箱 → 设置 → 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 # 客户端授权密码
# 获取方式：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 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 密码
相关文档
