Swanmail

快速开始 ​

Swanmail 是一款适用于 macOS、Windows 和 Linux 的桌面邮件客户端：Go 编写的后端，在系统自带 WebView 中显示的 React 界面，以及本地 SQLite 数据库。无遥测、支持 AI。

下载与安装 ​

Swanmail 可在 macOS 11 或更高版本（发布版本为 Apple 芯片构建）、装有 Microsoft Edge WebView2 运行时的 64 位 Windows 10 和 11（Windows 11 自带；缺少时安装程序会安装），以及带有 GTK 4 和 WebKitGTK 6.0 的 Linux（Debian 13、Ubuntu 26.04 或更新版本）上运行。

发布版本可在 swanmail.app/download 下载：

平台下载
macOS（Apple 芯片）.dmg
Windows（x64）Swanmail-<版本>-windows-x64-setup.exe
Linux（x86-64）.deb、Arch 软件包（.pkg.tar.zst）或 .tar.gz

在 macOS 上，打开 .dmg 并把 Swanmail 拖入“应用程序”。应用未经公证，首次启动前请去掉一次隔离属性：

bash
xattr -dr com.apple.quarantine /Applications/Swanmail.app

在 Windows 上，运行安装程序即可。它只为当前账户安装 Swanmail，位置是 %LOCALAPPDATA%\Programs\Swanmail，不需要管理员权限；它会添加开始菜单项和 设置 → 应用 中的条目，并可把命令行工具 swanmail-cli 加入 PATH。安装程序没有代码签名，因此 Microsoft Defender SmartScreen 会提示发布者未知：选择 更多信息，再选择 仍要运行。之后 Swanmail 会自动保持更新：更新在后台下载，选择 重新启动以更新 时安装。

在 Linux 上，用包管理器安装软件包，或把 tarball 解压到 / 或 ~/.local。应用安装为 swanmail，命令行工具安装为 swanmail-cli。

Arch Linux ​

在 Arch Linux（包括 Omarchy）上，也可以添加 swanmail.app 的软件源，这样 Swanmail 会跟系统一起更新。先信任软件源的签名密钥（只需一次），再添加软件源并安装：

bash
curl -fsSO https://swanmail.app/arch/swanmail.asc
sudo pacman-key --add swanmail.asc
sudo pacman-key --lsign-key 8BD26B8D30E97BAA2E1A7061ED15FAAF27DEFEA3
printf '\n[swanmail]\nSigLevel = Required DatabaseOptional\nServer = https://swanmail.app/arch/$arch\n' | sudo tee -a /etc/pacman.conf
sudo pacman -Syu swanmail

之后运行 sudo pacman -Syu（或桌面自带的系统更新）就会装上每个新版本。pacman 会用这把密钥校验每个软件包，没有签名的包会被拒绝。有新版本时，设置 → 关于 和更新窗口会给出要运行的命令。

首次启动设置 ​

首次启动时，Swanmail 会显示带 添加账户 按钮的欢迎页；之后的账户在 设置 → 账户 中添加。Swanmail 支持：

  • Gmail，使用 使用 Google 登录
  • Outlook.com、Hotmail 和 Microsoft 365，使用 使用 Microsoft 登录（走 IMAP；组织关闭了 IMAP 时走 Microsoft Graph）
  • Yahoo，使用应用专用密码
  • Fastmail，使用 API token（通过 JMAP 同步和发送）或应用专用密码（IMAP 和 SMTP）
  • QQ 邮箱、腾讯企业邮和网易邮箱（163、126），使用授权码
  • 通用 IMAP/SMTP
  • POP3（仅收信），发信使用 SMTP
  • 通过 Exchange Web Services（EWS）连接的自建 Exchange Server

发布版本内置了 Google 和 Microsoft 的登录客户端，这两个按钮无需任何配置。自己构建的版本只有在构建时提供了客户端才有；否则，或者想使用自己的 OAuth 应用时，请通过应用的 config.json 提供 client ID（Google 还需要 secret）。登录页面在浏览器中打开。详情请见 账号 页面。

如果你不想使用 OAuth，也可以用 通用 IMAP/SMTP，输入邮箱密码或应用专用密码。

日常使用 ​

  • 阅读邮件：从侧边栏选择文件夹或邮箱。会话、远程图片、日历邀请、退订和邮件源代码见 阅读邮件。
  • 未读视图：从侧边栏选择 未读，可查看所有账户收件箱中的未读邮件；所有邮件和用户标签中的副本不会计入。打开邮件后会标记为已读（小蓝点消失），但邮件会保留在当前列表中，直到你离开未读视图，避免阅读时失去焦点。
  • 搜索：搜索栏对主题、正文和地址进行全文检索，支持 from:、has:attachment、before: 等操作符。除 POP3 外的所有账户类型，Swanmail 还会搜索服务器上尚未同步到本地的邮件。见 整理邮件。
  • 整理：文件夹、标签、规则、稍后提醒、会话免打扰与置顶、撤销，见 整理邮件。
  • 写信：别名、模板、内联图片、稍后发送和已读回执，见 写信。
  • AI 功能：在 设置 → AI 助手 中添加智能体后，可对邮件进行总结、翻译、分类或运行自定义过滤。
  • 加密：OpenPGP 在 设置 → GPG 加密（指南），S/MIME 在 设置 → S/MIME（指南）。
  • 键盘快捷键：随时按 ? 查看快捷键帮助。
  • 远程图片：图片默认被阻止。你可以只对当前邮件放行，也可以在邮件提示条中按发件人/域名放行；规则按账户保存在本地。
  • 菜单栏：菜单栏图标显示未读数，点击后打开包含 所有收件箱、各个账户、写邮件、设置… 和 退出 Swanmail 的菜单。见 阅读邮件。

通知 ​

开启 设置 → 常规 → 通知 → 新邮件通知 后，有新邮件时会显示桌面通知。可通过 通知声音 选项选择使用系统提示音或静音。开启通知后还会出现三个选项：

  • 通知按钮——单封邮件的通知提供 归档、标为已读 和 回复。macOS 会显示在横幅上（第一个直接显示，其余在“选项”里），Windows 显示在通知上；在 Linux 上，桌面的通知服务支持操作按钮时才会显示。在任何平台上点击通知都会打开邮件。
  • 免打扰时段——在你选择的日子里每天的一个时间段，不显示横幅、不发出声音。未读角标仍会累加，邮件仍会同步。时间段可以跨过午夜。
  • 重要发件人——邮箱地址，或写成 @example.com 的整个域名；来自它们的邮件即使在免打扰时段、即使账户被静音也会通知（你手动设为免打扰的会话仍保持安静）。仅通知重要发件人 会让其他所有人保持安静。可从邮件的 … 菜单或命令面板添加或移除；重要发件人的邮件在列表中带有一个小标记。