# 连接邮箱

哨站支持最多 20 个 TLS IMAP 邮箱。每个邮箱独立保存凭据、文件夹订阅和连接预算。

通过 iPhone 使用 Pro 管理时，按[在 App 中添加邮箱](app.md#add-a-mailbox-in-the-app)操作。

## 准备连接信息

在邮箱服务商设置中启用 IMAP。服务商要求应用专用密码或授权码时，填写对应凭据；企业账号可能需要管理员开放权限。哨站使用填写的 IMAP 用户名和密码认证，先确认服务商允许这种接入方式。

可以在控制台选择服务商预设，也可以按服务商文档填写 TLS IMAP 主机与端口，通常为 993。要求完整邮箱地址时，使用完整地址作为用户名。常见预设包括 QQ、163、126、iCloud 和 Gmail。不同账号的限制可能不同，以服务商自己的帮助文档为准。

## 添加并验证

1. 登录哨站 Web 控制台，打开邮箱页面。
2. 填写显示名称、IMAP 主机、端口、用户名与授权凭据。
3. 测试连接并保存。连接成功表示认证可用，实际监听范围由文件夹订阅决定。
4. [选择文件夹](folders.md)，再配置[通知渠道](notifications.md)。

显示名称会出现在通知中，即使关闭邮件预览也会显示。请使用适合发送给通知服务商的名称。

## 更新凭据或移除邮箱

已保存密码采用只写方式。主机、端口和用户名保持原值时，省略密码可保留现有凭据；修改任一连接字段须重新输入密码。在服务商处轮换密码后，明确填写新凭据。连接错误会标明受影响的邮箱，可以逐个排查。

移除邮箱会停止该邮箱的监听，已经入队的通知保留投递计划，仍可能继续投递。删除前阅读确认说明并保存需要保留的历史或配置。需要可恢复的部署状态时，执行完整[备份](backup.md)。

## 认证失败时检查什么

依次核对主机、TLS 端口、完整用户名、授权码与 IMAP 开关，并确认哨站服务器能访问服务商。认证成功但找不到文件夹时，刷新发现结果，检查文件夹是否保存在 IMAP 服务器上；客户端本地文件夹无法由哨站监听。