Sessy — Amazon SES observability

Sessy

由 Marc Köhlbrugge 打造的 AWS SES 开源邮件可观测性工具。

什么是 Sessy？

Amazon SES 是一项出色的邮件服务：经济实惠、可靠，送达率也很高。但要了解邮件的实际情况，却令人十分头疼。

因此，许多人转而使用价格过高的邮件服务，而这些服务往往只是披着精美界面的 SES 包装器。结果，你为本可以自己实现的功能付出了高昂费用。

Sessy 是开源替代方案。使用原始 SES，同时享有精美界面，在点击发送后查看邮件的情况：送达、退信、投诉、打开、点击等。

运行自己的 Sessy 实例

运行 Sessy 最简单的方法是使用 Docker：

docker run -p 80:80 \
  -e SECRET_KEY_BASE=$(openssl rand -hex 64) \
  -e DISABLE_SSL=true \
  -v sessy:/rails/storage \
  ghcr.io/marckohlbrugge/sessy:main

完整配置选项请参阅 Docker 部署文档。

想部署自己修改过的版本？请参阅 Kamal 部署文档，了解如何从 fork 部署。

使用 Dokku？请参阅 Dokku 部署文档。

需要帮助配置 AWS SES 本身？请参阅 AWS SES 设置指南。

加固建议请参阅 SES 安全与送达率最佳实践。

面向 AI Agent 的 MCP 服务

Sessy 在 /mcp 提供 MCP 服务，因此 AI 编码 Agent（Claude Code、Cursor、Codex）可以查询你的邮件数据：搜索事件、查看邮件的完整送达时间线及退信诊断，并获取汇总统计数据。Agent 还可以创建和重命名来源，并获取 SES 接线详情（webhook URL、配置集和主题名称），以端到端地设置新应用。邮件数据为只读；保留设置和删除来源仍需在 Web 界面中操作。

在 Web 界面的 API keys 页面创建 API 密钥，然后按照你的实例上 /docs/mcp 中的连接说明操作。例如，使用 Claude Code：

claude mcp add --transport http sessy https://your-sessy-host/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

有两点值得注意：

• **Cloudflare / CDN 用户：**机器人防护（托管质询）会阻止 MCP 客户端。请将 /mcp 路径从机器人防护中排除，否则 Agent 请求会失败。
• HTTP Basic 认证：/mcp 仅使用 API 密钥进行认证，并忽略 HTTP_AUTH_*。之后启用 HTTP Basic 不会撤销之前创建的 API 密钥——锁定安装后，请检查 API keys 页面。

托管版本

我们正在开发 Sessy 的托管版本，供不想运行自己实例的用户使用。

你会在此代码库中看到相关内容：saas/ 目录、Gemfile.saas，以及偶尔出现的 Sessy.saas? 检查。这些内容为托管版本提供支持。为了简化维护，我们有意将其保留在此代码库中，而非维护单独的仓库。这些内容不会影响自托管：默认依赖包会完全忽略 saas/ 引擎，测试套件也会验证开源版本在没有它的情况下行为完全一致。

作业仪表板

Sessy 使用 Solid Queue 处理后台作业。你可以通过 /jobs 访问 Web 仪表板，监控队列、重试失败的作业并查看定期任务。

开发

欢迎按照自己的喜好修改 Sessy。

开始使用：

bin/setup
bin/dev

贡献

欢迎贡献！由于项目仍处于非常早期的阶段，请注意以下事项：

• **错别字和明显的错误：**欢迎直接提交 PR。
• **代码更改：**请尽量遵循我们现有的风格。
• **新功能：**请先提出 issue 讨论，再开始实现。
• **部署文档：**我们的第一方部署文档聚焦于广泛适用、开放且可自托管的部署方式，并且是我们正在积极使用的方式（例如 Docker、Kamal 和 Dokku）。通常我们不会在此仓库中添加特定于某个服务提供商的部署指南。

除了小型修复之外，请先提出 issue，避免有人花时间实现我们可能不会合并的内容。

许可证

Sessy 根据 O'Saasy License 发布，但子目录另有说明的情况除外（例如，Claude 和 Cursor 插件包采用 MIT 许可证）。

灵感来源

Sessy 深受 Fizzy 启发，我们感谢 37signals 将其代码库开源。