ONLYOFFICE DocumentServer 8.2.0 邮件通知功能配置指南

ONLYOFFICE DocumentServer 8.2.0版本引入了针对许可证和配额相关警告的邮件通知功能。这一功能允许管理员通过邮件接收系统的重要状态提醒，确保及时处理潜在问题。本文将详细介绍如何配置和管理这一功能。

功能概述

邮件通知功能主要用于以下场景：

• 许可证即将到期或出现问题时
• 系统配额（如存储空间）接近上限时
• 其他关键系统警告

配置方法

邮件通知功能的配置需要通过修改DocumentServer的配置文件实现，目前尚未提供环境变量配置方式。

SMTP服务器配置

邮件通知依赖于SMTP服务器发送邮件，相关配置位于配置文件的"email"部分。主要配置项包括：

1. smtpServerConfiguration：SMTP服务器连接参数

   • 主机地址
   • 端口号
   • 安全连接选项（SSL/TLS）
   • 认证信息（用户名/密码）

2. connectionConfiguration：连接特定配置

   • 超时设置
   • 连接池选项
   • 调试模式

3. contactDefaults：默认邮件内容设置

   • 发件人地址
   • 邮件主题
   • 其他邮件头信息

通知偏好设置

通知行为的配置位于"notification"部分，可设置以下参数：

1. 启用/禁用通知：全局开关邮件通知功能
2. 通知频率：控制邮件发送的间隔时间
3. 通知内容：自定义邮件正文模板
4. 触发条件：设置触发通知的阈值（如许可证剩余天数）

最佳实践建议

1. 对于生产环境，建议使用专业的SMTP服务而非本地邮件服务器
2. 设置合理的通知频率，避免邮件轰炸
3. 为关键通知设置不同的收件人组
4. 定期检查邮件发送日志，确保通知系统正常运行
5. 在测试环境验证配置后再应用到生产环境

注意事项

1. 修改配置文件后需要重启DocumentServer服务使更改生效
2. 确保SMTP服务器允许DocumentServer服务器连接
3. 检查防火墙设置，确保邮件端口（通常25/465/587）畅通
4. 建议为通知功能创建专用邮件账户，而非使用个人邮箱

通过合理配置邮件通知功能，管理员可以更有效地监控ONLYOFFICE DocumentServer的运行状态，及时应对可能出现的问题，保障服务的持续稳定运行。