# 邮件与订阅 (/docs/use/mail-subscribe)

Mix Space 支持邮件通知和读者订阅功能。配置邮件服务后，系统可以在友链申请、评论通知等场景发送邮件，读者也可以订阅你的内容更新。

## 邮件服务配置

### 前置条件

你需要一个邮件发送服务。Mix Space 支持两种邮件服务：

| 服务 | 说明 |
|------|------|
| **SMTP** | 传统 SMTP 邮件发送，适用于大多数邮件服务商（Gmail、QQ 邮箱、阿里企业邮等） |
| **Resend** | 现代邮件 API 服务，配置简单，适合开发者 |

### 配置步骤

<Steps>
<Step>
### 进入邮件设置

登录后台，前往「设置 → 通知 → 邮件通知」。
</Step>

<Step>
### 开启邮件提醒

打开「开启邮箱提醒」开关。
</Step>

<Step>
### 选择邮件服务

在「邮件服务」下拉框中选择 SMTP 或 Resend。
</Step>

<Step>
### 填写配置

**SMTP 方式：**

| 字段 | 说明 |
|------|------|
| SMTP 用户名 | 邮箱账号 |
| SMTP 密码 | 邮箱密码或应用专用密码 |
| SMTP 主机 | SMTP 服务器地址（如 `smtp.gmail.com`） |
| SMTP 端口 | 端口号（如 `465`） |
| 使用 SSL/TLS | 是否启用加密连接 |
| 发件邮箱地址 | 发件人邮箱，不填则使用 SMTP 用户名 |

**Resend 方式：**

| 字段 | 说明 |
|------|------|
| Resend API Key | 在 [resend.com](https://resend.com) 获取的 API 密钥 |
| 发件邮箱地址 | Resend 中验证的发件域名邮箱（必填） |

</Step>

<Step>
### 高级设置（可选）

| 配置项 | 说明 |
|--------|------|
| **发送速率限制** | 每秒最大发送次数，默认 10 |
| **发送失败重试次数** | 最大重试次数，默认 3 |

</Step>
</Steps>

<Callout type="warn">
使用 SMTP 时，部分邮件服务商（如 Gmail）需要开启「应用专用密码」或「不太安全的应用访问」才能正常发送。建议使用 Resend 等专业邮件 API 服务。
</Callout>

## 读者订阅

开启订阅功能后，读者可以通过邮箱订阅你的内容更新。当发布新文章或日记时，系统会自动向订阅者发送邮件通知。

### 开启订阅

进入后台「设置 → 系统 → 功能开关」，打开「开启邮件推送订阅」开关。

<Callout type="info">
订阅功能依赖邮件服务。请先完成邮件服务配置，否则订阅邮件无法发送。
</Callout>

### 订阅类型

读者可以选择订阅以下内容类型：

| 类型 | 说明 |
|------|------|
| **博文** | 新文章发布时通知 |
| **手记** | 新日记发布时通知 |
| **速记** | 新速记发布时通知 |
| **说说** | 新说说发布时通知 |

### 管理订阅者

登录后台，进入后台的「订阅」页面页面，可以查看所有订阅者：

- 查看订阅者的邮箱、订阅类型和订阅时间
- 按类型筛选订阅者
- 手动取消订阅者的订阅
- 批量取消订阅

### 取消订阅

读者可以在收到的邮件中点击取消订阅链接，你也可以在后台管理页面手动为读者取消订阅。

## 其他通知方式

除了邮件，Mix Space 还支持 **Bark 推送通知**（iOS）。在「设置 → 通知 → Bark 通知」中配置：

| 配置项 | 说明 |
|--------|------|
| **开启 Bark 通知** | 启用 Bark 推送 |
| **设备 Key** | Bark App 中的设备推送 Key |
| **服务器 URL** | 自定义 Bark 服务器地址，不填则使用默认 `https://day.app` |
| **开启评论通知** | 收到新评论时推送 |
| **开启请求被限流时通知** | 可以在一定程度上预警被攻击 |