邮箱管理
添加邮箱账号
进入设置中心 → 邮箱管理 → 添加账号，填写以下信息：
| 字段 | 说明 | 示例 |
|---|---|---|
| 名称 | 显示名称 | 工作邮箱 |
| 邮箱地址 | 完整邮箱地址 | user@qq.com |
| IMAP 主机 | 邮件服务器地址 | imap.qq.com |
| IMAP 端口 | 通常为 993 (TLS) 或 143 (STARTTLS) | 993 |
| 用户名 | IMAP 登录名（通常同邮箱地址） | user@qq.com |
| 密码 | IMAP 密码或授权码 | ******** |
QQ / 163 等国内邮箱
大部分现代邮箱服务商需要使用「授权码」而非登录密码。请在对应服务商的账户设置中开启 IMAP 服务并生成授权码。
常见邮箱服务器配置
| 服务商 | IMAP 主机 | 端口 | 加密方式 |
|---|---|---|---|
| QQ 邮箱 | imap.qq.com | 993 | SSL/TLS |
| 163 邮箱 | imap.163.com | 993 | SSL/TLS |
| Outlook | outlook.office365.com | 993 | SSL/TLS |
| Gmail | imap.gmail.com | 993 | SSL/TLS |
| Yahoo | imap.mail.yahoo.com | 993 | SSL/TLS |
HTTP 代理
如果你的服务器需要通过代理访问外部邮件服务（如 Outlook / Gmail），可以在添加账号时展开「HTTP 代理」配置项：
- 开启「启用代理」开关
- 填写代理地址，支持以下格式：
- HTTP 代理：
http://user:pass@proxy-host:8080 - SOCKS5 代理：
socks5://host:1080
- HTTP 代理：
代理配置随账号独立存储，IMAP 收信和 SMTP 发信均会通过代理连接。
测试连接
添加或修改邮箱后，可点击「测试连接」按钮验证 IMAP 配置是否正确：
- ✅ 连接成功 — 认证通过，可以正常收取邮件
- ⚠️ 认证失败 — 请检查用户名和密码
- ❌ 连接超时 — 请检查主机地址、端口和网络防火墙
同步策略
系统采用两种同步机制：
IMAP IDLE（实时）
- 默认启用，新邮件秒级到达通知
- 需要服务器支持 IDLE 扩展（RFC 2177）
- 不支持时自动降级为轮询
定时轮询（兜底）
- 默认间隔 5 分钟（可通过
MAGICMAIL_POLL_INTERVAL调整） - 作为 IDLE 不可用时的备选方案
- 最低间隔 10 秒
管理操作
- 编辑：修改邮箱连接参数
- 手动同步：立即拉取该邮箱的最新邮件
- 删除：移除邮箱及已同步的本地邮件数据