Przejdź do treści
Biblioteka skilli
DevOps i chmura · Budowanie i kod

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.

Repozytorium
opengis-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
16
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

port 25 blocked\
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

  1. 概述
  2. 安装部署
  3. DNS 配置
  4. 控制台
  5. 创建发送任务
  6. API(事务邮件)
  7. 退订与合规
  8. SPF/DKIM/DMARC 校验
  9. 性能与送达率优化
  10. 监控与日志
Sekcje z nagłówków SKILL.md, w oryginale · 320 linii, 896 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.