本地邮件服务器（无公网 IP 方案）

基于 Stalwart Mail Server 的本地邮件系统，配合 Brevo 发件中继和 VPS 收件中继，实现完整的邮件收发功能。

适用场景：家庭网络、运营商 NAT 环境、无公网 IP

架构概览

┌─────────────────────────────────────────────────────────────────┐
│ 本地服务器 (Mac/Linux) │
│ │
│ Webmail/IMAP客户端 ──IMAP──► Stalwart ──Brevo──► 外部收件人 │
│ │ │ │
│ └── 显示/管理邮件 └── 存储/转发邮件 │
└─────────────────────────────────────────────────────────────────┘
▲
│ Tailscale VPN (私有网络 IP)
│
┌─────────────┴───────────────────────────────────────────────────┐
│ VPS (公网 IP) │
│ │
│ Postfix 中继 ──► DKIM 验证 ──► Tailscale ──► 本地服务器 │
│ ▲ │
│ │ │
│ 外部邮件 (Gmail/QQ Mail 等) │
└─────────────────────────────────────────────────────────────────┘

收件: 外部发件人 → DNS MX → VPS Postfix → Tailscale VPN → 本地 Stalwart
发件: Webmail → Stalwart (SMTP) → Brevo 中继 → 外部收件人

系统要求

本地服务器

• - macOS / Linux
• Stalwart Mail Server 0.15.5+
• Tailscale（用于 VPS 通信）

VPS

• - 任意云服务商（Vultr/DigitalOcean/腾讯云等）
• Ubuntu 24.04 LTS
• 公网 IP
• 最小配置即可（1核 512MB 内存）

外部服务

• - Brevo 账户（免费 300 封/天）
• Cloudflare DNS（管理域名）
• Tailscale 账户（免费）

快速开始

1. 安装 Stalwart

bash

macOS ARM64

curl -L -o stalwart.tar.gz https://github.com/stalwartlabs/stalwart/releases/download/v0.15.5/stalwart-aarch64-apple-darwin.tar.gz

Linux x86_64

curl -L -o stalwart.tar.gz https://github.com/stalwartlabs/stalwart/releases/download/v0.15.5/stalwart-x86_64-unknown-linux-gnu.tar.gz

tar -xzf stalwart.tar.gz
chmod +x stalwart
./stalwart -c config/config.toml

2. 配置 VPS 中继

bash

在 VPS 上安装 Postfix 和 OpenDKIM

sudo apt update
sudo apt install -y postfix opendkim opendkim-tools

配置 Postfix 转发到本地服务器

echo yourdomain.com smtp:[LOCALTAILSCALEIP]:25 | sudo tee /etc/postfix/transport sudo postmap /etc/postfix/transport

3. 配置 DNS

在 Cloudflare DNS 添加：

类型 名称 内容
───────────────────────────────────────────────────────────
MX @ mail.yourdomain.com (优先级 10)
A mail YOURVPSIP (仅 DNS，灰色云朵)
TXT @ v=spf1 ip4:YOURVPSIP include:spf.brevo.com ~all
TXT _dmarc v=DMARC1; p=none; rua=mailto:rua@dmarc.brevo.com
TXT mail._domainkey DKIM 公钥

配置详解

Stalwart 配置 (config/config.toml)

toml

服务器基本配置

server.hostname = mail.yourdomain.com
server.listener.smtp.bind = [[::]:25]
server.listener.imap.bind = [[::]:143]
server.listener.submission.bind = [[::]:587]

Brevo 发件中继

[relay.brevo] address = smtp-relay.brevo.com port = 587 protocol = smtp

[relay.brevo.auth]
type = plain
username = YOURBREVOLOGIN
password = YOURBREVOSMTP_KEY

默认使用 Brevo 中继

queue.outbound.next-hop = brevo

Postfix 配置 (VPS)

/etc/postfix/main.cf:
ini
myhostname = relay.yourdomain.com
mydomain = relay.yourdomain.com
mydestination = $myhostname, localhost
mynetworks = 127.0.0.0/8, 100.0.0.0/8 # 包含 Tailscale 网段
inet_interfaces = all
smtpcnameoverrides_servername = no
disablednslookups = yes
transport_maps = hash:/etc/postfix/transport

/etc/postfix/transport:

yourdomain.com smtp:[YOURLOCALTAILSCALE_IP]:25

OpenDKIM 配置 (VPS)

/etc/opendkim.conf:
ini
AutoRestart Yes
Syslog yes
Canonicalization relaxed/simple
KeyTable refile:/etc/opendkim/KeyTable
SigningTable refile:/etc/opendkim/SigningTable
Socket inet:12301@localhost
SignatureAlgorithm rsa-sha256

生成 DKIM 密钥:
bash
sudo mkdir -p /etc/opendkim/keys/yourdomain.com
sudo opendkim-genkey -D /etc/opendkim/keys/yourdomain.com -d yourdomain.com -s mail
sudo chown -R opendkim:opendkim /etc/opendkim/keys

用户管理

创建用户

通过 Stalwart Web UI (http://localhost:8080) 或 API：

bash
curl -X POST http://localhost:8080/api/principal \
-u admin:admin123 \
-H Content-Type: application/json \
-d {
type: individual,
name: username,
emails: [username@yourdomain.com],
secrets: [SecurePassword123],
enabledPermissions: [
email-receive,
authenticate,
email-send,
imap-authenticate,
imap-enable,
imap-list,
imap-select,
imap-fetch
]
}

认证说明

⚠️ 重要：Stalwart 认证使用用户名（如 username），而不是完整邮箱地址。

正确: 用户名 = username
错误: 用户名 = username@yourdomain.com

Webmail 集成

Nextcloud Mail 配置

配置项	值
IMAP 主机	127.0.0.1
IMAP 端口

143 | | IMAP 加密 | STARTTLS | | SMTP 主机 | 127.0.0.1 | | SMTP 端口 | 587 | | SMTP 加密 | STARTTLS | | 认证用户名 | 用户名（不是邮箱） |

Nextcloud 配置命令

bash
cd /path/to/nextcloud
php occ config:system:set allowlocalremote_servers --value=true
php occ config:system:set app.mail.verify-tls-peer --value=false --type=boolean

端口说明

端口	服务	说明
25	SMTP	接收邮件（VPS 开放，本地可选）
587

SMTP | 发送邮件（STARTTLS） | | 143 | IMAP | 邮件读取（STARTTLS） | | 465 | SMTPS | 发送邮件 SSL（可选） | | 993 | IMAPS | 邮件读取 SSL（可选） | | 8080 | HTTP | Web 管理界面（仅本地） |

故障排除

邮件无法接收

1. 1. 检查 VPS Postfix 日志：sudo tail -f /var/log/mail.log
2. 确认 DNS MX 记录指向 VPS IP
3. 确认 Tailscale 连接正常
4. 检查 VPS 防火墙是否开放 25 端口

邮件进入垃圾箱

1. 1. 确认 SPF 记录包含 VPS IP 和 Brevo
2. 确认