简介EwoMail开源邮件服务器软件v1.1.5面向需要搭建企业级邮件系统的开发者、运维人员及计算机专业学生提供一套可自由查看、修改与二次分发的完整邮件服务解决方案。资源包共1630个文件约18.99MB以921个php源码、177个js脚本和125个html页面为主体构成服务端应用与Web管理界面另有46个yml、26个conf及多个cf、ini配置文件用于邮件协议与运行参数设定并附带说明文档、图标字体与证书等辅助素材。目前已有269人学习下载。借助源码与安装说明读者可深入理解SMTP、POP3、IMAP4等协议的收发存储流程掌握邮件过滤、数据库接口与后台管理的实现方式也可将其作为毕业设计或课程案例研究邮件服务器的设计原则、安全策略与性能优化思路适合作为建站与系统工具方向的实践参考。1. EwoMail v1.1.5 到底解决了谁的痛点从一台裸机到能收能发的邮件系统手里只有一台干净的 Linux 云主机想让它变成能对外收发信的邮件服务器这件事的门槛从来不在装软件而在“装完之后为什么发不出去、为什么进垃圾箱”。EwoMail 这个开源邮件服务器软件v1.1.5 这个压缩包本质上就是把 Postfix、Dovecot、MySQL、Amavisd、SpamAssassin、Roundcube 这一整套东西打包成一套可脚本化部署的方案让你不用从零去啃每个组件的配置文件。它适合两类人一类是中小团队里需要自建企业邮箱、又不想每年交SaaS订阅费的运维另一类是正在学邮件协议、想拿一套能跑通的完整系统做实验的工程师。这篇笔记不吹它多完美只讲清楚从解压到能发第一封信中间哪些参数必须改、哪些坑一定会踩。热搜里“EwoMail”“开源邮件服务器软件”这两个词背后真实诉求就一句话有没有一套能照着做、不翻车的自建邮件方案。2. 部署前的硬性前提域名、端口与系统环境怎么定2.1 为什么域名和 PTR 记录比软件本身更关键邮件能不能送达第一道关卡不是你的服务器配置而是对方邮件网关信不信你。EwoMail 装好之后Postfix 负责 SMTP 投递但对方收到连接时会做三件事查你的 IP 有没有 PTR 反向解析、查你的域名有没有 SPF 记录、查你发信时 HELO 名和 IP 是否匹配。这三样任何一样缺失你的信大概率直接进垃圾箱甚至被拒收。所以部署前必须先确认你有一个能改 DNS 的域名云主机有固定公网 IP并且能向云厂商提交 PTR 解析申请。很多新手上来就解压安装装完发现能登录 Webmail 但发不出去回头查半天问题根本不在 EwoMail而在 DNS 没配。PTR 记录的做法是在云厂商控制台提交工单把公网 IP 反解到mail.你的域名.com。SPF 记录是在域名 DNS 里加一条 TXT内容形如vspf1 mx ~all。这两步做完再动 EwoMail。我一般会先用dig -x 你的公网IP确认 PTR 生效再用dig txt 你的域名确认 SPF 能查到两个都通了才继续。2.2 系统版本、端口开放与防火墙的取舍EwoMail v1.1.5 这类打包方案通常对系统版本有偏好常见做法是选 CentOS 7 系列因为它的安装脚本里大量依赖 yum 源和旧版库。如果你用 Ubuntu 22.04 直接跑很可能在装 MySQL 或 Amavisd 那一步就报依赖冲突。这不是说别的系统绝对不行而是你要做好手动补依赖的准备。端口方面邮件系统要用的不止 25SMTP 是 25SMTPS 是 465Submission 是 587IMAP 是 143IMAPS 是 993POP3 是 110POP3S 是 995Webmail 一般是 80 或 443管理后台可能另占一个端口。云厂商的安全组和系统防火墙要同时放行只改一处等于没改。# 查看当前防火墙规则确认邮件相关端口是否放行 firewall-cmd --list-ports # 放行 SMTP、IMAP、Web 等常用端口按需调整 firewall-cmd --permanent --add-port25/tcp firewall-cmd --permanent --add-port465/tcp firewall-cmd --permanent --add-port587/tcp firewall-cmd --permanent --add-port993/tcp firewall-cmd --permanent --add-port995/tcp firewall-cmd --permanent --add-port80/tcp firewall-cmd --permanent --add-port443/tcp firewall-cmd --reload上面这段命令的逻辑是先看现状再逐条加规则最后 reload 让配置生效。参数上--permanent表示持久化不加的话重启就丢--add-port后面跟端口和协议邮件端口基本都是 TCP。如果你用的是云厂商安全组还要去控制台再放行一遍两层防火墙是独立的。失败时先firewall-cmd --list-ports看规则在不在再用telnet 你的IP 25从外部测连通性通了才说明端口真的开了。2.3 主机名设置一个被低估的必改项安装前必须把主机名改成mail.你的域名.com这种形式而不是默认的localhost或云厂商给的随机名。原因是 Postfix 在 HELO 阶段会报自己的主机名如果这个名字和你的 PTR 记录对不上对方会判定为可疑。改主机名用hostnamectl set-hostname mail.example.com然后编辑/etc/hosts把127.0.0.1那行后面补上完整主机名。这一步做完再装 EwoMail否则装完再改部分配置文件里的旧主机名不会自动更新得手动去 Postfix 的myhostname参数里改。3. 解压到跑通EwoMail v1.1.5 的安装流程与关键配置3.1 上传压缩包、解压与安装脚本执行拿到EwoMail开源邮件服务器软件 v1.1.5.zip之后先上传到服务器比如放到/root下。解压需要unzip没装的话先yum install -y unzip。解压后会得到一个目录里面通常有安装脚本和配置文件。执行安装脚本前建议先screen -S ewo开一个会话因为安装过程可能十几分钟SSH 断线会中断安装这是血泪经验。# 安装解压工具并解压 yum install -y unzip cd /root unzip EwoMail开源邮件服务器软件 v1.1.5.zip # 进入解压后的目录查看安装脚本 ls -l # 常见脚本名为 install.sh 或 setup.sh执行前先看权限 chmod x install.sh ./install.sh这段代码的逻辑是先补依赖再解压再给脚本执行权限最后运行。参数上chmod x是给脚本加可执行权限不加会报 Permission denied。安装脚本内部一般会做几件事配置 yum 源、安装 MySQL、导入初始数据库、安装 Postfix/Dovecot、部署 Webmail。执行过程中要盯着输出如果某一步卡住超过几分钟大概率是网络拉包慢或源不可用可以 CtrlC 中断后检查/etc/yum.repos.d/下的源配置。安装完成后脚本通常会打印管理后台地址和默认账号这些信息要立刻记下来。3.2 数据库、域名与管理员账号的初始化EwoMail 这类系统一般用 MySQL 存域名、用户、别名等信息。安装脚本跑完后需要确认数据库服务是否启动以及初始库是否导入成功。常见做法是用systemctl status mysqld看状态再用mysql -uroot -p登录执行show databases;看有没有邮件系统相关的库。如果库不存在说明安装脚本那一步失败了要回去看日志。接着是添加域名和管理员账号这一步通常在 Web 管理后台操作登录后先加域名再加邮箱用户。域名必须是你已经配好 MX 记录的那个MX 记录指向mail.你的域名.com优先级填 10 即可。# 检查 MySQL 服务状态 systemctl status mysqld # 登录数据库查看邮件系统相关库是否存在 mysql -uroot -p show databases; # 如果看到类似 ewo_mail 或 mail 的库说明初始化成功 exit # 检查 Postfix 和 Dovecot 是否在运行 systemctl status postfix systemctl status dovecot这段命令的作用是逐项验证核心组件。参数上systemctl status看的是服务当前状态active (running) 才算正常。如果 Postfix 没起来先看/var/log/maillog里的报错常见原因是配置文件语法错误或端口被占用。Dovecot 没起来则看/var/log/dovecot.log。数据库登录后如果库不存在不要急着重装先看安装脚本的日志文件通常在/root或/tmp下里面会写哪一步失败。3.3 发第一封信从 Webmail 到外部邮箱的完整验证装完不等于能用必须做一次完整的收发验证。登录 Webmail用刚创建的用户发一封信到你自己的外部邮箱比如 QQ 邮箱或 Gmail。然后去外部邮箱看是否收到如果没收到去查/var/log/maillog看 Postfix 的投递日志。常见情况有三种一是连接被对方拒绝日志里会有Connection refused或550二是进了垃圾箱日志显示statussent但对方没进收件箱三是卡在队列里日志显示deferred。第一种查 PTR 和 SPF第二种查内容里有没有敏感词或链接过多第三种看网络是否通、对方 MX 是否可达。# 实时查看邮件日志发信时观察输出 tail -f /var/log/maillog # 查看邮件队列有积压时用 mailq # 强制重试队列中的邮件 postqueue -f这段代码的逻辑是发信的同时盯日志能立刻看到投递结果。tail -f是持续输出CtrlC 退出。mailq列出队列里的邮件如果看到大量 deferred说明投递有问题。postqueue -f是手动触发重试适合修完配置后让积压邮件重新投递。参数上没有需要改的但要注意日志里的关键词statussent表示已投递到对方服务器statusbounced表示被拒statusdeferred表示暂时失败会重试。4. 避坑与排查EwoMail 部署中最容易翻车的五个点4.1 现象Webmail 能登录但发不出信日志显示 Connection timed out原因云厂商默认封禁 25 端口出站这是最常见的情况。很多云主机为了防垃圾邮件对 25 端口出站做了限制导致 Postfix 无法连接对方 MX。解决先向云厂商提交工单申请解封 25 端口出站如果解不了就配置中继服务把 Postfix 的relayhost指向一个允许你使用的 SMTP 中继。改完relayhost后systemctl restart postfix再用mailq和postqueue -f重试。4.2 现象外部能发进来但自己发出去的信全进垃圾箱原因PTR、SPF、DKIM 三件套没配齐。PTR 前面说过SPF 是 TXT 记录DKIM 需要在 EwoMail 里生成密钥并在 DNS 里加 TXT。解决先补 PTR 和 SPF这两样最快见效。DKIM 在管理后台一般有生成选项生成后把公钥填到 DNS 的 TXT 记录里主机名通常是default._domainkey。三样都配好后用dig验证一遍再发测试信。4.3 现象安装脚本跑到一半报错退出提示依赖冲突原因系统版本和脚本预期的版本不一致常见于用 Ubuntu 或 CentOS 8 跑为 CentOS 7 写的脚本。解决换 CentOS 7 重装是最省事的做法。如果必须用当前系统就手动装缺失的依赖比如yum install -y perl-DBI perl-Net-SSLeay这类具体缺什么看报错信息。装完依赖再重新跑脚本但要注意脚本可能有幂等性问题重复跑之前先看它有没有清理逻辑。4.4 现象管理后台打不开浏览器提示无法连接原因管理后台的端口没放行或者服务没启动。解决先systemctl status看对应服务比如 nginx 或 httpd 是否在跑。再看防火墙和云安全组是否放行了后台端口。如果服务没起来看它的日志常见是配置文件里绑定的 IP 不对或端口被占用。改完配置后重启服务再测。4.5 现象用户能收信但收件箱里邮件重复出现原因Dovecot 的配置里同时启用了多个协议或客户端重复拉取。解决检查 Dovecot 的mail_location配置确认没有多个进程同时写同一个邮箱目录。另外如果用户用 POP3 拉取又没删服务器邮件换 IMAP 客户端时会出现重复。统一用 IMAP并在客户端设置里关掉“在服务器保留副本”的重复选项。5. 进阶技巧用日志和队列把投递问题定位到具体环节5.1 用 maillog 的关键字段快速判断故障层邮件日志看起来乱但抓住几个字段就能快速分层。from和to告诉你谁发给谁relay告诉你下一跳是谁status是最终结果。如果statussent但对方没收到问题在对方网关或垃圾箱如果statusdeferred看dsn后面的原因常见有Connection timed out、Host not found、550。我一般会先grep出某封信的所有日志行按时间顺序看它经历了哪些环节。# 按收件人过滤日志追踪一封信的完整投递路径 grep userexample.com /var/log/maillog # 统计最近 deferred 的原因分布 grep statusdeferred /var/log/maillog | awk -Fdsn {print $2} | sort | uniq -c | sort -rn第一段命令是追踪单封信把和某个收件人相关的日志全拉出来按时间读一遍就知道卡在哪。第二段是统计 deferred 的原因awk -Fdsn按 dsn 字段切分取后半部分再排序计数。这样你能一眼看出是超时多还是拒绝多超时就查网络和端口拒绝就查对方策略和你的信誉。参数上grep的匹配词换成实际收件人即可awk的切分符按日志实际格式调整。5.2 队列管理什么时候该 flush什么时候该删mailq看到队列里有邮件时不要急着删。先看数量如果几十封且都是 deferred修完配置后postqueue -f触发重试大部分能出去。如果某封信反复重试几天都失败它会过期退信你也可以用postsuper -d 队列ID手动删。但删之前最好确认这封信不重要因为删了就没了没有后悔药。我习惯是先修根因再 flush观察一轮确实出不去的再删。5.3 一个具体技巧用 swaks 做 SMTP 手工测试当你不确定是 Postfix 配置问题还是网络问题时用swaks直接对本地 25 端口做一次 SMTP 对话能排除 Webmail 和客户端的干扰。swaks不是系统自带需要yum install -y swaks或从 EPEL 装。用法是swaks --to 目标邮箱 --from 你的邮箱 --server 127.0.0.1它会打印完整的 SMTP 交互过程哪一步被拒一目了然。# 安装 swaks 并对本地 SMTP 做一次测试投递 yum install -y swaks swaks --to testexample.com --from admin你的域名.com --server 127.0.0.1 --auth LOGIN --auth-user admin你的域名.com --auth-password 你的密码这段命令的逻辑是绕过 Webmail直接和本地 Postfix 对话看它接不接受认证和投递。参数上--server 127.0.0.1表示连本机--auth LOGIN是认证方式--auth-user和--auth-password填邮箱账号密码。如果这一步成功但外部收不到问题就在出站网络或对方策略如果这一步就失败问题在 Postfix 或认证配置。这个工具我用了很多年定位 SMTP 问题比翻日志快得多。5.4 长期运行要盯的两件事日志轮转和磁盘空间邮件系统跑起来之后/var/log/maillog和邮箱目录会持续增长。日志轮转一般由 logrotate 管但邮箱目录不会自动清。如果用户用 POP3 拉信又不删磁盘迟早满。我一般会定期du -sh看邮箱目录大小再配一个监控磁盘超过 80% 就告警。另外MySQL 的邮件库也会涨定期optimize table能回收一些空间。这些事不紧急但不管的话某天磁盘满了Postfix 和 MySQL 一起挂那就不是发不出信的问题了是整个服务不可用。希望帮到你。本文还有配套的精品资源点击获取