Keila邮件营销平台部署问题排查指南

前言

Keila是一款开源的邮件营销平台，基于Elixir语言开发。在实际部署过程中，用户可能会遇到各种配置问题。本文将针对一个典型的部署案例进行分析，帮助用户理解如何正确配置Keila并解决常见问题。

典型部署问题分析

在案例中，用户遇到了两个主要问题：

1. 邮件发送功能无法正常工作
2. 界面操作异常（编辑后无法保存，预览空白）

这些问题看似独立，实则都源于同一个根本原因：WebSocket连接配置不当。

问题根源：WebSocket支持

Keila平台高度依赖WebSocket技术来实现实时交互功能。当WebSocket连接无法建立时，会导致以下症状：

• 前端操作无响应（如保存按钮失效）
• 实时预览功能无法工作
• 部分异步操作失败

解决方案

1. 启用WebSocket支持

在CapRover等容器管理平台中，需要显式启用WebSocket支持：

1. 登录CapRover管理界面
2. 找到Keila应用配置
3. 在HTTP设置中启用"WebSocket Support"选项

2. 邮件发送配置

虽然初始问题与WebSocket相关，但邮件发送功能也需要正确配置：

MAILER_SMTP_FROM_EMAIL="[e-mail]"

这是最基本的SMTP发件人配置，确保系统知道从哪个邮箱地址发送邮件。

其他配置建议

从日志中可以看到几个值得注意的配置警告：

1. 验证码配置：系统检测到未配置验证码服务，会自动回退到hCaptcha的测试配置。生产环境建议配置正式的验证码服务。

2. Hashid盐值：系统使用了默认的盐值生成方式，生产环境建议设置明确的HASHID_SALT环境变量。

3. 用户上传目录：默认使用"./uploads"目录，建议通过USER_CONTENT_DIR指定专用目录。

最佳实践

1. 环境隔离：区分开发、测试和生产环境的配置
2. 日志监控：定期检查系统日志，及时发现配置警告
3. 分步验证：先验证基本功能，再逐步添加高级配置
4. 备份策略：特别是对用户上传内容和数据库的定期备份

总结

Keila作为功能丰富的邮件营销平台，其部署需要特别注意WebSocket支持和邮件服务配置。通过正确理解系统架构和各组件间的依赖关系，可以快速定位和解决部署过程中的各类问题。建议新用户在部署前详细阅读文档，并按照最小可用配置逐步扩展功能。