OpenMail：用 Node.js 自建一套能收能发的邮件系统（SMTP/POP3/WebMail 单进程全搞定）

docker run -d --name openmail \
  -p 15682:15682 -p 25:25 -p 587:587 -p 110:110 \
  -v openmail-data:/app/data \
  docker.cnb.cool/hanyuxin/mail:latest

# 创建管理员账号（会自动创建域名）
docker exec -it openmail node bin/mailadmin.js adduser admin@localhost -p 123456 --admin

mkdir openmail && cd openmail
curl -O https://cnb.cool/hanyuxin/mail/-/raw/main/docker-compose.prod.yml
curl -O https://cnb.cool/hanyuxin/mail/-/raw/main/deploy.sh
chmod +x deploy.sh

./deploy.sh          # 交互式：填域名/端口 → 写配置 → 拉镜像 → 启动 → 创建管理员
# 或 ./deploy.sh -y   # 全默认值

docker compose -f docker-compose.prod.yml up -d
docker compose -f docker-compose.prod.yml exec openmail \
  node bin/mailadmin.js adduser admin@example.com -p 123456 --admin

docker.cnb.cool/hanyuxin/mail

mkdir -p /opt/openmail && cd /opt/openmail
curl -O https://cnb.cool/hanyuxin/mail/-/raw/main/docker-compose.prod.yml
curl -O https://cnb.cool/hanyuxin/mail/-/raw/main/deploy.sh
chmod +x deploy.sh

./deploy.sh

./deploy.sh -y      # 等价 ASSUME_YES=1 ./deploy.sh

docker compose ps                    # 应看到 openmail 与 mysql 两个容器 running
docker compose logs --tail 50 openmail   # 检查启动日志，确认无报错
# 本机探活（WebMail/安装向导）
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:15682/

# 用任意 SMTP 客户端给 admin 发一封（无认证入站，仅限本地域）
node -e "
const nodemailer = require('nodemailer');
nodemailer.createTransport({ host: '127.0.0.1', port: 25 }).sendMail({
  from: 'friend@outside.com', to: 'admin@example.com',
  subject: '你好', text: '来自外部的问候'
}).then(() => console.log('已投递'));
"

docker compose exec openmail node bin/mailadmin.js gencert /app/data/certs

# 添加域名时自动生成 DKIM 密钥（RSA-2048）
npm run admin -- adddomain example.com

# 输出该域名应配置的全部解析记录
npm run admin -- dns example.com

# 在线检测解析是否已生效（逐条实测 MX/TXT 记录）
npm run admin -- dns example.com --check

# 轮换 DKIM 密钥（旧记录建议保留两周过渡）
npm run admin -- dns example.com --rotate

npm run bench -- --count 100000 --mode send    # 外发队列吞吐
npm run bench -- --count 100000 --mode ingest  # 入站收信吞吐
npm run bench -- --count 100000 --mode both

# 创建密钥（绑定 alice 的发件身份，scope: full / send / read）
npm run admin -- apikey add alice@example.com --scope full

# 编程发信
curl -X POST http://127.0.0.1:15682/api/v1/send \
  -H "Authorization: Bearer omk_xxx" -H "Content-Type: application/json" \
  -d '{"to":"user@example.com","subject":"hi","text":"hello","attachments":[{"filename":"a.txt","contentType":"text/plain","content":"aGVsbG8="}]}'

# 收件列表 / 详情 / 统计
curl -H "Authorization: Bearer omk_xxx" http://127.0.0.1:15682/api/v1/messages?folder=inbox
curl -H "Authorization: Bearer omk_xxx" http://127.0.0.1:15682/api/v1/stats

                        ┌──────────────────────────────────────┐
 外部邮件服务器 ──25──▶  │  protocols/smtp-inbound 收信（防开放中继）│──┐
                        │  quickParse 快速解析 + 规则引擎          │  │ 分组
                        └──────────────────────────────────────┘  │ 批量
                                                                  ▼
 浏览器 ────15682────▶  │  Express 原生托管 React + HTTP API     │  MySQL 8
 邮件客户端 ──110────▶  │  protocols/pop3                      │  utf8mb4
 邮件客户端 ──143────▶  │  protocols/imap（IMAP4rev1 子集）     │  连接池
 用户 ──587(认证)────▶  │  protocols/smtp-submission ─ 本地直投  │──┘
                        │                    └─ 发信队列 ─┐     │
                        └────────────────────────────────┼─────┘
                                                         ▼
                        │  queue/outbound 并发 worker 池         │
                        │  SKIP LOCKED 认领 · blob 去重 · 退避    │
                        └──────────────┬───────────────────────┘
                                   25/MX 或 RELAY_HOST ─▶ 互联网

npm run admin -- adduser bob@example.com -p 123456        # 创建用户
npm run admin -- passwd bob@example.com newpass           # 改密码
npm run admin -- listusers                                # 用户列表
npm run admin -- adddomain example.com                    # 添加域名
npm run admin -- addalias team@example.com bob@example.com  # 别名
npm run admin -- send alice@example.com bob@example.com "主题" body.txt  # 命令行发信
npm run admin -- bulksend news@example.com rcpt@test.local --count 100000  # 10 万级批量入队
npm run admin -- gencert data/certs                       # 生成自签名 TLS 证书
npm run admin -- stats                                    # 系统统计