SMTP配置未正确导致邮件无法送达，需通过Web界面填写主机、端口、认证信息并发送测试邮件，保存后重启IIS应用程序池生效。
如果您在使用 OnlyOffice 协作空间时无法收到注册邀请、任务通知或密码重置邮件，则很可能是 SMTP 设置未正确配置。以下是多种可独立实施的配置方法：
一、通过 Web 管理界面配置 SMTP
此方法适用于已部署并能正常访问管理后台的 OnlyOffice Workspace 企业版或社区版，无需修改配置文件，操作直观且支持实时测试验证。
1、登录 OnlyOffice 协作空间管理员账户，点击右上角用户图标，进入设置页面。
2、在左侧导航栏中选择集成选项卡，然后点击SMTP 设置子项。
3、在 SMTP 设置表单中填写以下字段：
4、在主机字段输入 SMTP 服务器域名，例如 smtp.gmail.com 或 smtp.yandex.ru；
5、在端口字段填入对应端口号，推荐使用 587（STARTTLS）或 465（SSL）；
6、勾选身份验证，并在主机登录字段填入完整邮箱地址（如 alerts@company.com）；
7、在主机密码字段填入该邮箱的应用专用密码（非账户登录密码，Gmail/Yandex/Mail.ru 均需单独生成）；
8、在发件人显示名称中输入组织名称，如 OnlyOffice 通知中心；
9、在发件人电子邮件地址中填入与主机登录一致的邮箱地址；
10、根据端口选择是否勾选启用SSL（端口 465 必须勾选，587 则应勾选启用 STARTTLS，该选项在部分版本中显示为“启用 TLS”）；
11、点击发送测试邮件按钮，检查目标邮箱是否在 1 分钟内收到主题为“SMTP 测试消息”的邮件；
12、测试成功后点击保存，随后重启 ONLYOFFICE 应用程序池以使配置生效（见方法二第3步）。
二、通过 IIS 手动重启服务使 SMTP 配置生效
仅修改 Web 界面配置不会立即激活 SMTP 功能，必须重启承载 OnlyOffice 的 IIS 应用程序池，否则邮件服务仍调用旧参数或默认空配置。
1、按下 Win + R，输入 inetmgr 并回车，打开 Internet 信息服务 (IIS) 管理器；
2、在左侧连接树中展开应用程序池节点；
3、在列表中找到名称含 ONLYOFFICE 或 CommunityServer 的应用程序池（常见名称为 ONLYOFFICE Server）；
4、右键该池，依次选择停止 → 等待状态变为“已停止” → 再次右键选择启动；
5、若浏览器中已打开 OnlyOffice 页面，请强制刷新（Ctrl + F5），确保加载最新会话上下文。
三、直接编辑 web.appsettings.config 文件配置 SMTP
当 Web 管理界面不可访问（如登录失败、页面空白、500 错误）时，可通过修改底层配置文件强制写入 SMTP 参数，该方式绕过前端校验，优先级高于界面设置。
1、使用管理员权限打开文件资源管理器，定位至：
C:\Program Files (x86)\Ascensio System SIA\CommunityServer\WebStudio\；
2、用记事本或 VS Code 打开 web.appsettings.config 文件；
3、查找
4、按顺序补全或修改以下 6 项键值对（若不存在则新增，位置建议放在
5、
构建并调试跨Office自动化流程，实现Word、Excel、PowerPoint之间的内容迁移，使用Open XML、VBA、python-docx、openpyxl、py...
6、
7、
8、
9、
10、
11、保存文件后，必须执行方法二全部步骤重启应用程序池；
12、重启完成后，访问 http://localhost/Management.aspx?type=17 页面，点击重置编辑器连接设置按钮，同步更新内部服务注册表。
四、使用 Docker 环境变量方式注入 SMTP 配置
对于基于 Docker 部署的 OnlyOffice（如 docker-compose.yml 启动），SMTP 参数应通过环境变量声明，避免容器重建后配置丢失，符合不可变基础设施原则。
1、打开部署目录下的 docker-compose.yml 文件；
2、在 communityserver 服务块的 environment: 下添加以下 6 行：
3、- MAIL_SMTP_HOST=smtp.mailgun.org；
4、- MAIL_SMTP_PORT=587；
5、- MAIL_SMTP_AUTH=true；
6、- MAIL_SMTP_USERNAME=postmaster@yourdomain.com；
7、- MAIL_SMTP_PASSWORD=your_mailgun_api_key；
8、- MAIL_SMTP_STARTTLS_ENABLE=true；
9、保存文件后，在终端执行：docker-compose down && docker-compose up -d；
10、等待容器完全启动（约 90 秒），访问任意用户个人设置页，触发一次密码重置流程，验证邮件是否送达。
五、恢复默认 SMTP 配置并重新校准
当多种配置尝试均失败，或怀疑参数冲突导致服务异常时，可快速回退至初始状态，清除所有自定义值，再逐项重设，排除干扰项。
1、登录管理员后台，进入集成 → SMTP 设置页面；
2、页面底部查找并点击默认设置按钮（该操作将清空主机、端口、凭证等全部字段）；
3、点击保存，随后立即执行方法二完成应用程序池重启；
4、重启完毕后，返回 SMTP 设置页，仅填写主机和端口两项（如 smtp.gmail.com + 587），其余留空；
5、点击发送测试邮件，此时系统将使用内置匿名发信通道（若启用）或返回明确错误提示（如“认证失败”），据此判断是网络层阻断还是凭证问题；
6、确认基础连通性后，再逐步补全身份验证、用户名、密码等字段，并每次保存后点击测试。
