> ## 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 支持两种方式配置邮件服务：

<CardGroup cols={2}>
  <Card title="管理面板（推荐）" icon="sliders" href="#方式一管理面板推荐">
    可视化配置，支持在线测试。无需重启。
  </Card>

  <Card title="环境变量" icon="code" href="#方式二环境变量">
    通过 `.env` 文件配置。需要重启容器。
  </Card>
</CardGroup>

***

## 方式一：管理面板（推荐）

最简单的配置方式是通过管理面板：

1. 使用管理员账号登录（默认为第一个注册的用户）
2. 进入 **管理面板** → **实例设置**
3. 找到 **邮箱** 部分
4. 分别按需配置**通知邮箱**和**自动化邮箱**

<Tip>
  管理面板配置支持**在线测试** — 保存前可以验证 SMTP 设置是否正确。
</Tip>

* **通知邮箱**：用于用户验证、重置密码、邀请、系统通知等邮件。
* **自动化邮箱**：作为自动化发送邮件操作的默认邮件服务。单个发送邮件操作也可以配置自己的[自定义邮件服务器](/zh/basic/automation/actions/communication/smtp-sender)。

### 配置来源和优先级

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

1. **发送邮件动作内的自定义邮件服务器**：只作用于当前自动化的这一个发送邮件动作。
2. **管理面板 → 实例设置 → 邮箱 → 自动化邮箱**：当发送邮件动作没有单独配置邮件服务器时，自动化邮件默认使用这里的配置。
3. **管理面板 → 实例设置 → 邮箱 → 通知邮箱**：用于用户验证、重置密码、邀请、系统通知等邮件；如果未配置自动化邮箱，也会作为自动化邮件的回退配置。
4. **环境变量 `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`     |
| 发件人名称   | 显示名称         | `系统通知`                    |

***

## 方式二：环境变量

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

<Note>
  推荐优先在 **管理面板 → 实例设置 → 邮箱** 中配置通知邮箱和自动化邮箱。环境变量主要作为部署级默认配置和兜底配置。
</Note>

```sh theme={null}
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
```

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

***

## SMTP 服务商配置示例

<Accordion title="阿里云邮件推送">
  ```sh theme={null}
  # 获取方式：阿里云控制台 → 邮件推送 → 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密码
  ```
</Accordion>

<Accordion title="QQ 邮箱">
  ```sh theme={null}
  # 获取方式：登录网页版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授权码
  ```
</Accordion>

<Accordion title="163 邮箱">
  ```sh theme={null}
  # 获取方式：登录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  # 客户端授权密码
  ```
</Accordion>

<Accordion title="Gmail">
  ```sh theme={null}
  # 获取方式：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位应用密码
  ```
</Accordion>

<Accordion title="AWS SES">
  ```sh theme={null}
  # 获取方式：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 密码
  ```
</Accordion>

***

## 相关文档

* [环境变量参考](/zh/deploy/env)
* [管理员后台概览](/zh/basic/admin-panel/overview)