Docmost项目SMTP邮件服务配置与用户密码重置方案

SMTP邮件服务配置要点

在Docmost项目中配置SMTP邮件服务时，常见的配置参数包括：

1. 邮件驱动类型（MAIL_DRIVER）：通常设置为smtp
2. SMTP服务器地址（SMTP_HOST）：如smtp.strato.de等邮件服务商提供的地址
3. 端口号（SMTP_PORT）：常见的有465(SSL)或587(TLS)
4. 认证用户名（SMTP_USERNAME）：完整的邮箱地址
5. 认证密码（SMTP_PASSWORD）：邮箱服务商提供的专用密码
6. 安全连接（SMTP_SECURE）：true表示启用SSL/TLS加密
7. 发件人信息（MAIL_FROM_ADDRESS/NAME）

连接超时问题排查

当出现EmailProcessor Job连接超时的情况时，建议进行以下检查：

1. 确认SMTP_HOST地址是否正确无误
2. 验证端口号是否与服务商要求的一致（465或587）
3. 检查防火墙设置，确保出站连接未被阻止
4. 测试基础网络连通性（如telnet或curl命令）
5. 确认SMTP_USERNAME是否为完整邮箱地址
6. 验证SMTP_PASSWORD是否为专用应用密码（部分服务商要求）

替代密码重置方案

当SMTP服务不可用时，可通过数据库直接修改用户密码：

1. 使用bcrypt算法生成密码哈希（推荐cost factor为12）
2. 更新数据库users表中相应用户的password字段
3. 密码哈希示例生成方式：

   $2a$12$N9qo8uLOickgx2ZMRZoMy.Mrq6phx5U4yX7yKeQjLQYV1XTMJh.C6
   

   其中"$2a$12$"表示使用bcrypt算法，cost factor为12

临时测试方案

对于开发或测试环境，可以考虑以下临时方案：

1. 使用内存中的邮件服务（如mailpit）
2. 配置日志驱动将邮件内容输出到日志文件
3. 使用第三方测试SMTP服务捕获邮件

生产环境建议

1. 优先考虑专业邮件服务提供商
2. 配置正确的SPF、DKIM和DMARC记录
3. 定期检查邮件发送日志
4. 为重要账户启用双因素认证
5. 建立密码恢复的备用方案

通过以上方法，可以确保Docmost项目的邮件功能正常工作，或在紧急情况下快速恢复用户访问权限。