You need to enable JavaScript to run this app. Rails Action Mailbox仅配置邮件接收功能时无法收信的问题排查
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 07:45:02