必须先安装并配置redis（密码仅含英文和数字），再安装邮局插件并完成初始化（含主机名修复）；spf/dkim/dmarc需按规范设置dns记录；ssl证书须绑定主域名而非mail子域名。
必须先装 Redis 并设密码，否则邮局初始化失败或 Rspamd 反垃圾模块不工作
安装邮局插件前必须搞定 Redis
宝塔邮局管理器依赖 Redis 存储会话、缓存和 Rspamd 的运行时数据。没装 Redis 或密码含 &、% 等符号，会导致：
- 初始化卡在“正在启动 Rspamd”或直接报错
- 后台负载状态显示异常（如一直显示“未知”）
- 反垃圾过滤失效，邮件进 Gmail/Outlook 垃圾箱概率飙升
操作建议：
- 在宝塔面板「软件商店」搜索并安装
Redis，安装后点击设置 → 修改密码 → 仅用英文+数字组合（例如redis2026） - 确认
/www/server/redis/redis.conf中requirepass已生效，且无注释 - 重启 Redis 服务：
systemctl restart redis
邮局插件安装与初始化关键动作
邮局插件（v4.5）不是装完就能用，初始化阶段几个操作不点对，后续域名添加、发信全卡住。
- 进入「软件商店」→ 搜索「邮局」→ 安装「宝塔邮局管理器」→ 等待状态变「已安装」
- 点击「设置」→ 首次打开会弹「初始化」提示 → 必须点「确定」，不能跳过
- 若弹出「主机名不正常」警告 → 点「修复」→ 选择「域名方式」→ 输入你的主域名（如
example.com），不是mail.example.com→ 提交 - 初始化成功后，左侧菜单才出现「邮局管理」入口
SPF/DKIM/DMARC 解析必须按顺序填，且值不能带引号
这些 DNS 记录是邮箱被外域接收方信任的核心依据。填错格式或顺序，QQ、163、Gmail 会直接拒收或打入垃圾箱。
-
MX记录：主机名填@，记录值填mail.example.com（注意是mail二级域名，不是 IP），优先级10 -
SPF记录：主机名填@，记录类型选TXT，记录值填v=spf1 mx a ip4:你的服务器IP ~all（不要加双引号，不要写成"v=spf1..."） -
DKIM记录：在邮局后台「域名管理」→ 点击对应域名右侧「DKIM」→ 复制生成的完整字符串（含default._domainkey主机名和长段 base64 值）→ 在 DNS 后台新建TXT记录，主机名填default._domainkey，值粘贴整段（不含引号） -
DMARC记录：主机名填_dmarc，记录类型TXT，值填v=DMARC1; p=quarantine; rua=mailto:postmaster@example.com（p=none初期可测，但上线后务必改quarantine或reject）
验证是否生效：在邮局后台「域名管理」→ 点「验证域名解析」。如果提示“未检测到 DKIM”，大概率是你复制时多了一个空格或用了中文引号。
SSL 证书必须绑定主域名，不能只绑 mail 子域名
邮局 Web 管理端（https://mail.example.com）和 SMTPS/IMAPS 服务都依赖证书。但宝塔邮局只认「主域名」证书，比如你邮箱域是 example.com，那证书就必须是 example.com 或泛域名 *.example.com，单独申请 mail.example.com 的证书会报错 ssl_cert_not_found。
- 在宝塔面板「网站」→ 添加站点 → 域名填
example.com（不是 mail 子域名）→ 开启 SSL → 用 Let's Encrypt 申请 - 申请成功后，回到邮局插件设置页 → 「SSL 设置」→ 选择「使用已有证书」→ 选中刚才申请的
example.com证书 → 保存 - 如果用了 Cloudflare，记得把代理状态关成「DNS only」，否则验证失败
真正容易被忽略的是：Rspamd 日志默认不输出到面板日志里，排查 SPF/DKIM 失效时，得直接看 /var/log/rspamd/rspamd.log，而不是只盯着邮局后台的绿色勾。
