DDEV环境下如何访问Mailpit内置POP3服务器

一、修复Mailpit POP3认证配置问题 #

要启用Mailpit的POP3服务并开启认证，需确保以下步骤正确执行：

• 创建合规的认证文件：明文用户名密码文件需按用户名:密码格式，每行填写一个账号示例：

  test_user:test_pass_123
  dev_account:dev_auth_456
  

  注意：Linux/macOS环境下需将文件权限设为600（执行chmod 600 auth.txt），避免因权限过高被Mailpit拒绝加载。
• 启动Mailpit时指定POP3参数：
  直接通过命令行参数配置：

  mailpit --pop3-auth-file ./auth.txt --pop3-port 1110
  

  或用环境变量配置（适合容器化场景）：

  export MP_POP3_AUTH_FILE=./auth.txt
  export MP_POP3_PORT=1110
  mailpit
  

• 验证配置有效性：启动后查看日志，若出现POP3 server listening on 0.0.0.0:1110 with authentication enabled提示，说明配置成功。可通过telnet快速测试：

  telnet localhost 1110
  # 依次输入 USER test_user 和 PASS test_pass_123，返回+OK则认证通过
  

二、邮件退订功能的测试方案（规避OAuth限制） #

针对公共邮箱服务要求OAuth带来的测试障碍，推荐用本地Mailpit搭建测试环境：

• 模拟测试邮件：用Mailpit默认的SMTP服务（端口1025）发送标题为unsubscribe、发件人为目标用户邮箱的测试邮件到Mailpit收件箱。
• 验证退订逻辑：让你的邮件客户端连接已配置认证的Mailpit POP3服务，筛选出符合条件的邮件，验证退订功能的执行流程是否正常。
• 备选方案：若需更贴近生产环境的测试，可搭建轻量本地邮件服务器（如Postfix+Dovecot），配置简单的用户名密码认证，同样能绕过OAuth的复杂流程。

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