SkimMail 能做什么
邮件分散在一个个人 Gmail、一个工作 Outlook 和自有域名下的几个邮箱之 间,意味着每天要打开好几个应用好几次,还是会漏看。SkimMail 独立连 接每一个邮箱,汇总呈现为一个收件箱,并配有本地缓存,让阅读始终保持 快速,无论每家服务商是否支持相同的协议扩展。
它只读取,不发送。
SkimMail 内没有任何地方存在撰写窗口或 SMTP 连接 ——它无法发送邮件,甚至连一封发给自己的测试邮件都不能。添加一个 账户只是打开一个连接并列出邮箱,这就是全部的测试内容。归档、删 除和移动通过 IMAP 作用在邮箱上;删除会把邮件移到该账户 自己的"已删除邮件"文件夹,SkimMail 从不永久删除一封邮件。
所有邮箱汇于一处列表
任何 IMAP 服务器,加上用 Google 或 Microsoft 登录的 Gmail 与 Outlook。把账户归入有名字的分组,也可以只看某一个分组。新邮件通过 IMAP IDLE 实时到达,IDLE 掉线时有轮询作为后备。
为高效处理而生
全程键盘快捷键、专注模式、命令面板、拆分收件箱的 bundle、稍后处理、置顶、跨账户加星标、多选批量操作、归档/删除/移动可撤销,以及对支持该功能的发件人一键退订。
搜索始终留在本机
每个主题和发件人地址的本地索引即时应答,永远不会离开你的服务器。邮件正文刻意不建索引。第二层可以直接询问某个邮件服务器,从而搜到超出你同步窗口的旧邮件。
远程内容默认保持屏蔽
邮件里的任何内容在你主动请求之前都不会加载。当你请求时,服务器会通过该账户自己的网络路径去取图片,再在本地提供——你的浏览器从不直接联系发件人的主机,所以一枚追踪像素学不到关于你的任何信息。
每个账户各走各的出口
每个账户可以通过自己的 SOCKS5 代理、HTTP 代理、内置 WireGuard 隧道,或你自己部署的 relay 单独出网。每次连接都会报告它实际使用的公网 IP,并在两个本应彼此隔离的连接却来自同一地址时发出警告。
Rules、告警与通知
按发件人、主题、账户、分组匹配——或者"看起来像一次性验证码"——然后打标签、弹出提示、推送,或发送到 webhook、Telegram、Slack、Discord、Teams 或 Google Chat。一个持续失败的账户会自行停止并通知你。
只有真正运营起来之后才会注意到的部分
账户凭据、OAuth token、双重验证密钥和代理 URL 都以 AES-256-GCM 静 态加密(encrypted at rest),基于一个从不离开实例的主密钥。多用户 实例让每个人拥有自己的账户和邮件,对其他所有人不可见,无论角色是 owner、operator 还是 viewer。备份是加密快照,可以还原到任何 SkimMail 服务器上,即便是使用不同数据库的服务器。邮件缓存可以放 在本地文件系统,也可以放在任何兼容 S3 的存储桶,带有容量上限、保 留期限和手动清理。SQLite 是默认数据库;PostgreSQL 和 MySQL 已编 译进同一个构建,MySQL 仍处于实验阶段。以上全部内容都逐页记录在 wiki 中。
运行它
唯一的前提是有地方能跑一个容器——SQLite 已经内置,没有任何外部服 务需要先搭建。
docker run -d --name skimmail -p 8080:8080 \
-v skimmail-data:/data -e AUTH_MODE=passphrase \
ghcr.io/lyquyduong/skimmail:latest
然后打开 http://localhost:8080。在允许任何人创建任何
内容之前,SkimMail 会要求输入首次启动时打印出的一次性
claim code——正是它挡住了谁先碰到端口谁就能占有你的实例:
docker logs skimmail 2>&1 | grep 'claim code'
此外还有一个 Docker Compose 文件、一个把它安装为 systemd 服务的 面向 Ubuntu 与 Debian 的 apt 仓库,以及适用于 Linux 和 macOS(amd64 与 arm64)的已签名二进制文件。完整的安装矩 阵、配置参考和升级说明都在 wiki ▸ Installation;发布版本和校验和在 GitHub 上。
接下来添加一个邮箱:主机、端口 993、TLS,以及一个应
用专用密码——或者用 Google 或 Microsoft 登录,这部分内容见下文。
并不存在所谓的 SkimMail 服务
这是最容易被误解的部分,所以放在细节之前先说清楚: SkimMail 是你安装的软件,不是任何人注册的服务。 没有 SkimMail 账户,没有持有你邮件的 SkimMail 服务器,也没有由其 发布者运营的托管版本。LyQuyDuong 发布一个程序,不运行任何东西。
你——或管理你所用机器的任何人——下载一个二进制文件或容器镜像,运 行它,然后把你自己的邮箱连接进去。软件读取到的一切都进入你配置的 数据库和文件,运行在你控制的基础设施上。它不发送任何遥 测、分析或崩溃报告,也没有任何代码路径会把你的账户、邮件 或设置发给 LyQuyDuong。
你的实例确实会发起对外连接,而其中每一个要么是你自己打开的开关, 要么是下载一个公开文件。它会同步你的邮件服务器;如果你配置了 OAuth 登录,它会刷新与 Google 或 Microsoft 的登录状态;当你要求 时,它会加载一张远程图片或跟随一个退订链接;如果你设置了通知渠 道、备份目的地或 AI provider,它会向那里发送内容;它会检查 GitHub 是否有新版本,并按同样的节奏拉取已签名的插件索引和已签名 的许可证吊销列表,这三者都只在你打开更新检查后才会发生;如果你安 装了某个插件,它会从该插件的供应商那里下载;只有当有人按下那个按 钮时,它才会去问一个 IP 回显服务某个出口用的是哪个公网地址。 隐私政策(英文)完整列出了这一 切,全部集中在一处,因为这样的说法如果无法被核实就没有多少 价值。
对数据保护的后果在隐私政策(英文) 中说得很清楚:每个安装实例的运营者是其中邮件的数据控制者,而 SkimMail 的发布者既不是控制者也不是处理者,因为其中任何一部分 都从未被接收过。
连接一个 Gmail 或 Outlook 邮箱
一个邮箱可以用两种凭据之一连接:一个应用专用密码 ——服务商颁发的仅用于 IMAP 的第二个密码——或者通过 OAuth 2.0 用 Google 或 Microsoft 登录。
SkimMail 不附带自己的 OAuth 客户端
如果你选择 OAuth 这条路,你需要注册自己的应用
到 Google 或 Microsoft,并把它的 client ID 和 secret 粘贴进你的
实例。没有 SkimMail 共用的 client ID,这是刻意为之而不是没做
完:https://mail.google.com/ 是一个受限 scope,绑
定在申请它的应用的所有者身上,而发布在源码仓库里的 client
secret 一旦被吊销就会同时弄坏所有安装实例。Thunderbird、
Roundcube 和 Nextcloud Mail 也采用同样的"自带应用"方式。
因此,每个安装实例的授权同意页面、其授权域名和验证状态都属于 该实例的运营者。登录交换直接在该运营者的服务器与 Google 或 Microsoft 之间进行,之后的 token 刷新也同样如此。没有 任何 token、code 或消息会经过 SkimMail 发布者运行的任何东西,因 为根本不存在这样的服务器。
对 Gmail 来说,OAuth 通常不是最短路径
应用专用密码只需两次点击,不需要 Google Cloud 项目,也能直接从 Google 账户自己的安全设置里撤销。当 Workspace 管理员已经禁用应 用专用密码,或者你不想存一个能打开整个账户的密码时,OAuth 的搭 建成本才值得。对于个人的 Outlook.com、Hotmail 和 Live.com 地址,这根本无需权衡:Microsoft 不为它们颁发 应用专用密码,也已经关闭了基本身份验证,所以 OAuth 是唯一的路。 具体怎么选,见: wiki ▸ Gmail or Outlook sign-in。
实际被观察到可用的情况
项目对此说得很精确,而不是用市场宣传的口吻,因为"支持"和"被观察 到可用"是两个不同的断言,只有其中一个是证据。
| 服务商 | 状态 |
|---|---|
| Gmail | 已于 2026-09-17 用真实的 Google Cloud 客户端和真实邮箱端到端验证:文件夹已列出,邮件已同步,此后还观察到一次 token 续期。 |
| Outlook——个人账户 | 于 2026-09-18 首次连接:一个真实的应用注册,列出了十三个文件夹,邮件已同步,并且观察到了第一次 token 续期顺利完成。这次续期很关键,因为 Microsoft 每次续期都会替换掉已保存的登录状态。除最初几个小时之外,尚未观察更长时间。 |
| Microsoft 365 工作或学校账户 | 未测试。 这是不同的应用注册,管理员可以直接封锁该应用。这条路径目前只是文档,不是实际经验。 |
| 任何其他 IMAP 服务器 | 用该服务器颁发的任意凭据连接。SkimMail 的 OAuth 支持仅覆盖 Google 与 Microsoft。 |
如果你连接了一个 Microsoft 邮箱,无论结果如何都请告诉我们—— skimmail@base101.app。
为什么 Google 登录会请求完整的邮箱访问权限
如果你是从授权同意页面来到这里的
这里是正在请求读取你邮箱的应用的主页:SkimMail, 由 LyQuyDuong 发布——一个自托管的邮件阅读器。它运行在设置该实例 的人所运营的服务器上,而不是我们的任何服务器上,因为我们不运营 任何服务器。它拿到这些权限之后会做什么,下文以及 隐私政策(英文)中都有完整说 明。
当运营者连接一个 Gmail 邮箱时,授权同意页面会请求"读取、撰写、发
送并永久删除你 Gmail 中的所有邮件"。这是 Google 为
https://mail.google.com/ 这个 scope 附加的措辞,它
比 SkimMail 实际用它做的事情要宽泛得多。之所以仍然要请求它,原
因是技术性的:
-
SkimMail 的同步引擎说的是 IMAP。 它通过
XOAUTH2 向
imap.gmail.com进行身份验证,和任何 IMAP 客户端一样。 -
Google 只通过这一个 scope 授予 IMAP 访问权限。
https://mail.google.com/是 Google 为 IMAP、POP 和 SMTP 记录在案的 scope。那些听起来更窄的 scope 授予的其实是 Gmail REST API:一个为gmail.modify签发的 token 完全有效,但imap.gmail.com会直接拒绝它。 - 所以并不存在更窄的可请求 scope。 请求一个更 窄的 scope 并不会减少被授予的权限;只会让邮箱完全无法同步。 授权范围的宽泛程度是 Google 对 IMAP 访问所隐含内容的分类,而 不是对 SkimMail 实际所做之事的描述。
Google 登录请求的全部内容
| Scope | 用途 |
|---|---|
https://mail.google.com/ |
通过 IMAP 连接到 imap.gmail.com,用于列出文件夹、获取邮件头和正文,并执行你在界面上做的操作:已读/未读、加星标、归档,以及在文件夹之间移动邮件。"删除"会把邮件移到该账户的"已删除邮件"。它绝不发送邮件。 |
userinfo.email |
读取刚刚被授权的邮箱地址,以便实例正确标注该账户,并在之后重新授权时匹配到同一个账户而不是创建重复项。 |
openid |
标准的 OpenID Connect 登录,与上面的地址一起使用。 |
Microsoft 一侧的对应项是
https://outlook.office.com/IMAP.AccessAsUser.All
——一个 Outlook 资源 scope 而非 Microsoft Graph scope,因为一个
token 只能承载一个 audience——再加上 offline_access,
正是它让登录状态能够自我续期。
它绝不会用这项权限做的事
- 它绝不发送邮件。 没有撰写窗口,没有 SMTP。
- 它绝不永久删除一封邮件。 删除意味着移入"已删除邮件"。
- 它绝不会把你的邮件转交给 LyQuyDuong——不存在能这样做的代码路径,也没有服务器去接收。
- 它绝不用于广告、广告定向或用户画像,也绝不出售。
- 它绝不会用来训练 LyQuyDuong 名下的模型,原因和它从不会到达这里一样。
SkimMail 对从 Google API 获取的信息的使用,遵循 Google API Services User Data Policy,包括其中的 Limited Use 要求。 按 scope 逐条给出的完整说明见 隐私政策(英文)第 2 节。
如果你是正在注册该应用的运营者,请注意 Google 会要求你的项目提供一个主页、一份隐私政策和一份服务条 款,都在你控制并验证的域名下。这些页面描述的是软件本 身,方便你据此写出内容准确的自己的页面;请自行调整而不要直接照 搬。分步说明见 wiki ▸ Register the OAuth application。
可选的 AI 功能,明说而不是藏起来
SkimMail 包含可选的 AI 功能——总结一封邮件或一个线程、分类、翻 译、提取待办事项、生成摘要——它们会把邮件内容发送给你选 择并配置的推理服务。它们已经实现,并存在于包括当前版本 在内的每一个发布版本中,只是当前界面上的按钮被隐藏了。
在你配置好 provider 之前,不会向任何地方发送任何内 容。 在没有设置 provider 和 API key 的情况下,这些端点 全部返回错误,没有任何邮件内容离开你的服务器;默认安装什么都不 会发送。支持 Anthropic、OpenAI 和 Google Gemini,也支持 Ollama——它可以运行在你自己的硬件上,什么都不 发给任何人。LyQuyDuong 不选择其中任何一个,与它们中的任何一个 都没有关系,无论哪种情况都不会收到任何东西。
有一条路径会在没有人按任何按钮的情况下自行运行——对新到达的收件 箱邮件进行后台分类——它位于两个各自独立的开关之后,两者默认都是 关闭的。所有这些内容,包括隐私政策早期版本对此的错误说法,都在 隐私政策(英文)第 6 节中说明。之 所以把它放在首页而不只是放在那里,是因为一个会把你的邮件发送到 别处的功能,不应该是你在第六页才发现的事。
许可证、分级与联系方式
SkimMail 的源码以 Business Source License 1.1 发布。它今天还不是一个 Open Source 许可证:你 可以复制、修改和运行它,包括在商业组织内部使用,但你不能以托管 或嵌入的方式将它提供给第三方,与它构成竞争。到 2030-07-23,同一份代码将转为 GNU Affero General Public License v3.0 or later。 完 整文本和服务条款(英文)都值得在你 将它部署到重要场景之前读一读。
Community Edition 免费,不需要许可证密钥——十 个邮箱、三个网络连接和两个账户分组。Sponsor 和 Pro 密钥会提高这 些限制,并且完全离线验证:软件从不联系许可证 服务器,一个密钥过期或被吊销也绝不会移除你已经添加的任何内容, 只会阻止你继续添加。
问题、安全报告与商务咨询: skimmail@base101.app。