晴辰云邮

v1.2.4

企业级自建邮件营销解决方案。支持直连投递、SMTP 中继、自动 DKIM/SPF 签名、子域名隔离及全可视化管理面板。昂贵 EDM 服务的完美替代品。Enterprise-grade Self-hosted Email Marketing Solution. Direct Send, SMTP Relay, Auto DKIM/SPF, Subdomain Isolation, and Visual Management Dashboard. Perfect replacement for expensive EDM services.

9 Stars
0 Forks
🌟 开源产品 Category
Open Website

Documentation

晴辰云邮

晴辰云邮 QingChen Mail

🚀 企业级自建邮件系统 · 发送/接收/营销一站式解决方案

Release License Go Build Website

中文 · English · 部署指南 · 下载

💡 为什么选择晴辰云邮？

痛点 传统方案 晴辰云邮
成本 第三方 EDM 按量计费，邮件越多越贵 一次部署，永久免费
隐私 邮件内容经第三方服务器，存在泄露风险 数据 100% 自有掌控
灵活性 API 受限，无法定制 开源可改，RESTful API 全开放
送达率 共享 IP 易被标记垃圾 独立 IP + DKIM/SPF/DMARC 自动配置

✨ 核心能力

📤 智能发信引擎

  • 双模式投递: 直连发送 + SMTP 中继智能切换
  • 高送达率: 自动 DKIM 签名 + SPF/DMARC 记录生成
  • 子域名隔离: 营销邮件与事务邮件分离，保护主域信誉
  • 异步队列: 内置高性能队列，支持失败重试与并发控制
  • 营销任务: 支持暂停/恢复、实时进度追踪、打开率统计

📥 邮件网关

  • SMTP 收信: 内置 SMTP Server，接收域名邮箱邮件
  • STARTTLS 加密: 支持 TLS 加密传输，防窃听
  • 智能转发: 通配符/前缀匹配，自动转发至 Gmail/QQ
  • MIME 解析: 自动解码 Base64/QP，支持中文无乱码
  • 附件处理: 自动提取保存，支持在线预览

🛡️ 安全防护

  • 两步验证 (2FA): TOTP 动态口令，Google/Microsoft Authenticator 兼容
  • 速率限制: IP 级连接限制，防 DDoS/暴力攻击
  • IP 黑名单: 一键封禁恶意 IP
  • JWT 认证: 安全 Token + API Key 双重验证
  • 密码加密: bcrypt 哈希存储
  • HTTPS 支持: 全站 SSL 加密
  • 证书管理: Let's Encrypt 自动申请/续期，支持手动上传
  • 自动备份: 更新前自动备份，支持一键回滚

🔧 开发者友好

  • RESTful API: 标准接口，支持 Bearer Token
  • 永久密钥: sk_live_... 格式，集成方便
  • 模板引擎: {{.name}} 变量替换，千人千面
  • Webhook 回调: 发送状态实时推送
  • 交互式文档: 内置 API 文档 + AI 提示词
  • 在线更新: 一键检查/下载/安装新版本
  • 热重启: 更新后自动重启，无需人工干预

🖼️ 系统预览

仪表盘
 营销任务
联系人管理
 邮件模板
域名配置
 收件箱
📸 查看更多截图
发送通道 密钥管理
SMTP Keys
发送日志 系统设置
Logs Settings

🚀 快速开始

1️⃣ 下载运行

# 从 Releases 下载对应平台二进制文件
# https://github.com/1186258278/QingChenMail/releases

# Linux/macOS
chmod +x goemail && ./goemail

# Windows
goemail.exe

2️⃣ 访问后台

浏览器打开 http://localhost:9901

项目 值
默认账号 admin
默认密码 123456

⚠️ 首次登录后请立即修改密码，并建议开启两步验证 (2FA)！

命令行参数

# 重置管理员密码为 123456
./goemail -reset

# 重置管理员两步验证 (忘记 2FA 时使用)
./goemail -reset-totp

3️⃣ 发送第一封邮件

curl -X POST http://localhost:9901/api/v1/send \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "test@example.com",
    "subject": "Hello from QingChen Mail",
    "body": "<h1>欢迎使用晴辰云邮！</h1>"
  }'

📦 功能清单

模块 功能 状态
发送中心 单封/批量发送、附件支持、HTML 模板 ✅
营销任务 定时发送、暂停恢复、进度追踪、统计分析 ✅
联系人 分组管理、导入导出、退订管理 ✅
收件箱 SMTP 收信、MIME 解析、附件提取、批量操作 ✅
转发规则 精确/前缀/通配符匹配、多目标转发 ✅
域名管理 多域名支持、DKIM 自动生成、DNS 验证 ✅
发送通道 SMTP 中继配置、直连发送、负载均衡 ✅
安全防护 2FA 两步验证、STARTTLS、速率限制、IP 黑名单 ✅
证书管理 Let's Encrypt 自动申请、手动上传、自动续期 ✅
数据清理 自动定时清理、保留策略配置、手动清理 ✅
系统设置 HTTPS、端口配置、备份恢复 ✅
API RESTful 接口、永久密钥、交互文档 ✅

⚙️ 配置说明

📝 config.json 示例 
{
  "domain": "mail.example.com",
  "host": "0.0.0.0",
  "port": "9901",
  "base_url": "https://mail.example.com",
  "enable_ssl": false,
  "enable_receiver": true,
  "receiver_port": "25",
  "receiver_tls": true,
  "receiver_rate_limit": 30,
  "receiver_max_msg_size": 10240,
  "cleanup_enabled": true,
  "cleanup_email_log_days": 30,
  "cleanup_inbox_days": 30
}
🔐 DNS 记录配置 
# MX 记录 (收件)
@    MX    10    mail.example.com.

# SPF 记录 (发件验证)
@    TXT   "v=spf1 ip4:YOUR_SERVER_IP ~all"

# DKIM 记录 (签名验证)
default._domainkey    TXT    "v=DKIM1; k=rsa; p=YOUR_PUBLIC_KEY"

# DMARC 记录 (策略)
_dmarc    TXT    "v=DMARC1; p=quarantine; rua=mailto:admin@example.com"

🏗️ 技术架构

┌─────────────────────────────────────────────────────────────┐
│                      晴辰云邮 架构图                          │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐  │
│  │  Web UI │    │   API   │    │  SMTP   │    │  Queue  │  │
│  │ (HTML5) │    │  (Gin)  │    │ Server  │    │ Worker  │  │
│  └────┬────┘    └────┬────┘    └────┬────┘    └────┬────┘  │
│       │              │              │              │        │
│       └──────────────┴──────────────┴──────────────┘        │
│                          │                                   │
│                    ┌─────┴─────┐                            │
│                    │   GORM    │                            │
│                    │  SQLite   │                            │
│                    └───────────┘                            │
└─────────────────────────────────────────────────────────────┘
层级 技术选型
后端 Go 1.21+ · Gin · GORM · SQLite
前端 HTML5 · TailwindCSS · Chart.js
邮件 go-mail · go-msgauth (DKIM) · STARTTLS
安全 bcrypt · JWT · TOTP (2FA) · Rate Limiter
证书 ACME · Let's Encrypt · lego

🤝 参与贡献

欢迎提交 Issue 和 Pull Request！

  1. Fork 本仓库
  2. 创建特性分支: git checkout -b feature/amazing-feature
  3. 提交更改: git commit -m 'feat: add amazing feature'
  4. 推送分支: git push origin feature/amazing-feature
  5. 提交 PR

详见 贡献指南

📄 开源协议

本项目采用 MIT License 许可证，可免费商用。

© 2026 武汉晴辰天下网络科技有限公司
官网 · 反馈 · 文档

如果这个项目对您有帮助，请给一个 ⭐ Star 支持一下！