8分钟上手到精通：Billion Mail安装与使用全攻略

Billion Mail是一款开源邮件营销平台，旨在帮助企业和个人轻松管理邮件营销活动。本文将详细解答安装与使用过程中的常见问题，让你从部署到发送邮件全程无忧。

一、快速安装指南

1.1 一键安装（推荐）

cd /opt && git clone https://gitcode.com/gh_mirrors/bi/Billion-Mail && cd Billion-Mail && bash install.sh

该脚本会自动处理依赖项、配置环境并启动服务，全程约8分钟即可完成从安装到成功发送邮件的全过程。

1.2 Docker安装

cd /opt && git clone https://gitcode.com/gh_mirrors/bi/Billion-Mail && cd Billion-Mail && cp env_init .env && docker compose up -d || docker-compose up -d

使用Docker安装前需确保已安装Docker和docker-compose-plugin，并修改.env文件配置参数。

1.3 管理脚本使用

安装完成后，可通过bm.sh脚本进行管理：

• 查看帮助：bm help
• 查看默认登录信息：bm default
• 显示域名DNS记录：bm show-record
• 更新BillionMail：bm update

二、常见安装问题解决

2.1 权限不足问题

若安装时提示权限不足，可尝试：

sudo bash install.sh

或切换到root用户后执行安装命令。

2.2 Docker相关错误

• 确保Docker服务已启动：systemctl start docker
• 检查Docker Compose版本：docker compose version或docker-compose version
• 若提示"docker-compose: command not found"，需安装docker-compose-plugin

2.3 端口占用问题

BillionMail需要以下端口，请确保它们未被占用：

• Web界面：443（HTTPS）、80（HTTP）
• 邮件服务：25（SMTP）、587（SUBMISSION）、465（SMTPS）、143（IMAP）、993（IMAPS）、110（POP3）、995（POP3S）

可使用以下命令检查端口占用情况：

ss -tlnp | grep -E ":25|465|587|143|993|110|995|80|443"

三、域名配置与DNS设置

3.1 添加发送域名

1. 登录BillionMail管理界面
2. 导航至"域名管理"页面
3. 点击"添加域名"并输入你的域名

3.2 DNS记录配置

添加域名后，需配置以下DNS记录：

类型	主机记录	值
A	mail.yourdomain.com	服务器IP地址
MX	@	mail.yourdomain.com（优先级10）
TXT	@	v=spf1 +a +mx +ip4:服务器IP -all
TXT	_dmarc	v=DMARC1;p=quarantine;rua=mailto:[e-mail]
TXT	default._domainkey	DKIM公钥记录

可通过bm show-record命令查看具体的DNS记录配置信息。

3.3 DKIM密钥生成

系统会自动为添加的域名生成DKIM密钥，位于Rspamd容器的/var/lib/rspamd/dkim/域名/default.pub文件中。如需手动生成，可执行：

docker exec -i billionmail-rspamd-billionmail-1 rspamadm dkim_keygen -s default -b 1024 -d yourdomain.com -k /var/lib/rspamd/dkim/yourdomain.com/default.private > /var/lib/rspamd/dkim/yourdomain.com/default.pub

四、邮箱账户管理

4.1 创建邮箱账户

1. 通过管理界面创建：导航至"邮箱管理"→"添加邮箱"
2. 通过命令行创建：

bm add-email [e-mail]

系统会自动生成密码，也可指定密码。

4.2 WebMail访问

BillionMail已集成RoundCube WebMail，可通过/roundcube/路径访问，例如：https://yourdomain.com/roundcube/

五、邮件发送与管理

5.1 创建邮件模板

可在系统中创建自定义邮件模板，模板文件位于template/目录下，支持HTML和纯文本两种格式。

5.2 发送邮件步骤

1. 登录系统后，点击"邮件营销"→"新建 campaign"
2. 选择收件人列表或上传联系人
3. 选择邮件模板或编写邮件内容
4. 设置发送时间（立即发送或定时发送）
5. 点击"发送"完成操作

5.3 查看发送统计

在"统计分析"页面可查看邮件送达率、打开率、点击率等数据，帮助你优化邮件营销策略。

六、系统维护与更新

6.1 定期更新

使用以下命令保持系统最新：

bm update

更新脚本会自动拉取最新代码、更新数据库结构并重启服务。

6.2 数据备份

建议定期备份以下数据：

• 数据库：通过init.sql脚本可初始化数据库结构
• 配置文件：位于conf/目录下
• 邮件数据：包括已发送邮件和联系人列表

6.3 日志查看

各组件日志可通过Docker容器查看，例如查看Postfix日志：

docker logs billionmail-postfix-billionmail-1

七、常见问题排查

7.1 无法访问管理界面

• 检查防火墙设置，确保80/443端口已开放
• 查看服务状态：bm status
• 检查SSL证书是否有效

7.2 邮件发送失败

• 检查DNS记录是否正确配置：bm show-record
• 查看邮件队列：docker exec -i billionmail-postfix-billionmail-1 mailq
• 检查Rspamd反垃圾邮件配置：conf/rspamd/

7.3 接收不到邮件

• 检查垃圾邮件文件夹
• 验证MX记录配置
• 查看Dovecot日志：docker logs billionmail-dovecot-billionmail-1

八、获取更多帮助

8.1 官方文档

详细文档可参考README.md，也可查看多语言版本：

• 简体中文：README-zh_CN.md
• 日本語：README-ja.md
• Türkçe：README-tr.md

8.2 演示环境

可访问演示环境体验功能：

• 地址：https://demo.billionmail.com/billionmail
• 用户名：billionmail
• 密码：billionmail

通过以上指南，你应该能够顺利安装和使用Billion Mail进行邮件营销活动。如遇其他问题，可查阅项目文档或提交issue获取帮助。