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 是一套可以自建的开源邮件营销平台：内置 Postfix/Dovecot/Rspamd 邮件服务器，再配联系人管理、模板、群发任务与发送统计，适合不想依赖第三方发送服务、要把投递数据和收件人数据留在自己手里的团队。下面按实际操作顺序，把部署、首次登录和第一次群发的完整流程走一遍。

🎯 先找到自己的使用场景

自建邮件营销的中小团队：批量发 newsletter 和促销邮件，不想按发送量付费，整套服务跑在自己服务器上。
想摆脱发送限制与数据黑盒的开发者：平台提供对外的邮件发送 API 与模板接口，可以在此基础上接自己的业务或并入现有系统。
同时需要"邮件服务器 + 营销"的团队：内置 RoundCube 网页邮箱，走/roundcube/路径直接当普通邮箱入口用。

📬 走一遍完整发送流程

整理收件人群组

"发给谁"由联系人模块承担：建分组、打标签、批量导入（仓库带了样例文件 data/example_recipients.csv）、导出与批量编辑。群发前按分组和标签的组合筛出目标收件人，不用手工拆名单，对应实现在 core/api/contact/。

制作邮件内容

模板模块（core/api/email_template/）提供在线编辑器，可以新写，也可以复用已有模板。配置好 AI 模型后，还能让 AI 辅助撰写正文：在 AI 模型设置里启用选定的服务商，填入 API Key 与 Base URL，点 Check 验证连通后再保存。平台列出 OpenAI、Gemini、Anthropic、DeepSeek、Kimi、Grok 等供应商，这是做 AI 邮件营销的入口。

模板还支持导入品牌信息：输入邮件域名后，系统可自动提取品牌颜色、分析内容结构、导入图片，也可以自定义 logo，入口在邮件域名配置页。

创建并控制发送任务

建任务在群发模块（core/api/batch_mail/）：选模板和收件人群组，选择立即发送或定时发送，并设置发送速度。发送过程中可以随时暂停、恢复、调整速度，不必重建任务；每个任务还能发测试邮件验证效果。

查看发送结果

发出后在概览页看投递、打开与点击情况，统计模块按任务、按渠道汇总，也可以下钻到单封邮件日志。想提升送达率，内置的发件 IP 预热功能可以按节奏逐步放量。

🚀 完成部署与首次登录

前提是服务器装好 Docker 和 docker compose 插件。克隆后用 env_init 作为初始 .env，首次启动前把 BILLIONMAIL_HOSTNAME 改成你域名的邮件主机名（如 mail.example.com），它决定后续的 DNS 记录与 DKIM 签名域名。

git clone https://gitcode.com/GitHub_Trending/bi/BillionMail cd BillionMail cp env_init .env docker compose up -d

不想手动装 Docker 时，可以改用仓库自带的 install.sh 处理环境。

compose 文件一次拉起六个服务：PostgreSQL、Redis、Postfix、Dovecot、Rspamd 和管理容器，管理界面默认走 80/443 端口，另开放 25/465/587/143/993/110/995 等邮件端口。

初始登录信息写在 env_init 里：用户名和密码都是billion，管理入口在/billion路径（由 SafePath 控制）。记不住完整地址时，在服务器执行bm default会列出访问地址与默认账号；bm show-record会打印需要配置的全部 DNS 记录。之后在域名管理页添加域名，按提示把 A、MX、SPF、DMARC、DKIM 记录配到 DNS 服务商，生效后再申请 SSL 证书。

⚠️ 常见坑先处理

主机名没改：BILLIONMAIL_HOSTNAME 保持默认 example.com 时，DKIM 与 DNS 全是错的，需要修正 .env 并重建容器。
DNS 记录漏配：A（邮件子域指向服务器）、MX、SPF、DMARC、DKIM 五类缺一不可，漏一条群发送达率都会明显下降，拿 bm show-record 的输出当核对清单。
AI 密钥未验证：想用 AI 写稿，先启用对应供应商，填好 API Key 与 Base URL，点 Check 确认密钥有效后再保存，后续模板里的 AI 辅助才能用。
发送速度过高：新发送域建议从低速开始，避免触发接收方反垃圾机制，任务运行中可随时调速。
客户端显示差异：大批量发送前先发一封测试邮件，在不同常见客户端打开确认模板渲染正常。