使用代理服务器时ActionMailer无法正常工作的问题求助

碰到代理环境下ActionMailer发不了邮件的问题，我之前也遇到过，给你几个靠谱的解决思路：

1. 设置Ruby全局网络代理 #

ActionMailer底层依赖Ruby的Net::HTTP和Net::SMTP库，直接设置全局代理环境变量，就能让所有网络请求自动走代理：

# 在初始化代码（比如config/initializers/mail.rb）里添加
ENV['http_proxy'] = 'http://proxy_username:proxy_password@proxy_host:proxy_port'
ENV['https_proxy'] = 'http://proxy_username:proxy_password@proxy_host:proxy_port'

如果你的代理不需要认证，就简化成：

ENV['http_proxy'] = 'http://proxy_host:proxy_port'
ENV['https_proxy'] = 'http://proxy_host:proxy_port'

这个方法最简单，适合整个应用都需要走代理的场景。

2. 给ActionMailer的SMTP配置指定代理 #

如果不想全局设置代理，可以直接在SMTP配置里指定代理参数（适用于Rails 6+版本，部分旧版本可能需要手动处理）：

ActionMailer::Base.smtp_settings = {
  enable_starttls_auto: true,
  address: 'smtp.gmail.com',
  port: 587,
  authentication: :login,
  user_name: 'username@gmail.com',
  password: 'password',
  domain: 'gmail.com',
  # 添加代理配置
  proxy: {
    address: 'your_proxy_host',
    port: your_proxy_port,
    user: 'proxy_username', # 不需要认证就去掉这行
    password: 'proxy_password' # 不需要认证就去掉这行
  }
}

如果你的Rails版本不支持proxy参数，可以手动重写ActionMailer的SMTP投递方法，强制使用代理：

# 在config/initializers/mail.rb里添加
module ActionMailer
  class Base
    def perform_delivery_smtp(mail)
      # 创建带代理的SMTP实例
      smtp = Net::SMTP::Proxy(
        'proxy_host', 
        proxy_port, 
        'proxy_username', # 可选，无认证则省略
        'proxy_password'  # 可选，无认证则省略
      )
      smtp.start(
        smtp_settings[:address],
        smtp_settings[:port],
        smtp_settings[:domain],
        smtp_settings[:user_name],
        smtp_settings[:password],
        smtp_settings[:authentication]
      ) do |smtp|
        smtp.send_message(mail.encoded, mail.from_addrs, mail.destinations)
      end
    end
  end
end

3. 检查代理的网络与SSL限制 #

有时候不是代码配置的问题，而是代理本身的限制：

• 确认代理服务器允许出站访问smtp.gmail.com的587端口，有些代理会封锁邮件端口
• 如果代理使用了SSL拦截（比如企业代理），需要把代理的CA证书添加到Ruby的信任列表里，在SMTP配置中指定：

ActionMailer::Base.smtp_settings = {
  # 原有配置...
  ssl_ca_file: '/path/to/your_proxy_ca_certificate.pem'
}

先试试第一种全局代理的方法，一般就能解决问题，如果不行再尝试后面的方案。

内容的提问来源于stack exchange，提问作者Sudarshan Dhokale