## Cypht 轻量级开源邮件客户端 **官方网站：** https://cypht.org/ **仓库地址：** https://github.com/lazycatapps/cypht.git Cypht 是一个轻量级、现代化的开源网页邮件客户端。它提供了简洁直观的用户界面，支持 IMAP 和 SMTP 协议，可以连接多个邮件账户进行统一管理。 ## 主要功能 - 📧 支持多个 IMAP/SMTP 邮件账户 - 🔐 OAuth2 认证支持（Outlook.com、Office 365） - 🌐 响应式网页界面，支持多种设备访问 - 🔒 使用数据库存储会话和用户配置 - 📱 现代化的邮件阅读和管理体验 - 🔍 强大的邮件搜索功能 - 📎 附件下载和管理 - 🎨 简洁清爽的用户界面 ## 默认账号 - 用户名：admin - 密码：admin **⚠️ 安全提示：** 首次登录后请立即修改默认密码！ ## 使用方法 1. 使用默认账号登录系统 2. 修改默认密码确保安全 3. 添加你的邮件账户（IMAP/SMTP） 4. 开始管理你的邮件 **⚠️ 重要提醒：保存配置！** - 在 Cypht 中修改任何设置后，**必须点击页面底部的 "Save" 按钮**保存配置！ - 如果不点击保存就离开页面，所有更改都会丢失 - 包括：添加邮箱账号、修改密码、调整显示设置等 - 保存成功后会显示 "Settings saved" 提示 ## OAuth2 配置说明 如需使用 Gmail 或 Outlook.com/Office 365 的 OAuth2 认证，需要： 1. 在对应平台注册应用获取 Client ID 和 Client Secret 2. 配置环境变量中的 OAuth2 相关参数 3. 设置正确的回调地址 **⚠️ Gmail 重要提示：** 使用 Gmail OAuth2 时，**需要确保 LazyCAT 平台能够访问 Google 服务**： - 如果 LazyCAT 部署在中国大陆等地区，可能无法直接访问 Google 服务 - 需要配置代理或使用其他方式确保能够连接到 Google API - 否则会导致 OAuth2 认证失败，无法添加 Gmail 账号 **⚠️ Outlook 重要提示：** 使用 Outlook/Office 365 OAuth2 时，**必须**在 Azure Portal 中配置以下权限： - ⭐ `offline_access`（必需）- 用于获取 Refresh Token，否则会在1小时后无法认证 - ⭐ `IMAP.AccessAsUser.All`（必需）- 通过 IMAP 访问邮箱 - `SMTP.Send`（可选）- 发送邮件 **缺少 offline_access 权限会导致：** - ✅ 初次添加账号成功 - ❌ 过1小时后 Access Token 过期，无法刷新，出现认证错误 - ❌ 频繁显示 "Could not authenticate to the selected IMAP server" **添加权限后，必须删除并重新添加邮箱账号，否则新权限不会生效！** **配置文档：** - Gmail OAuth2: https://www.cypht.org/cypht-enable-gmail-oauth/ - Outlook/Office 365 OAuth2: https://www.cypht.org/cypht-enable-outlook-and-office365-oauth/