PDS项目SMTP邮件服务配置指南

前言

在自托管PDS(个人数据服务器)项目中，邮件服务是系统重要的组成部分。本文将详细介绍如何正确配置PDS的SMTP邮件发送功能，帮助开发者解决常见的邮件发送失败问题。

SMTP配置基础

PDS通过环境变量来配置SMTP服务，主要涉及两个关键参数：

1. PDS_EMAIL_SMTP_URL - SMTP服务器连接地址
2. PDS_EMAIL_FROM_ADDRESS - 发件人邮箱地址

配置详解

标准SMTP配置格式

推荐使用以下格式配置SMTP_URL：

smtp://<用户名>:<密码>@<SMTP服务器地址>:<端口>

不同邮件服务商配置示例

1. Google SMTP服务配置

smtp://yourusername:[e-mail]:587

注意：Google需要应用专用密码而非常规密码

2. 自建Postfix服务器配置

smtps://postfix.example.com:465

或

smtp://postfix.example.com:587

常见问题解决方案

认证失败

• 确保用户名和密码正确
• 对于Google等服务，需使用应用专用密码
• 检查SMTP服务器是否允许来自PDS服务器的连接

端口选择

• 587端口通常用于STARTTLS加密
• 465端口用于SMTPS(SSL加密)
• 25端口通常被ISP屏蔽，不建议使用

加密协议

• 现代邮件服务建议始终使用加密连接
• 根据服务器支持情况选择SSL或STARTTLS

配置验证

配置完成后，建议：

1. 重启PDS容器使配置生效
2. 测试发送邮件功能
3. 检查容器日志获取详细的错误信息

最佳实践

1. 为PDS创建专用的邮件账户
2. 使用强密码或应用专用密码
3. 定期检查邮件发送日志
4. 考虑设置邮件发送速率限制

通过以上配置和注意事项，可以确保PDS项目的邮件服务稳定可靠地运行。