免费自建的邮件营销系统：Billion Mail 三步跑通 + 常见坑一次说清-开发者社区

免费自建的邮件营销系统：Billion Mail 三步跑通 + 常见坑一次说清

【免费下载链接】BillionMailBillionMail gives you open-source MailServer, NewsLetter, Email Marketing — fully self-hosted, dev-friendly, and free from monthly fees. Join the discord: https://discord.gg/asfXzBUhZr项目地址: https://gitcode.com/GitHub_Trending/bi/BillionMail

Billion Mail 是一个完全自托管的开源邮件营销平台：一套代码同时给你 SMTP 邮件服务器、新闻订阅页和批量发送系统，发信量、收件人名单和打开率数据全部留在自己的服务器上。它适合想摆脱第三方发信按量收费的团队、需要自建独立邮件基础设施的公司，以及愿意用 Docker 管理服务的开发者。

适合谁：先看这四个场景

正在被第三方平台按发送量收费或限制月发送额度的团队，自建后发送条数不再受外部配额约束。
要求营销数据不出企业内网的公司：联系人库、打开/点击统计都存在本地 PostgreSQL 中，没有第三方追踪。
需要发新闻订阅、促销邮件、事务通知等多种类型邮件的团队，模板可以复用，名单可以按分组标签筛选。
有开发人员参与、希望随时读源码做二次定制的团队，核心代码在 core/ 目录下可直接修改。

部署上手：一条命令组完成

1. 克隆仓库

把项目拉到服务器上，gitcode 镜像地址可直接使用：

git clone https://gitcode.com/GitHub_Trending/bi/BillionMail cd BillionMail

2. 准备环境变量

把模板文件env_init复制为.env，按需修改 SMTP/IMAP 端口、管理 HTTP/HTTPS 端口和管理路径即可，数据库与 Redis 密码模板已生成，一般无需手填。

3. 启动服务

docker compose up -d

整套系统（Postfix、Dovecot、rspamd、PostgreSQL、Redis 等）由 Docker Compose 一键拉起。

4. 访问管理界面

安装完成后，用bm default命令可查看默认账号信息；初始账号通常为billion/billion，入口地址形如https://你的服务器IP/billion（路径由.env中的 SafePath 决定，install.sh安装时会随机生成）。首次登录后第一件事就是改密码。

核心使用流程：从域名到发送

第一步：配置发信域名与品牌信息

在域名管理页（对应 core/api/domains/ 模块）填入你的发信域名，按提示在 DNS 服务商处添加记录后点验证。验证通过会自动启用免费 SSL。接着填写域名配额（GB）和邮箱数量上限，再点"立即创建"，系统会通过 AI 从该域名的网站自动提取品牌名、主色和内容结构，生成可直接用于邮件模板的品牌信息，之后可手动微调。

图：Billion Mail 域名配置页，底部可一键从域名网站导入品牌信息

第二步：接入 AI 模型（三步操作）

AI 能力用于写邮件文案和生成品牌信息，配置入口在设置里的 AI 模型页（对应 core/api/askai/ 模块）。平台预置 OpenAI、Gemini、Anthropic、DeepSeek、Kimi、Grok 等供应商：

在左侧供应商列表选中一家，打开顶部启用开关。
粘贴 API Key，点 Check 验证可用性。
如有自建网关可填 Base Url，点 Save API 保存，模型列表会自动拉取。

图：AI 模型配置页，填好 API Key 并保存后即可在模板编辑中调用

第三步：创建可复用的邮件模板

在模板编辑器中粘贴或撰写正文，接入的 AI 模型可以帮你改写文案、调整语气。品牌信息会自动带入配色与 Logo，保证同一域名下的邮件视觉一致。模板可命名保存，后续批量任务直接选用，不必每次重写。

第四步：批量发送与数据追踪

创建发送任务时选定模板、收件人分组与标签，然后选择立即发送或定时发送（对应 core/api/batch_mail/ 模块）。任务运行中可以随时暂停、恢复，或在速度控制里调低每分钟发信条数来保护发信 IP。发送完成后在任务详情页查看送达、打开率、点击率等统计图，退订请求会自动进入退订名单，后续批次不再发送给同一地址。

常见问题与注意事项

问：自定义域名验证失败怎么办？先用bm show-record查看系统要求的全部 DNS 记录，逐条与你的 DNS 服务商核对，A/ MX/SPF/ DKIM 任一缺失都会导致验证不过；改完记录等解析生效再重试。
问：发信量突然变大，会不会进垃圾箱？会。平台内置 rspamd 反垃圾引擎和 fail2ban 访问防护，且提供异常收件人黑名单自动扫描；建议新域名先用低速度发送预热，再逐步提量。
问：想升级版本要重新部署吗？不用。执行bm update拉取新版本即可，bm help可查看全部管理命令。
问：管理员账号和密码忘了？用bm default输出默认账号信息，或直接查看.env文件里的配置项。
问：需要收件箱收信吗？系统已内置 RoundCube，通过/roundcube/路径即可使用 WebMail，IMAP/POP3 端口开箱可用。