DocMost项目环境变量配置修正说明

在DocMost文档管理系统的自托管部署过程中，环境变量的正确配置是确保邮件服务正常工作的关键环节。近期项目维护团队发现官方文档中存在一处重要的变量命名规范问题，现已完成修正。

问题背景

DocMost作为一款开源的文档协作平台，其邮件服务配置需要通过环境变量实现。原文档中错误地将SMTP服务相关变量标注为MAIL_前缀形式，这可能导致用户在按照文档配置时出现邮件服务无法正常工作的情况。

技术细节

正确的SMTP服务配置应使用以下变量命名规范：

• SMTP_HOST：邮件服务器地址
• SMTP_PORT：邮件服务器端口
• SMTP_USERNAME：认证用户名
• SMTP_PASSWORD：认证密码

这种命名方式遵循了行业通用标准，与主流邮件服务提供商的配置规范保持一致。相比之下，MAIL_前缀的变量名虽然语义上也能理解，但与实际代码实现不匹配，会导致配置失效。

影响范围

该问题主要影响：

1. 新部署DocMost实例的用户
2. 需要重新配置邮件服务的现有用户
3. 基于文档进行二次开发的集成项目

解决方案

项目维护团队已及时响应，完成了文档修正。用户现在可以：

1. 参照最新文档配置环境变量
2. 检查现有配置是否使用了正确的变量名
3. 如需切换变量名，注意同时更新相关配置文件和容器环境变量

最佳实践建议

为避免类似问题，建议用户：

1. 始终参考项目最新官方文档
2. 在容器部署时通过-e参数明确指定变量名
3. 使用环境变量管理工具时注意名称一致性
4. 测试配置时优先验证邮件发送功能

该修正体现了DocMost项目团队对文档准确性的重视，也提醒我们在技术实施过程中要注重细节验证，确保文档与代码实现的一致性。