自建企业邮箱与发信服务完全指南

# ── 在 VPS 内测试 25 端口是否对外开放（以 Gmail SMTP 为例）────────────────
telnet smtp.gmail.com 25

# 成功：Connected to smtp.gmail.com.
# 失败（被封）：一直显示 Trying 1.2.3.4... 然后 Connection timed out

# 也可以用 nc 测试（更简洁）
nc -zv smtp.gmail.com 25 -w 5
# 成功：Connection to smtp.gmail.com 25 port [tcp/smtp] succeeded!

# 检查 IP 是否在黑名单（将 a.b.c.d 替换为您的 VPS IP）
# 方法一：在线工具（推荐）
# 访问 https://mxtoolbox.com/blacklists.aspx 输入 IP

# 方法二：命令行查询 Spamhaus 黑名单
# Spamhaus SBL/XBL/PBL 查询（IP 需要反转，如 1.2.3.4 → 4.3.2.1）
host 4.3.2.1.zen.spamhaus.org
# 如果返回 NXDOMAIN = 不在黑名单（✅ 好）
# 如果返回 127.0.0.x  = 在黑名单（❌ 需处理）

# 查看 PTR 记录（rDNS）是否已配置
host 您的服务器IP
# 期望返回类似：x.x.x.x.in-addr.arpa domain name pointer mail.yourdomain.com.

# ── 前提：服务器已安装 Docker 和 Git ────────────────────────────────────────
# Mailcow 当前要求 Docker >= 24、Docker Compose >= 2，并依赖 jq 等系统工具
# Docker 按第 15 篇使用官方软件仓库安装；不要无审阅执行远程安装脚本
apt update
apt install -y git openssl curl gawk coreutils grep jq
docker --version
docker compose version

# ── 第一步：克隆 Mailcow 官方仓库 ─────────────────────────────────────────
cd /opt
git clone https://github.com/mailcow/mailcow-dockerized
cd mailcow-dockerized

# ── 第二步：生成配置文件 ───────────────────────────────────────────────────
./generate_config.sh
# 提示输入 FQDN（完全合格域名），填入：mail.yourdomain.com（不是 yourdomain.com）
# 提示输入时区：Asia/Shanghai 或 UTC

# ── 第三步：（可选）修改 mailcow.conf 调整端口 ─────────────────────────────
# 若 80/443 已被 Nginx 占用，可修改 Mailcow 使用非标准端口
# HTTP_PORT=8080
# HTTPS_PORT=8443
# 然后用外部 Nginx 做反代（见后文）

# ── 第四步：拉取镜像并启动（首次较慢，约 10-20 分钟）──────────────────────
docker compose pull
docker compose up -d

# ── 验证所有服务都在运行 ──────────────────────────────────────────────────
docker compose ps
# 应该看到 ~15 个服务全部 running（包括 postfix、dovecot、rspamd 等）

# 文件路径：/etc/nginx/conf.d/mailcow.conf
# 当 Nginx 已占用 80/443 时，用反代将 Mailcow 暴露出来

# Mailcow Web 管理界面
server {
    listen 443 ssl;
    http2 on;
    server_name mail.yourdomain.com;

    ssl_certificate     /etc/letsencrypt/live/mail.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mail.yourdomain.com/privkey.pem;

    location / {
        proxy_pass https://127.0.0.1:8443;  # Mailcow HTTPS 端口
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        # 关键：禁用 SSL 验证（Mailcow 使用自签名证书在内部）
        proxy_ssl_verify off;
    }
}

server {
    listen 80;
    server_name mail.yourdomain.com;
    return 301 https://$host$request_uri;
}

# 设置 rDNS 后验证是否生效（通常 24-48 小时内生效）
host 你的服务器IP
# 期望输出：x.x.x.x.in-addr.arpa domain name pointer mail.yourdomain.com.

# 也可以用 dig 查询
dig -x 你的服务器IP
# 期望在 ANSWER SECTION 看到：x.x.x.x.in-addr.arpa. PTR mail.yourdomain.com.

# 常见 VPS 商家 rDNS 设置路径：
# Vultr:   服务器设置 → 详情页 → IPv4 → Reverse DNS
# Hetzner:  项目 → 服务器 → 网络 → IPv4 → 铅笔图标编辑 PTR
# BandwagonHost: KiwiVM 面板 → 主菜单 → rDNS Management
# DigitalOcean: Droplet → 网络 → PTR Records

# ── 方案：使用 SendGrid 作为智能中转（SMTP Relay）────────────────────────
# 适用场景：VPS 25 端口被封，无法直接发信，但可以通过 587 端口发给 SendGrid
# 套餐、额度和允许用途会变化，部署前查看服务商当前政策

# 在 Mailcow 管理后台配置 SMTP 中继：
# Configuration → Routing → Outgoing mails → Smart Host
#    hostname: smtp.sendgrid.net
#    port: 587
#    username: apikey
#    password: 你的SendGrid API Key（在 SendGrid 后台创建）

# 配置后同时更新该发信域的 SPF/DKIM，并验证 From 域对齐
# API Key 只授予发信所需权限，放入受限密钥配置，不写入截图或仓库

# ── 方案二：使用 Resend（新兴发信服务，对开发者友好）────────────────────
# 套餐、额度、SMTP 参数和允许用途以当前官方文档为准

# 1. 在 resend.com 注册账号并添加您的发信域名
# 2. 按照 Resend 的指引在 DNS 添加验证记录（类似 DKIM）
# 3. 在 Mailcow 或 Postfix 中配置中继：
#    hostname: smtp.resend.com
#    port: 587 或 465
#    username: resend
#    password: 你的Resend API Key（格式 re_xxxxxxxxx）

# 4. 测试发送
# echo "Test mail body" | mail -s "Test" -r from@yourdomain.com recipient@gmail.com

# ── Mailcow 日常运维命令 ────────────────────────────────────────────────────
cd /opt/mailcow-dockerized     # 必须在 mailcow 目录下执行

# ── 更新 Mailcow ───────────────────────────────────────────────────────────
# 先阅读版本说明、确认磁盘空间并完成可恢复备份，再运行官方更新脚本
./update.sh
# 更新后检查容器、收发信、登录、队列和日志；数据库变更后的回滚依赖完整备份

# ── 备份（备份到 /opt/mailcow-dockerized/备份目录）──────────────────────────
# 官方备份脚本（备份数据库、SSL 证书、配置文件）
./helper-scripts/backup_and_restore.sh backup all

# 恢复前先在隔离环境核对目标目录、版本和可用空间
./helper-scripts/backup_and_restore.sh restore /path/to/backup

# ── 查看邮件队列 ──────────────────────────────────────────────────────────
docker exec -it mailcowdockerized-postfix-mailcow-1 postqueue -p
# 不要用 postsuper -d ALL 直接清空；先保存队列证据并按队列 ID 处理确认的坏消息

# ── 查看各组件日志 ────────────────────────────────────────────────────────
docker compose logs -f postfix-mailcow      # Postfix 发信日志
docker compose logs -f dovecot-mailcow      # Dovecot 收信日志
docker compose logs -f rspamd-mailcow       # Rspamd 垃圾邮件过滤日志
docker compose logs -f nginx-mailcow        # Nginx Web 界面日志

# ── 查看 Rspamd 垃圾邮件统计 ──────────────────────────────────────────────
# 访问 https://mail.yourdomain.com/rspamd 查看实时统计面板