1186258278/QingChenMail 开源项目中文解读：技术栈、适用场景与上手建议

项目介绍

1186258278/QingChenMail 是一个托管在 GitHub 上的开源项目，主要使用 HTML 编写，采用 MIT License 许可证，目前获得 34 个 Star、11 次 Fork。

仓库全名: 1186258278/QingChenMail

README 摘要

完整内容见 GitHub 原始 README 或本页。

常见问题

QingChenMail 用什么语言开发？

主要使用 HTML 编写，采用 MIT License 许可证，目前有 34 个 Star。

QingChenMail 可以免费商用吗？

如何获取 QingChenMail 的源码？

可以直接克隆仓库：git clone https://github.com/1186258278/QingChenMail.git，默认分支为 main；安装与运行步骤见仓库 README。

QingChenMail 最近还在维护吗？

仓库最近一次更新为 8月15日，当前没有未关闭的 Issue；Star 数为 34，可作为社区活跃度的参考。

关于

企业级自建邮件营销解决方案。支持直连投递、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.

edm email-marketing golang marketing-automation self-hosted smtp-server vue

MIT License
34 Stars
11 Forks
1 Watching

描述取自 GitHub 官方 API，中文内容由 GitRead 中文社区编辑团队整理。

简要分析

热度分

价值分

活跃状态

活跃

GitHub

语言占比

Batchfile

HTML

JavaScript

Makefile

Release

v1.3.98月15日
v1.3.88月15日
v1.3.78月15日
v1.3.68月15日
v1.3.42月7日

贡献者

1186258278

晴辰云邮

晴辰云邮 QingChen Mail

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

中文 · 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 提示词
在线更新: 一键检查/下载/安装新版本
热重启: 更新后自动重启，无需人工干预

🖼️ 系统预览

仪表盘	营销任务
联系人管理	邮件模板
域名配置	收件箱

📸 查看更多截图

发送通道	密钥管理

发送日志	系统设置

🚀 快速开始

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": "[email protected]",
    "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:[email protected]"

🏗️ 技术架构

┌─────────────────────────────────────────────────────────────┐
│                      晴辰云邮 架构图                          │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐  │
│  │  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！

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

详见贡献指南

📄 开源协议

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

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

暂无评论

QingChenMail