Rails Action Mailbox仅配置邮件接收功能时无法收信的问题排查
Action Mailbox + Postfix 仅收信场景排查指南
核心现象定位
当前mail.log无任何来自Gmail的收信记录,说明外部邮件尚未到达服务器本地的Postfix服务,优先排查上游投递链路,而非Rails或Postfix内部转发配置。
第一优先级:排查邮件投递前置链路
- 检查DNS MX记录:仅
mail.xxx.com的A记录可通不具备收信能力,必须为根域名xxx.com配置MX记录,指向mail.xxx.com(优先级设为10),否则Gmail无法定位邮件投递目标 - 验证25端口的可达性:
- 云厂商默认封禁入站25端口,需在云控制台申请解封,同时确认云安全组已放行25端口的所有源地址入站规则
- 检查25端口占用情况:执行
ss -tlnp | grep :25,若进程为Docker代理,说明Docker的25端口映射抢占了主机Postfix的监听端口,需调整Docker端口映射,将Postfix的25端口监听优先级保留在主机层面
- 确认主机防火墙(ufw/firewalld)已放行25端口入站规则
第二优先级:修正Postfix配置生效问题
- 检查
/etc/postfix/main.cf核心参数:- 需启用
virtual_alias_domains = xxx.com声明本服务器负责xxx.com的邮件接收 - 配置映射指向:
virtual_alias_maps = hash:/etc/postfix/virtual_aliases、transport_maps = hash:/etc/postfix/transport
- 需启用
- 每次修改
virtual_aliases、transport文本配置文件后,必须执行对应命令生成hash格式的配置数据库,否则Postfix不会读取文本内容:postmap /etc/postfix/virtual_aliases postmap /etc/postfix/transport - 执行
postfix check命令检查配置语法,确认无报错后再重启服务
第三优先级:排查转发链路权限问题
- 给转发脚本添加可执行权限,确认属主匹配:
chmod +x /usr/local/bin/email_forwarder.sh chown airdrop:airdrop /usr/local/bin/email_forwarder.sh - 以
airdrop用户身份手动执行脚本内的rails命令,验证RVM环境加载正常、本地3005端口连通无问题 - 验证本地转发链路:在服务器本地执行
echo "test content" | sendmail ydddd@xxx.com,查看mail.log记录,确认邮件能顺利通过管道传递给转发脚本
第四优先级:Action Mailbox 接入校验
- 确认Rails生产环境配置的
action_mailbox.ingress_password与转发脚本中传递的INGRESS_PASSWORD完全一致,无多余空格或转义错误 - 验证Nginx代理规则:确认
/rails/前缀的请求能正常代理到本地3005端口的Rails服务,无其他优先级更高的location规则拦截Action Mailbox的入口路径
内容的提问来源于stack exchange,提问作者SylorHuang
相关产品推荐
相关产品推荐

