billionmail
/billionmail
Prowadzi samodzielny hosting poczty masowej i transakcyjnej z BillionMail: Postfix, Dovecot, kampanie newslettera, DKIM, MX, PTR, odbicia, wypisy, analityka dostarczalności oraz problemy ze spamem i portem 25.
- Autor
- znlgis ↗
- Repozytorium
- opengis-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 16
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi samodzielny hosting poczty masowej i transakcyjnej z BillionMail: Postfix, Dovecot, kampanie newslettera, DKIM, MX, PTR, odbicia, wypisy, analityka dostarczalności oraz problemy ze spamem i portem 25.
Wyzwalacze z opisu
Oryginalny opis (EN)
Use when self-hosting bulk email or transactional mail — Postfix + Dovecot, newsletter campaigns with rate limiting, DKIM/MX/PTR setup, bounce and unsubscribe handling, delivery analytics, webmail. BillionMail 4.9: docker compose / install.sh deployed mail platform by the aaPanel team. Also for Gmail spam placement, \"port 25 blocked\" by cloud vendors, SPF/DKIM/DMARC failures scored by mail-tester, and invalid unsubscribe links.
Jak działa
- 概述
- 安装部署
- DNS 配置
- 控制台
- 创建发送任务
- API(事务邮件)
- 退订与合规
- SPF/DKIM/DMARC 校验
- 性能与送达率优化
- 监控与日志
Podgląd SKILL.md
---
name: billionmail
description: "Use when self-hosting bulk email or transactional mail — Postfix + Dovecot, newsletter campaigns with rate limiting, DKIM/MX/PTR setup, bounce and unsubscribe handling, delivery analytics, webmail. BillionMail 4.9: docker compose / install.sh deployed mail platform by the aaPanel team. Also for Gmail spam placement, \"port 25 blocked\" by cloud vendors, SPF/DKIM/DMARC failures scored by mail-tester, and invalid unsubscribe links."
tags:
- email
- smtp
- self-hosted
- newsletter
- marketing
- postfix
- docker
- devops
---
> **项目地址:** <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(推荐)
```bash
git clone https://github.com/Billionmail/BillionMail
cd BillionMail
cp env_init .env
# 编辑 .env:DOMAIN、DB 密码、MX/SMTP 配置等
docker compose up -d
```
### 一键脚本
```bash
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 | <IP> | 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 / 文档」入口确认实际路径,再照下面形态调用。
```bash
curl -X POST https://your-server/api/v1/mail/send \
-H 'Authorization: Bearer <API_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"from": "noreply@example.com",
"to": ["user@x.com"],
"subject": "欢迎注册",
"template_id": 12,
"variables": { "name": "张三" }
}'
```
Webhook 回调:
```json
POST https://yourapp.com/hooks/billionmail
{
"event": "delivered|bounced|opened|clicked|unsubscribed",
"message_id": "...",
"to": "...",
"ts": 1700000000
}
```
---
## 退订与合规
- 模板默认包含 `{{unsubscribe_url}}`
- 退订后自动加入黑名单,再次发送被拒
- 提供 List-Unsubscribe / List-Unsubscribe-Post 头(兼容 Gmail/Outlook 一键退订)
---
## SPF/DKIM/DMARC 校验
控制台 → 设置 → 域名健康检查;或:
```bash
dig TXT default._domainkey.example.com
dig TXT _dmarc.example.com
```
```bash
mail-tester.com # 免费送达率打分
```
目标分数:≥ 9/10。
---
## 性能与送达率优化
1. **新 IP 预热**:从 50/day 起,每 2-3 天翻倍
2. **限速分批**:避免被收件方 throttling
3. **多 IP 池**:营销与事务分开
4. **退信处理**:硬退信立刻加黑名单
5. **内容质量**:去除垃圾词、图文比例、HTML/纯文本双版本
6. **认证三件套**:SPF + DKIM + DMARC 全配
7. **反向 DNS**:必须与 HELO 一致
8. **TLS**:默认 STARTTLS
---
## 监控与日志
- 容器日志:`docker compose logs -f postfix dovecot`
- 邮件队列:`mailq`(容器内)
- 控制台「日志」页查看每条邮件状态
- 集成 Prometheus / Grafana(可选)
---
## 核心命令
```bash
# 部署
git clone https://github.com/Billionmail/BillionMail && cd BillionMail
cp env_init .env
# 编辑 .env:DOMAIN、数据库密码、SMTP 配置
docker compose up -d
# 查看运行状态
docker compose ps
docker compose logs -f postfix dovecot
# DNS 校验
dig TXT default._domainkey.example.com
dig TXT _dmarc.example.com
dig MX example.com
# SMTP 测试
swaks --to test@example.com --server localhost --port 587 --tls
# 送达率检测
# 访问 https://www.mail-tester.com 获取测试邮箱,发送一封测试邮件
```
---
## 典型工作流
### 场景一:搭建企业 Newsletter 系统
```bash
# 1. 部署
git clone https://github.com/Billionmail/BillionMail
cd BillionMail
cp env_init .env
# 编辑 .env:DOMAIN=mail.example.com, 数据库密码
docker compose up -d
# 2. DNS 配置(在域名管理后台)
# 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:admin@..."
# 3. 控制台操作
# ① 添加发件域 → 生成 DKIM → 配置 DNS
# ② 导入订阅者 CSV(邮箱,姓名,标签)
# ③ 创建模板(HTML + 变量 {{name}}, {{unsubscribe_url}})
# ④ 新建发送任务 → 选择分组 → 限速 100封/小时(预热期)
# ⑤ 查看统计:到达率/打开率/点击率/退订率
# 4. 验证送达率
# mail-tester.com → 目标 ≥ 9/10
# 5. API 触发事务邮件
curl -X POST https://mail.example.com/api/v1/mail/send \
-H 'Authorization: Bearer <API_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"from": "noreply@example.com",
"to": ["user@x.com"],
"subject": "欢迎注册",
"template_id": 12,
"variables": {"name": "张三"}
}'
```
### 场景二:从 Mailchimp 迁移到自建
```markdown
1. **导出 Mailchimp 数据**:Audience → Export CSV(含邮箱/姓名/标签/状态)
2. **导入 BillionMail**:订阅者 → 导入 CSV,映射字段
3. **重建模板**:复制 Mailchimp 模板 HTML,替换变量为 `{{name}}` 格式
4. **保留退订列表**:将 Mailchimp 退订名单导入黑名单
5. **IP 预热**:从 50/day 起,每 2-3 天翻倍,直到目标量
6. **并行运行 1-2 周**:新旧系统同时发,确认送达率一致后切换 DNS
```
---
## 常见问题
| 问题 | 解决 |
|------|------|
| Gmail 进垃圾箱 | 修复 SPF/DKIM/DMARC;预热 IP;降低发送量 |
| 25 端口被封 | 联系云厂商 / 用 587 + Relay |
| 退订链接无效 | 检查 `UNSUBSCRIBE_BASE_URL`;TLS 证书 |
| WebMail 无法登录 | 检查 Dovecot 与账号密码;查看容器日志 |
| 大文件附件失败 | 调整 `message_size_limit` |
| 部署后打不开控制台 | 检查 80/443 是否被占用、`DOMAIN` 是否与实际访问域名一致、容器 `docker compose ps` 是否全部 healthy |
| DKIM 校验不通过(`dkim=permerror`) | TXT 记录被换行/引号截断:把 `v=DKIM1; k=rsa; p=...` 拼成单行,用 `dig +short TXT default._domainkey.example.com` 核对完整值 |
| 发出去的邮件进了收件人隔离区 | 反向解析(PTR)与 HELO 不一致:先让机房把 PTR 指到 `mail.example.com`,再核对 `swaks` 的 HELO 名 |
---
## AI 使用建议
### 推荐工作流
1. **先配 DNS 三件套**:SPF + DKIM + DMARC 全配且验证通过,再开始发信
2. **IP 预热是必须的**:新 IP 从低量开始,不要一次性大批量发送
3. **模板先测试**:用 `mail-tester.com` 打分,目标是 ≥ 9/10
4. **分批限速**:每分钟/每小时限速,避免被收件方 throttling 或标记垃圾
5. **监控退信**:硬退信立刻加入黑名单,软退信重试最多 3 次
### 关键模式与常见陷阱
- **25 端口被封**:云厂商默认封锁,需提交工单解封;或使用 587 + Relay 中转
- **Gmail 进垃圾箱**:SPF/DKIM/DMARC 缺一不可 + 反向 DNS + IP 预热 + 内容质量
- **退订合规**:模板必须包含 `{{unsubscribe_url}}`,否则违反 CAN-SPAM/GDPR
- **多 IP 池**:营销邮件和事务邮件分开 IP,避免营销被投诉影响事务送达
- **内容质量**:去除垃圾词(免费/促销/点击领)、图文比例适中、HTML/纯文本双版本
### 如何选择正确方案
| 场景 | 推荐方案 |
|------|---------|
| 少量事务邮件(<100/天) | 第三方 API(SendGrid/Mailgun 免费额度) |
| 企业自建 Newsletter | BillionMail |
| 超大规模(百万级) | BillionMail + 多 IP 池 + 专业 ESP |
| 仅需 SMTP 中转 | Postfix + Dovecot,无需 BillionMail |
---
## 相关技能
- **acme.sh** — 给邮件域的 Web 控制台/WebMail 申请与自动续期 TLS 证书:[../acme.sh/SKILL.md](../acme.sh/SKILL.md)
- **docker-compose** — BillionMail 的部署方式本身就是 Compose(`docker compose up -d`):[../docker-compose/SKILL.md](../docker-compose/SKILL.md)
- **go** — 写发信/退信回调服务时的常用后端语言(SMTP 客户端、Webhook 服务):[../go/SKILL.md](../go/SKILL.md)
---
## 参考资源
- 文档:<https://docs.billionmail.com/>
- 仓库:<https://github.com/Billionmail/BillionMail>
- 中文教程(znlgis):<https://znlgis.github.io/others/BillionMail/>
Wersje
W bazie nie ma innych skilli o nazwie billionmail.
Migawka bazy z 13.11.2026 · wersja paczki b0e70efa1e21 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100linux-mail-server
Obsługuje i diagnozuje Postfix, Exim, Dovecot, wysyłkę SMTP, kolejki poczty, TLS oraz SPF, DKIM i DMARC na hoście pocztowym Linux. - 100email-infrastructure
Obejmuje dostarczalność poczty i uwierzytelnianie DNS: rekordy SPF, DKIM, DMARC, MX, PTR i BIMI, przekaźniki SMTP (SendGrid, SES, Postmark, Mailgun), podstawy Postfix i testy dostarczalności. - 100email-deliverability
Sprawdza dostarczanie poczty domeny: SPF, DKIM, DMARC, MX, rDNS, polityki TLS i reputację, konfigurując usługi i weryfikując rekordy na żywo. - 100postfix
Obsługuje serwer pocztowy Postfix 3.9 i 3.10: main.cf, master.cf, TLS, SASL, domeny wirtualne, milter (OpenDKIM, OpenDMARC, Rspamd), postscreen, kolejki i integrację z Dovecot. - 100email-deliverability-auditor
Audytuje dostarczalność poczty: zgodność SPF, DKIM i DMARC, reguły nadawców masowych dużych dostawców i odbicia, a potem układa plan naprawy i rozgrzewania. - 100mail-auth
Sprawdza uwierzytelnianie poczty domeny (SPF, DKIM, DMARC, MX), podaje rekordy DNS do dodania i powtarza test do propagacji.