FIR项目邮件通知功能配置指南

前言

FIR作为一款优秀的事件响应管理平台，其通知系统是核心功能之一。本文将详细介绍如何正确配置FIR的邮件通知功能，特别是针对生产环境中常见的配置问题提供解决方案。

核心配置要点

1. SMTP基础配置

在production.py配置文件中必须包含以下关键参数：

EMAIL_HOST = '邮件服务器地址'
EMAIL_PORT = 25  # 标准SMTP端口
EMAIL_FROM = '"显示名称" <发件人邮箱>'  # 重要：必须设置发件人信息

2. 通知插件依赖

确保在installed_apps.txt中已启用通知插件：

fir_notifications

3. 用户邮箱配置

每个需要接收通知的用户必须在个人资料中设置有效的邮箱地址，这是通知发送的前提条件。

常见问题解决方案

邮件发送失败排查

当遇到邮件无法发送时，建议按以下步骤排查：

1. 测试邮件功能： 使用Django内置测试命令验证SMTP配置：

   ./manage.py sendtestemail 接收邮箱
   

2. 日志记录配置： 在production.py中添加详细日志记录：

   LOGGING = {
       'version': 1,
       'disable_existing_loggers': False,
       'handlers': {
           'file': {
               'level': 'DEBUG',
               'class': 'logging.FileHandler',
               'filename': '/var/log/fir_debug.log',
           },
       },
       'loggers': {
           'django': {
               'handlers': ['file'],
               'level': 'DEBUG',
               'propagate': True,
           },
       },
   }
   

关键注意事项

1. Celery服务要求： FIR的通知系统依赖Celery异步任务队列，必须配置并运行Celery worker服务。这是很多用户容易忽略的关键点。

2. 通知订阅机制： 用户需要在个人资料页面明确订阅相关业务线的事件通知，包括：

   • 事件创建
   • 状态变更
   • 评论更新等

3. 模板关联： 确保在管理后台中，通知模板已正确关联到对应的业务线。

最佳实践建议

1. 生产环境建议使用加密的SMTP连接（端口587或465）
2. 定期检查Celery worker的运行状态
3. 为不同业务线定制专属的通知模板
4. 建立邮件发送失败的监控机制

通过以上配置和注意事项，可以确保FIR的通知系统在生产环境中稳定可靠地工作。如遇特殊问题，建议检查系统防火墙设置和邮件服务器的反垃圾邮件策略。