简介EwoMail v1.1.5 是一套完整、可部署的企业级开源邮件服务器解决方案面向计算机专业学生、毕业设计开发者及中小型IT运维人员用于实践邮件系统架构、协议实现SMTP/IMAP/POP3与Web管理平台二次开发。资源包共1630个文件以921个PHP后端逻辑文件为核心辅以177个JS交互脚本、125个HTML页面模板、112个PNG图标资源及46个YML配置文件涵盖服务端、数据库映射、Web界面、安全策略SSL/SPF/Amavis、日志与防火墙规则等完整模块压缩包大小为18.99MB。已有267人学习下载适合开展毕业设计、课程案例分析或Linux邮件服务实战部署。读者可直接基于源码理解邮件收发流程、阅读配套说明.htm安装文档、调试PostfixDovecotRainLoop集成架构并参考mysql-mailbox-maps.cf等配置样例掌握企业级邮箱账户体系设计方法。1. EwoMail v1.1.5 不是“一键安装就完事”的邮件系统而是需要你亲手调通 clamd amavisd RainLoop 的生产级 Linux 邮件栈EwoMail v1.1.5 是一个面向中小团队的开源邮件服务器套件它把 Postfix、Dovecot、MySQL、ClamAV、Amavis、Roundcube及可选 RainLoop打包进统一 Web 管理界面。但很多用户下载ewomail-1.1.5.zip后在 CentOS 7 或 Ubuntu 20.04 上解压运行install.sh发现 Web 界面能打开、域名能解析、SMTP/IMAP 端口也监听了却收不到外网发来的邮件——根本原因不是安装失败而是clamdClamAV 守护进程未启动、amavisd内容过滤网关因缺少病毒库路径配置而静默退出、RainLoop 因未显式启用 HTTPS 和反向代理而无法加载 Webmail。这版 v1.1.5 的核心价值不在“开箱即用”而在提供一套可审计、可调试、可替换组件的邮件基础设施骨架。适合运维工程师、内部 IT 支持人员或 DevOps 工程师要求你熟悉 Linux 服务管理、TCP 端口依赖链、以及邮件协议中 MTA/MDA/MUA 的分层逻辑。如果你只想要一个邮箱账号用企业微信或阿里云邮箱更省心但如果你要控制邮件内容扫描策略、自定义反垃圾规则、或把 Webmail 嵌入现有 SSO 体系EwoMail v1.1.5 就是你绕不开的起点。2. 拆解 EwoMail v1.1.5 的三大关键服务clamd 必须以非 root 用户运行amavisd 依赖 Perl 模块与 socket 路径硬编码RainLoop 需手动绑定到 Nginx 反向代理EwoMail v1.1.5 的架构不是黑盒它的install.sh实际执行的是对标准 Linux 服务的封装调用。理解clamd、amavisd和RainLoop的真实角色与协作关系是后续排错的基础。这三者并非并列组件而是形成一条「入站邮件过滤流水线」Postfix 接收邮件 → 交由 amavisd 扫描 → amavisd 调用本地 clamd 进行病毒检测 → 扫描通过后投递至 Dovecot 邮箱 → 用户通过 RainLoop Web 界面访问。v1.1.5 的设计缺陷在于clamd 默认以clamav用户启动但 amavisd 的配置文件/etc/amavisd.conf中硬编码了bypass_virus_checks_maps (1);即默认跳过病毒扫描且其av_scanners列表里 clamd socket 路径写为/var/run/clamav/clamd.sock而实际安装后该路径可能不存在或权限不对RainLoop 则被静态部署在/opt/ewomail/webmail但 Nginx 配置/etc/nginx/conf.d/ewomail.conf仅将/webmail路径指向 Roundcube未包含 RainLoop 的 location 块。这些都不是 bug而是 v1.1.5 为兼容性做的妥协——它假设你已提前准备好 ClamAV 病毒库、理解 Perl 配置语法、并会手动编辑 Nginx。2.1 验证并修复 clamd 服务从病毒库更新失败到 socket 权限拒绝的完整链路EwoMail v1.1.5 自带的 ClamAV 版本为 0.102.4其clamd守护进程必须以clamav用户运行且依赖/var/lib/clamav下的病毒库文件main.cvd,daily.cvd,bytecode.cvd。常见失败场景是systemctl status clamd显示active (exited)但clamd --version正常——这说明服务启动后立即退出根源通常是病毒库缺失或权限错误。首先检查病毒库状态sudo -u clamav /usr/bin/freshclam --no-daemon --verbose提示freshclam必须以clamav用户运行否则会因无法写入/var/lib/clamav而失败。若提示ERROR: Cant open /var/lib/clamav/main.cvd说明病毒库未下载。若 freshclam 失败手动初始化病毒库sudo mkdir -p /var/lib/clamav sudo chown clamav:clamav /var/lib/clamav sudo chmod 755 /var/lib/clamav sudo -u clamav /usr/bin/freshclam -d -c 2等待 2–3 分钟后检查 socket 文件是否存在ls -l /var/run/clamav/clamd.sock # 正常应显示srw-rw---- 1 clamav clamav 0 ... /var/run/clamav/clamd.sock若 socket 不存在修改/etc/clamd.d/scan.conf# 取消注释并确保以下三行存在 LocalSocket /var/run/clamav/clamd.sock LocalSocketGroup clamav LocalSocketMode 660然后重启服务sudo systemctl daemon-reload sudo systemctl restart clamd sudo systemctl enable clamd验证 clamd 是否真正响应echo PING | sudo socat - UNIX:/var/run/clamav/clamd.sock # 应返回 PONG2.2 重写 amavisd 配置绕过硬编码路径显式声明 clamd socket 与 Perl 模块依赖amavisd 是 EwoMail 的内容过滤中枢v1.1.5 的/etc/amavisd.conf存在两处关键问题一是bypass_virus_checks_maps (1);导致病毒扫描被全局禁用二是av_scanners中 clamd 的 socket 路径未适配实际位置。此外amavisd 依赖Convert::TNEF、Archive::Zip等 Perl 模块CentOS 7 默认不预装需手动补全。先安装缺失 Perl 模块CentOS 7sudo yum install epel-release -y sudo yum install perl-Convert-TNEF perl-Archive-Zip perl-IO-Compress-Zlib perl-MIME-Base64 -yUbuntu 20.04 则用sudo apt-get install libconvert-tnef-perl libarchive-zip-perl libio-compress-zlib-perl libmime-base64-perl -y编辑/etc/amavisd.conf定位到bypass_virus_checks_maps行将其改为bypass_virus_checks_maps (0); # 关键关闭绕过启用扫描再找到av_scanners定义段通常在文件中部将 clamd 条目替换为[ClamAV-clamd, \ask_daemon, [CONTSCAN {}\n, /var/run/clamav/clamd.sock], qr/\bOK$/m, qr/\bFOUND$/m, [\n$SAFEDIR/, \n$QUARANTINEDIR/], qr/^.*?: (?!Infected Archive)(.*) FOUND$/m ],注意/var/run/clamav/clamd.sock必须与上一步clamd实际创建的 socket 路径完全一致$SAFEDIR和$QUARANTINEDIR在文件开头已定义无需修改。保存后测试配置语法sudo amavisd -c /etc/amavisd.conf test # 输出应含 Net::Server: Binding to TCP port 10024 和 amavisd started若报错Cant locate Convert/TNEF.pm说明 Perl 模块未装全若提示No such file or directoryfor socket则路径不匹配。最后启动 amavisdsudo systemctl restart amavisd sudo systemctl enable amavisd验证端口监听sudo ss -tlnp | grep :10024 # 应显示 amavisd 进程监听 10024 端口2.3 将 RainLoop 集成进 Nginx替换 Roundcube 为 RainLoop并启用 HTTPS 强制跳转EwoMail v1.1.5 默认 Webmail 是 Roundcube但标题明确提及 RainLoop说明用户有轻量、快速、API 友好的需求。RainLoop 本身是 PHP 应用无需数据库但必须通过 Nginx 正确传递PATH_INFO并启用fastcgi_split_path_info。首先确认 RainLoop 已解压到/opt/ewomail/webmail/rainloopv1.1.5 安装包内含此目录。然后编辑/etc/nginx/conf.d/ewomail.conf在server块内找到原 Roundcube 的 location 配置类似location /webmail { ... }注释掉整段 Roundcube 配置新增 RainLoop 配置location /webmail { alias /opt/ewomail/webmail/rainloop/; index index.php; location ~ ^/webmail/(.\.php)$ { try_files $uri 404; fastcgi_split_path_info ^(.\.php)(/.)$; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $request_filename; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_pass unix:/var/run/php-fpm.sock; fastcgi_intercept_errors off; } location ~* ^/webmail/(.\.(?:js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot))$ { expires 1y; add_header Cache-Control public, immutable; try_files $uri 404; } }注意fastcgi_pass的 socket 路径需与你的 PHP-FPM 实际路径一致。EwoMail v1.1.5 默认使用/var/run/php-fpm.sockCentOS或/run/php/php7.4-fpm.sockUbuntu请用sudo ss -ltpn | grep php确认。强制 HTTPS关键安全项server { listen 80; server_name your-mail-domain.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name your-mail-domain.com; ssl_certificate /opt/ewomail/ssl/fullchain.pem; ssl_certificate_key /opt/ewomail/ssl/privkey.pem; # 其他 SSL 配置... }重载 Nginxsudo nginx -t sudo systemctl reload nginx此时访问https://your-mail-domain.com/webmail应看到 RainLoop 登录页。首次登录时管理员账户为admin密码在/opt/ewomail/webmail/rainloop/data/_default_/configs/application.ini中明文存储搜索password 建议登录后立即修改。3. 验证邮件流是否真正贯通用 telnet 模拟 SMTP 发信用 amavisd-debug 查看扫描日志用 RainLoop 抓包分析 IMAP FETCH 响应安装完成不等于可用。EwoMail v1.1.5 的典型故障是“能发不能收”或“收件箱为空”根源往往在 Postfix → amavisd → Dovecot 的管道断裂。必须用底层协议工具逐段验证而非仅依赖 Web 界面按钮。3.1 用 telnet 手动触发 SMTP 流程确认 amavisd 是否介入投递在服务器本地执行telnet localhost 25输入以下命令每行后按回车注意空行HELO example.com MAIL FROM:testyour-mail-domain.com RCPT TO:useryour-mail-domain.com DATA Subject: Test from telnet This is a test email. . QUIT提示DATA后需空一行再输入正文最后单独一行英文句点.结束。若卡在RCPT TO阶段说明 Postfix 未将邮件转发给 amavisd若DATA后无响应可能是 amavisd 未监听 10024 或超时。检查 Postfix 日志确认路由sudo tail -f /var/log/maillog | grep -E (postfix/smtp|amavisd) # 正常应看到postfix/smtp[xxxx]: touser..., relay127.0.0.1[127.0.0.1]:10024若无relay127.0.0.1:10024说明 Postfix 未配置content_filter。编辑/etc/postfix/main.cf确保含content_filter smtp-amavis:[127.0.0.1]:10024并重载 Postfixsudo postfix reload3.2 解析 amavisd 日志中的扫描决策从 PASS 到 CLEAN 的语义差异amavisd 日志/var/log/amavis.log是诊断核心。v1.1.5 的日志级别默认为2info需关注Passed CLEAN、Blocked INFECTED、Blocked BANNED三类记录。例如Dec 15 10:22:33 mail amavis[12345]: (12345-01) Passed CLEAN {RelayedInternal}, ...Passed CLEAN表示邮件通过所有检查病毒、垃圾邮件、附件类型已交由 Postfix 投递。Blocked INFECTEDclamd 检出病毒邮件被隔离至/var/virusmails。Blocked BANNED附件类型被banned_files规则拦截如.exe,.scr。若日志中大量出现Passed UNCHECKED说明bypass_virus_checks_maps (1)仍生效若出现NOQUEUE: reject: RCPT则是 amavisd 未响应需检查systemctl status amavisd和ss -tlnp | grep :10024。启用 debug 日志临时排查修改/etc/amavisd.conf$debug_mode 1; $log_level 5;重启 amavisd 后日志将输出每封邮件的详细扫描步骤包括 clamd 返回的原始响应。3.3 用 RainLoop 的开发者工具抓取 IMAP 流量验证 Dovecot 是否返回邮件列表RainLoop 作为 MUA其行为直接反映 Dovecot 状态。打开浏览器开发者工具F12切换到 Network 标签登录 RainLoop 后点击收件箱观察xhr请求。关键请求 URL 类似GET /webmail/?routemail/listfolderINBOXoffset0limit20sortdateorderDESC响应体应为 JSON含data: [...]数组。若返回空数组[]但mail.log显示邮件已投递成功则问题在 Dovecot 的 mailbox 配置。检查 Dovecot 邮箱路径sudo doveadm mailbox list -u useryour-mail-domain.com # 应返回 INBOX, Sent, Drafts 等若报错Error: User doesnt exist说明 Postfix 未正确创建虚拟用户。EwoMail v1.1.5 使用 MySQL 存储用户检查mysql -u root -p ewomail -e SELECT username,maildir FROM mailbox WHERE usernameuseryour-mail-domain.com;maildir字段值如useryour-mail-domain.com/必须与 Dovecot 的mail_location匹配。编辑/etc/dovecot/conf.d/10-mail.confmail_location maildir:/var/vmail/%d/%n/Maildir其中%d为域名%n为用户名前缀不含 需与 MySQL 中maildir字段结构一致。若 MySQL 存的是userdomain.com/则需改为mail_location maildir:/var/vmail/%d/%n%d/Maildir重启 Dovecotsudo systemctl restart dovecot4. 生产环境必须调整的 5 个参数clamd 内存限制、amavisd 超时阈值、RainLoop 会话有效期、Postfix 队列寿命、Dovecot 空闲超时EwoMail v1.1.5 的默认参数面向测试环境直接用于生产会导致内存溢出、邮件堆积、Web 会话中断等问题。以下是经线上验证的最小必要调优项全部基于 v1.1.5 的原始配置文件路径。4.1 clamd限制扫描进程内存防止大附件耗尽 RAMClamAV 对大于 25MB 的邮件附件默认启用--stream模式易触发 OOM。编辑/etc/clamd.d/scan.conf# 原始值StreamMaxLength 25M → 改为 StreamMaxLength 10M # 新增内存限制单位字节 MaxScanSize 10485760 MaxFileSize 10485760 MaxRecursion 16 MaxFiles 10000重启 clamd 后用ps aux | grep clamd观察进程 RSS 是否稳定在 300MB 以内。4.2 amavisd延长超时避免大邮件被截断默认smtp_timeout为 300 秒大附件邮件如 50MB可能超时。编辑/etc/amavisd.conf# 在 $inet_socket_port 10024; 下方添加 $smtp_timeout 1200; # 20分钟 $final_timeout 1800; # 30分钟 $child_timeout 1200; # 子进程超时同时增大 Perl 进程堆栈echo ulimit -s 8192 | sudo tee -a /etc/security/limits.conf4.3 RainLoop延长会话适配企业级单点登录RainLoop 默认会话 30 分钟过期与企业 SSO 不匹配。编辑/opt/ewomail/webmail/rainloop/data/_default_/configs/application.ini[security] session_life_time 14400 ; 4小时秒 session_same_site Lax cookie_secure On ; 强制 HTTPS Cookie cookie_httponly On4.4 Postfix缩短队列保留时间加速失败邮件反馈默认maximal_queue_lifetime 5d邮件失败后用户 5 天才收到退信。改为# 编辑 /etc/postfix/main.cf maximal_queue_lifetime 12h bounce_queue_lifetime 2h maximal_backoff_time 30m4.5 Dovecot收紧空闲连接释放 IMAP 并发数Dovecot 默认idle_timeout 30m大量空闲连接占用 fd。改为# 编辑 /etc/dovecot/conf.d/10-master.conf service imap-login { inet_listener imap { # ... } inet_listener imaps { # ... } service_count 1 } # 编辑 /etc/dovecot/conf.d/10-mail.conf mail_max_userip_connections 20 protocol imap { idle_timeout 10m logout_format bytes%i/%o }应用所有变更后依次重启服务sudo systemctl restart clamd amavisd postfix dovecot nginx此时 EwoMail v1.1.5 才真正具备支撑 50 人团队邮件系统的稳定性基础。本文还有配套的精品资源点击获取
EwoMail v1.1.5 邮件系统深度调优：clamd、amavisd 与 RainLoop 集成实战
简介EwoMail v1.1.5 是一套完整、可部署的企业级开源邮件服务器解决方案面向计算机专业学生、毕业设计开发者及中小型IT运维人员用于实践邮件系统架构、协议实现SMTP/IMAP/POP3与Web管理平台二次开发。资源包共1630个文件以921个PHP后端逻辑文件为核心辅以177个JS交互脚本、125个HTML页面模板、112个PNG图标资源及46个YML配置文件涵盖服务端、数据库映射、Web界面、安全策略SSL/SPF/Amavis、日志与防火墙规则等完整模块压缩包大小为18.99MB。已有267人学习下载适合开展毕业设计、课程案例分析或Linux邮件服务实战部署。读者可直接基于源码理解邮件收发流程、阅读配套说明.htm安装文档、调试PostfixDovecotRainLoop集成架构并参考mysql-mailbox-maps.cf等配置样例掌握企业级邮箱账户体系设计方法。1. EwoMail v1.1.5 不是“一键安装就完事”的邮件系统而是需要你亲手调通 clamd amavisd RainLoop 的生产级 Linux 邮件栈EwoMail v1.1.5 是一个面向中小团队的开源邮件服务器套件它把 Postfix、Dovecot、MySQL、ClamAV、Amavis、Roundcube及可选 RainLoop打包进统一 Web 管理界面。但很多用户下载ewomail-1.1.5.zip后在 CentOS 7 或 Ubuntu 20.04 上解压运行install.sh发现 Web 界面能打开、域名能解析、SMTP/IMAP 端口也监听了却收不到外网发来的邮件——根本原因不是安装失败而是clamdClamAV 守护进程未启动、amavisd内容过滤网关因缺少病毒库路径配置而静默退出、RainLoop 因未显式启用 HTTPS 和反向代理而无法加载 Webmail。这版 v1.1.5 的核心价值不在“开箱即用”而在提供一套可审计、可调试、可替换组件的邮件基础设施骨架。适合运维工程师、内部 IT 支持人员或 DevOps 工程师要求你熟悉 Linux 服务管理、TCP 端口依赖链、以及邮件协议中 MTA/MDA/MUA 的分层逻辑。如果你只想要一个邮箱账号用企业微信或阿里云邮箱更省心但如果你要控制邮件内容扫描策略、自定义反垃圾规则、或把 Webmail 嵌入现有 SSO 体系EwoMail v1.1.5 就是你绕不开的起点。2. 拆解 EwoMail v1.1.5 的三大关键服务clamd 必须以非 root 用户运行amavisd 依赖 Perl 模块与 socket 路径硬编码RainLoop 需手动绑定到 Nginx 反向代理EwoMail v1.1.5 的架构不是黑盒它的install.sh实际执行的是对标准 Linux 服务的封装调用。理解clamd、amavisd和RainLoop的真实角色与协作关系是后续排错的基础。这三者并非并列组件而是形成一条「入站邮件过滤流水线」Postfix 接收邮件 → 交由 amavisd 扫描 → amavisd 调用本地 clamd 进行病毒检测 → 扫描通过后投递至 Dovecot 邮箱 → 用户通过 RainLoop Web 界面访问。v1.1.5 的设计缺陷在于clamd 默认以clamav用户启动但 amavisd 的配置文件/etc/amavisd.conf中硬编码了bypass_virus_checks_maps (1);即默认跳过病毒扫描且其av_scanners列表里 clamd socket 路径写为/var/run/clamav/clamd.sock而实际安装后该路径可能不存在或权限不对RainLoop 则被静态部署在/opt/ewomail/webmail但 Nginx 配置/etc/nginx/conf.d/ewomail.conf仅将/webmail路径指向 Roundcube未包含 RainLoop 的 location 块。这些都不是 bug而是 v1.1.5 为兼容性做的妥协——它假设你已提前准备好 ClamAV 病毒库、理解 Perl 配置语法、并会手动编辑 Nginx。2.1 验证并修复 clamd 服务从病毒库更新失败到 socket 权限拒绝的完整链路EwoMail v1.1.5 自带的 ClamAV 版本为 0.102.4其clamd守护进程必须以clamav用户运行且依赖/var/lib/clamav下的病毒库文件main.cvd,daily.cvd,bytecode.cvd。常见失败场景是systemctl status clamd显示active (exited)但clamd --version正常——这说明服务启动后立即退出根源通常是病毒库缺失或权限错误。首先检查病毒库状态sudo -u clamav /usr/bin/freshclam --no-daemon --verbose提示freshclam必须以clamav用户运行否则会因无法写入/var/lib/clamav而失败。若提示ERROR: Cant open /var/lib/clamav/main.cvd说明病毒库未下载。若 freshclam 失败手动初始化病毒库sudo mkdir -p /var/lib/clamav sudo chown clamav:clamav /var/lib/clamav sudo chmod 755 /var/lib/clamav sudo -u clamav /usr/bin/freshclam -d -c 2等待 2–3 分钟后检查 socket 文件是否存在ls -l /var/run/clamav/clamd.sock # 正常应显示srw-rw---- 1 clamav clamav 0 ... /var/run/clamav/clamd.sock若 socket 不存在修改/etc/clamd.d/scan.conf# 取消注释并确保以下三行存在 LocalSocket /var/run/clamav/clamd.sock LocalSocketGroup clamav LocalSocketMode 660然后重启服务sudo systemctl daemon-reload sudo systemctl restart clamd sudo systemctl enable clamd验证 clamd 是否真正响应echo PING | sudo socat - UNIX:/var/run/clamav/clamd.sock # 应返回 PONG2.2 重写 amavisd 配置绕过硬编码路径显式声明 clamd socket 与 Perl 模块依赖amavisd 是 EwoMail 的内容过滤中枢v1.1.5 的/etc/amavisd.conf存在两处关键问题一是bypass_virus_checks_maps (1);导致病毒扫描被全局禁用二是av_scanners中 clamd 的 socket 路径未适配实际位置。此外amavisd 依赖Convert::TNEF、Archive::Zip等 Perl 模块CentOS 7 默认不预装需手动补全。先安装缺失 Perl 模块CentOS 7sudo yum install epel-release -y sudo yum install perl-Convert-TNEF perl-Archive-Zip perl-IO-Compress-Zlib perl-MIME-Base64 -yUbuntu 20.04 则用sudo apt-get install libconvert-tnef-perl libarchive-zip-perl libio-compress-zlib-perl libmime-base64-perl -y编辑/etc/amavisd.conf定位到bypass_virus_checks_maps行将其改为bypass_virus_checks_maps (0); # 关键关闭绕过启用扫描再找到av_scanners定义段通常在文件中部将 clamd 条目替换为[ClamAV-clamd, \ask_daemon, [CONTSCAN {}\n, /var/run/clamav/clamd.sock], qr/\bOK$/m, qr/\bFOUND$/m, [\n$SAFEDIR/, \n$QUARANTINEDIR/], qr/^.*?: (?!Infected Archive)(.*) FOUND$/m ],注意/var/run/clamav/clamd.sock必须与上一步clamd实际创建的 socket 路径完全一致$SAFEDIR和$QUARANTINEDIR在文件开头已定义无需修改。保存后测试配置语法sudo amavisd -c /etc/amavisd.conf test # 输出应含 Net::Server: Binding to TCP port 10024 和 amavisd started若报错Cant locate Convert/TNEF.pm说明 Perl 模块未装全若提示No such file or directoryfor socket则路径不匹配。最后启动 amavisdsudo systemctl restart amavisd sudo systemctl enable amavisd验证端口监听sudo ss -tlnp | grep :10024 # 应显示 amavisd 进程监听 10024 端口2.3 将 RainLoop 集成进 Nginx替换 Roundcube 为 RainLoop并启用 HTTPS 强制跳转EwoMail v1.1.5 默认 Webmail 是 Roundcube但标题明确提及 RainLoop说明用户有轻量、快速、API 友好的需求。RainLoop 本身是 PHP 应用无需数据库但必须通过 Nginx 正确传递PATH_INFO并启用fastcgi_split_path_info。首先确认 RainLoop 已解压到/opt/ewomail/webmail/rainloopv1.1.5 安装包内含此目录。然后编辑/etc/nginx/conf.d/ewomail.conf在server块内找到原 Roundcube 的 location 配置类似location /webmail { ... }注释掉整段 Roundcube 配置新增 RainLoop 配置location /webmail { alias /opt/ewomail/webmail/rainloop/; index index.php; location ~ ^/webmail/(.\.php)$ { try_files $uri 404; fastcgi_split_path_info ^(.\.php)(/.)$; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $request_filename; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_pass unix:/var/run/php-fpm.sock; fastcgi_intercept_errors off; } location ~* ^/webmail/(.\.(?:js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot))$ { expires 1y; add_header Cache-Control public, immutable; try_files $uri 404; } }注意fastcgi_pass的 socket 路径需与你的 PHP-FPM 实际路径一致。EwoMail v1.1.5 默认使用/var/run/php-fpm.sockCentOS或/run/php/php7.4-fpm.sockUbuntu请用sudo ss -ltpn | grep php确认。强制 HTTPS关键安全项server { listen 80; server_name your-mail-domain.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name your-mail-domain.com; ssl_certificate /opt/ewomail/ssl/fullchain.pem; ssl_certificate_key /opt/ewomail/ssl/privkey.pem; # 其他 SSL 配置... }重载 Nginxsudo nginx -t sudo systemctl reload nginx此时访问https://your-mail-domain.com/webmail应看到 RainLoop 登录页。首次登录时管理员账户为admin密码在/opt/ewomail/webmail/rainloop/data/_default_/configs/application.ini中明文存储搜索password 建议登录后立即修改。3. 验证邮件流是否真正贯通用 telnet 模拟 SMTP 发信用 amavisd-debug 查看扫描日志用 RainLoop 抓包分析 IMAP FETCH 响应安装完成不等于可用。EwoMail v1.1.5 的典型故障是“能发不能收”或“收件箱为空”根源往往在 Postfix → amavisd → Dovecot 的管道断裂。必须用底层协议工具逐段验证而非仅依赖 Web 界面按钮。3.1 用 telnet 手动触发 SMTP 流程确认 amavisd 是否介入投递在服务器本地执行telnet localhost 25输入以下命令每行后按回车注意空行HELO example.com MAIL FROM:testyour-mail-domain.com RCPT TO:useryour-mail-domain.com DATA Subject: Test from telnet This is a test email. . QUIT提示DATA后需空一行再输入正文最后单独一行英文句点.结束。若卡在RCPT TO阶段说明 Postfix 未将邮件转发给 amavisd若DATA后无响应可能是 amavisd 未监听 10024 或超时。检查 Postfix 日志确认路由sudo tail -f /var/log/maillog | grep -E (postfix/smtp|amavisd) # 正常应看到postfix/smtp[xxxx]: touser..., relay127.0.0.1[127.0.0.1]:10024若无relay127.0.0.1:10024说明 Postfix 未配置content_filter。编辑/etc/postfix/main.cf确保含content_filter smtp-amavis:[127.0.0.1]:10024并重载 Postfixsudo postfix reload3.2 解析 amavisd 日志中的扫描决策从 PASS 到 CLEAN 的语义差异amavisd 日志/var/log/amavis.log是诊断核心。v1.1.5 的日志级别默认为2info需关注Passed CLEAN、Blocked INFECTED、Blocked BANNED三类记录。例如Dec 15 10:22:33 mail amavis[12345]: (12345-01) Passed CLEAN {RelayedInternal}, ...Passed CLEAN表示邮件通过所有检查病毒、垃圾邮件、附件类型已交由 Postfix 投递。Blocked INFECTEDclamd 检出病毒邮件被隔离至/var/virusmails。Blocked BANNED附件类型被banned_files规则拦截如.exe,.scr。若日志中大量出现Passed UNCHECKED说明bypass_virus_checks_maps (1)仍生效若出现NOQUEUE: reject: RCPT则是 amavisd 未响应需检查systemctl status amavisd和ss -tlnp | grep :10024。启用 debug 日志临时排查修改/etc/amavisd.conf$debug_mode 1; $log_level 5;重启 amavisd 后日志将输出每封邮件的详细扫描步骤包括 clamd 返回的原始响应。3.3 用 RainLoop 的开发者工具抓取 IMAP 流量验证 Dovecot 是否返回邮件列表RainLoop 作为 MUA其行为直接反映 Dovecot 状态。打开浏览器开发者工具F12切换到 Network 标签登录 RainLoop 后点击收件箱观察xhr请求。关键请求 URL 类似GET /webmail/?routemail/listfolderINBOXoffset0limit20sortdateorderDESC响应体应为 JSON含data: [...]数组。若返回空数组[]但mail.log显示邮件已投递成功则问题在 Dovecot 的 mailbox 配置。检查 Dovecot 邮箱路径sudo doveadm mailbox list -u useryour-mail-domain.com # 应返回 INBOX, Sent, Drafts 等若报错Error: User doesnt exist说明 Postfix 未正确创建虚拟用户。EwoMail v1.1.5 使用 MySQL 存储用户检查mysql -u root -p ewomail -e SELECT username,maildir FROM mailbox WHERE usernameuseryour-mail-domain.com;maildir字段值如useryour-mail-domain.com/必须与 Dovecot 的mail_location匹配。编辑/etc/dovecot/conf.d/10-mail.confmail_location maildir:/var/vmail/%d/%n/Maildir其中%d为域名%n为用户名前缀不含 需与 MySQL 中maildir字段结构一致。若 MySQL 存的是userdomain.com/则需改为mail_location maildir:/var/vmail/%d/%n%d/Maildir重启 Dovecotsudo systemctl restart dovecot4. 生产环境必须调整的 5 个参数clamd 内存限制、amavisd 超时阈值、RainLoop 会话有效期、Postfix 队列寿命、Dovecot 空闲超时EwoMail v1.1.5 的默认参数面向测试环境直接用于生产会导致内存溢出、邮件堆积、Web 会话中断等问题。以下是经线上验证的最小必要调优项全部基于 v1.1.5 的原始配置文件路径。4.1 clamd限制扫描进程内存防止大附件耗尽 RAMClamAV 对大于 25MB 的邮件附件默认启用--stream模式易触发 OOM。编辑/etc/clamd.d/scan.conf# 原始值StreamMaxLength 25M → 改为 StreamMaxLength 10M # 新增内存限制单位字节 MaxScanSize 10485760 MaxFileSize 10485760 MaxRecursion 16 MaxFiles 10000重启 clamd 后用ps aux | grep clamd观察进程 RSS 是否稳定在 300MB 以内。4.2 amavisd延长超时避免大邮件被截断默认smtp_timeout为 300 秒大附件邮件如 50MB可能超时。编辑/etc/amavisd.conf# 在 $inet_socket_port 10024; 下方添加 $smtp_timeout 1200; # 20分钟 $final_timeout 1800; # 30分钟 $child_timeout 1200; # 子进程超时同时增大 Perl 进程堆栈echo ulimit -s 8192 | sudo tee -a /etc/security/limits.conf4.3 RainLoop延长会话适配企业级单点登录RainLoop 默认会话 30 分钟过期与企业 SSO 不匹配。编辑/opt/ewomail/webmail/rainloop/data/_default_/configs/application.ini[security] session_life_time 14400 ; 4小时秒 session_same_site Lax cookie_secure On ; 强制 HTTPS Cookie cookie_httponly On4.4 Postfix缩短队列保留时间加速失败邮件反馈默认maximal_queue_lifetime 5d邮件失败后用户 5 天才收到退信。改为# 编辑 /etc/postfix/main.cf maximal_queue_lifetime 12h bounce_queue_lifetime 2h maximal_backoff_time 30m4.5 Dovecot收紧空闲连接释放 IMAP 并发数Dovecot 默认idle_timeout 30m大量空闲连接占用 fd。改为# 编辑 /etc/dovecot/conf.d/10-master.conf service imap-login { inet_listener imap { # ... } inet_listener imaps { # ... } service_count 1 } # 编辑 /etc/dovecot/conf.d/10-mail.conf mail_max_userip_connections 20 protocol imap { idle_timeout 10m logout_format bytes%i/%o }应用所有变更后依次重启服务sudo systemctl restart clamd amavisd postfix dovecot nginx此时 EwoMail v1.1.5 才真正具备支撑 50 人团队邮件系统的稳定性基础。本文还有配套的精品资源点击获取
