Docker-Mailserver 中 ClamAV 与 Rspamd 集成问题分析与解决方案

问题背景

在使用 Docker-Mailserver 项目时，用户报告了一个关于 ClamAV 病毒扫描功能与 Rspamd 集成的问题。具体表现为当启用 Rspamd 并禁用 Amavis 时，ClamAV 无法正常扫描邮件，特别是附件内容。这个问题在标准测试用例（如发送 EICAR 测试文件）中尤为明显。

技术分析

1. 权限问题

核心问题之一在于 /var/run/clamav 目录的权限设置。默认情况下，该目录的所有权为 clamav:root，这可能导致 Rspamd 进程无法正确访问 ClamAV 的 Unix 域套接字文件 clamd.ctl。

解决方案包括：

chown clamav:clamav /var/run/clamav

或者通过创建 user-patches.sh 脚本在容器启动时自动设置权限：

#!/bin/bash
chown clamav:clamav /var/run/clamav

2. 网络模式影响

当使用 --network=host 模式运行容器时，可能会遇到 Unix 域套接字通信问题。这是因为：

1. 主机网络模式改变了容器内进程的网络栈行为
2. 可能干扰了本地进程间通信机制
3. 特别是在 IPv6 环境下可能出现兼容性问题

3. 配置优化

对于 Rspamd 的 ClamAV 集成，推荐的配置应包含以下关键参数：

scan_mime_parts = true
scan_text_mime = true
scan_image_mime = true

这些设置确保了对邮件正文和各种类型附件的全面扫描。

解决方案验证

通过以下步骤可以验证解决方案的有效性：

1. 基本测试：发送包含 EICAR 测试字符串的邮件

swaks --body 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*'

2. 附件测试：发送包含 EICAR 测试文件的附件

swaks --attach eicar_test_file.txt

3. 压缩附件测试：发送经过 gzip 压缩的 EICAR 测试文件

gzip eicar_test_file.txt
swaks --attach - < eicar_test_file.txt.gz

成功的病毒检测应该在日志中显示类似以下信息：

ClamAV FOUND VIRUS "Eicar-Signature"

高级配置方案

对于需要将 ClamAV 作为独立服务运行的情况，可以采用以下架构：

1. 单独运行 ClamAV 容器：

docker run -d -p 3310:3310 --name=clamav clamav/clamav:latest

2. 修改 Rspamd 配置使用 TCP 连接：

servers = "clamav_host:3310"

3. 在 Docker-Mailserver 中禁用内置 ClamAV：

-e ENABLE_CLAMAV=0

最佳实践建议

1. 避免使用 host 网络模式：除非有特殊需求，否则建议使用默认的桥接网络模式

2. 权限管理：确保 ClamAV 相关目录和文件有正确的所有权和权限

3. 日志监控：定期检查邮件日志确认病毒扫描功能正常工作

4. 测试验证：部署后立即进行 EICAR 测试验证扫描功能

5. 配置备份：对修改的配置文件进行备份，便于故障恢复和迁移

总结

Docker-Mailserver 中 ClamAV 与 Rspamd 的集成问题主要源于权限设置和网络配置。通过正确设置目录权限、优化配置文件以及在必要时采用 TCP 连接方式，可以确保病毒扫描功能的正常工作。对于生产环境，建议在部署变更前进行全面测试，并建立监控机制以确保安全功能的持续有效。