邮件服务配置

Homeland 会有一系列的邮件通知，例如：注册成功、找回密码、账号锁定 等…

你需要在准备好邮件发送服务，可以是：

  • Postmark - 一个国外的邮件发送服务
  • SMTP - 几乎所有的邮件服务提供商都支持 SMTP 的方式

SMTP 配置

你可以寻找一个支持邮件发送服务器的地方，注册一个自己网站域名的 SMTP 服务，并参考下面的配置（Gmail）：

NOTE: 参考 Gmail 官方 SMTP 配置指导

普通模式配置: config/config.yml

  1. default: &default
  2.   mailer_provider: 'smtp'
  3.   mailer_sender: 'no-relay@your-domain.com'
  4.   mailer_options:
  5.     address: 'smtp.gmail.com'
  6.     port: 587
  7.     domain: 'your-domain.com'
  8.     user_name: 'no-reply@your-domain.com'
  9.     password: 'your-password'
  10.     authentication: 'plain'
  11.     enable_starttls_auto: true
  12.     # openssl_verify_mode: true

NOTE: mailer_provider 为 smtp 的时候 mailer_options 各项配置的解释详见: Rails Guides - Action Mailer Configuration 的 smtp_settings 配置项（mailer_options 完全等于 smtp_settings）。

Docker 模式，配置 app.local.env

  1. mailer_provider=smtp
  2. mailer_sender=no-reply@your-domain.com
  3. mailer_options.address=smtp.gmail.com
  4. mailer_options.port=587
  5. mailer_options.domain=your-domain.com
  6. mailer_options.user_name=no-reply@your-domain.com
  7. mailer_options.password=your-password
  8. mailer_options.authentication=plain
  9. mailer_options.enable_starttls_auto=true

Postmark

访问 Postmark 官方网站注册，并购买邮件服务，并获得 app_key

  1. default: &default
  2.   mailer_provider: 'postmark'
  3.   mailer_sender: 'no-relay@your-domain.com'
  4.   mailer_options:
  5.     api_key: 'your-postmark-api-key'

如何测试

你只需要启动应用，并尝试找回密码功能，看看邮件是否正确收到。