billionmail

项目地址： https://github.com/Billionmail/BillionMail

官网： https://www.billionmail.com/

官方文档： https://docs.billionmail.com/

许可证： AGPL-3.0（社区版）

包管理器： Docker Compose（docker compose up -d）/ 一键脚本 bash install.sh（最新 v4.9，截至 2026-10）

版本： v4.9（2025-12-11）

概述

BillionMail 主要能力：

• 多域名邮件服务器（Postfix + Dovecot）
• 批量营销发送：分批限速、退订链接、SPF/DKIM/DMARC
• 模板编辑器：拖拽 + 富文本 + 变量
• 订阅者管理：分组、标签、导入/导出、退订列表
• 触发邮件：API / Webhook 触发事务邮件
• 送达率分析：点击/打开/退信/退订统计
• WebMail：自带网页邮箱
• 多用户 / 多租户

BillionMail 由宝塔面板团队（aaPanel）出品，强调开箱即用、面板化运维。

---

安装部署

Docker Compose（推荐）

git clone https://github.com/Billionmail/BillionMail
cd BillionMail
cp env_init .env
# 编辑 .env：DOMAIN、DB 密码、MX/SMTP 配置等
docker compose up -d

一键脚本

cd /opt && git clone https://github.com/Billionmail/BillionMail && cd BillionMail && bash install.sh

端口要求

端口	服务
25 / 587 / 465	SMTP
143 / 993	IMAP
110 / 995	POP3（可选）
80 / 443	Web 控制台 + WebMail

多数云厂商默认封锁 25/587 端口，需提交工单解封；建议使用海外 VPS 或专用邮件 IP。

---

DNS 配置

为发件域 mail.example.com 配置：

类型	主机	值
A	mail	<服务器 IP>
MX	@	mail.example.com
TXT	@	v=spf1 mx ip4:<IP> ~all
TXT	default._domainkey	v=DKIM1;k=rsa;p=...（管理后台生成）
TXT	_dmarc	v=DMARC1;p=quarantine;rua=mailto:...
PTR		mail.example.com（联系机房设置反向解析）

---

控制台

访问 https://your-server/：

• 域名管理：添加发件域、生成 DKIM
• 邮箱账户：创建邮箱、配额、SMTP/IMAP 密码
• 订阅者：分组、字段、批量导入 CSV
• 模板：邮件模板（HTML + 变量）
• 任务：发送任务（即时 / 计划）
• 统计：到达率、打开、点击、退订、退信
• 设置：SMTP/反垃圾/限速/IP 池

---

创建发送任务

1. 设置「发件人」「主题」
2. 选择模板或新建（变量：{{name}}、{{unsubscribe_url}}）
3. 选择订阅者分组（可定向标签）
4. 限速（每分钟 N 封 / 每小时 N 封）
5. 开始或计划发送

发送过程中实时显示成功/失败/退信。

---

API（事务邮件）

端点与字段以你部署的版本为准（各版本路径有调整）：先用 curl -s http://your-server/api/ 或控制台的「API / 文档」入口确认实际路径，再照下面形态调用。

curl -X POST https://your-server/api/v1/mail/send \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": "[email protected]",
    "to":   ["[email protected]"],
    "subject": "欢迎注册",
    "template_id": 12,
    "variables": { "name": "张三" }
  }'