useSend - 开源邮件发送基础设施

useSend 是一个开源的邮件发送基础设施，作为 Resend、Sendgrid、Postmark 等商业邮件服务的开源替代品。它基于 Amazon SES 构建，提供可靠、低成本的邮件发送能力，并配有功能丰富的管理仪表盘。

项目简介

useSend 由 usesend 团队开发和维护，是一个现代化的开源邮件发送平台。该项目在 GitHub 上已获得超过 4,000 stars，采用 AGPL-3.0 许可证开源。目前项目处于 Beta 阶段，支持邮件发送功能，未来计划扩展至 SMS、推送通知和 WhatsApp 等发送协议。

核心特性

• 域名管理：支持添加和管理自定义域名
• 事务性邮件：发送密码重置、订单确认等事务性邮件
• 营销邮件：批量发送新闻通讯、产品更新等营销内容
• REST API：提供完整的 RESTful API 接口
• SMTP 支持：兼容 SMTP 协议，方便集成现有系统
• 数据仪表盘：实时追踪邮件送达、打开、点击和退信数据
• 定时发送：支持邮件定时发送 API
• Webhook 支持：提供 webhook 事件通知（即将推出）
• 联系人管理：管理订阅者列表，自动处理订阅/退订

技术栈

useSend 采用现代化的全栈技术架构：

邮件编辑器

useSend 内置强大的可视化邮件编辑器，基于以下技术构建：

• tiptap - 编辑器核心框架
• maily.to - 编辑器设计灵感来源
• jsx-email - 将编辑器内容转换为 HTML

安装指南

使用 Docker 部署（推荐）

useSend 提供官方 Docker 镜像，支持 DockerHub 和 GitHub Container Registry：

# 从 DockerHub 拉取
docker pull usesend/usesend

# 或从 GitHub Container Registry 拉取
docker pull ghcr.io/usesend/usesend

详细配置请参考 Docker 部署文档。

使用 Railway 一键部署

Railway 提供最简单的部署方式：

详细指南：Railway 部署文档

本地开发环境

1. 克隆仓库

git clone https://github.com/usesend/useSend.git
cd useSend

2. 安装依赖

pnpm install

3. 配置环境变量

cp .env.example .env
# 编辑 .env 文件，配置数据库、Redis、AWS 等连接信息

4. 启动开发服务器

pnpm dev

详细本地开发指南：https://docs.usesend.com/get-started/local

使用示例

发送邮件 API

curl -X POST https://api.usesend.com/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "subject": "Hello from useSend",
    "html": "<h1>Welcome!</h1><p>This is a test email.</p>"
  }'

SMTP 配置

Host: smtp.usesend.com
Port: 587 (STARTTLS) 或 465 (SSL/TLS)
Username: your-api-key
Password: your-api-secret

自托管指南

useSend 支持完全自托管，您可以在自己的基础设施上运行：

1. 系统要求：

   • Node.js 18+
   • PostgreSQL 数据库
   • Redis 服务器
   • AWS SES 账户（用于发送邮件）

2. 环境变量配置：

   • 数据库连接字符串
   • Redis 连接信息
   • AWS SES 凭证
   • 其他可选配置

详细自托管文档：https://docs.usesend.com/self-hosting/overview

项目链接

• GitHub 仓库：https://github.com/usesend/useSend
• 官方网站：https://usesend.com
• 官方文档：https://docs.usesend.com
• Docker Hub：https://hub.docker.com/r/usesend/usesend
• Discord 社区：https://discord.gg/BU8n8pJv8S

许可证

useSend 采用 AGPL-3.0 开源许可证。