简介：这份文档面向需要自行搭建邮件服务器的运维人员与邮件系统初学者，围绕开源邮件服务器 hMailServer 的完整配置流程展开，帮助读者从零理解并完成一套可用的邮件服务部署。压缩包内仅含 1 个 doc 文件，约 263KB，以图文笔记形式集中记录配置要点，便于离线查阅与打印。内容覆盖 hMailServer 的下载与版本选择、SMTP 收发原理说明，以及添加域和用户、配置协议、SMTP、Routes、认证与 Log 等核心环节，并延伸到服务器管理与客户端配置，特别提示账号需按 xxx@server.com 格式书写、关闭服务器认证等易错细节。目前已有 2645 人学习，适合作为搭建与排错时的对照参考，帮助读者快速理清配置顺序、规避常见认证与路由问题。

1. 从一台 Windows 机器说起：hMailServer 4.4.1 装之前先想清楚三件事

上周帮一个朋友收拾他搁置了半年的内部邮件服务，机器是台 Windows Server，装的是 hMailServer 4.4.1-B273，结果域加进去了、用户也建了，客户端就是连不上，日志里翻来覆去就那几行认证失败。这种场景太常见了——hMailServer 本身安装包不大、向导也友好，真正让人翻车的是装完之后那一堆协议、路由、认证的开关，一个勾选错了，整条链路就断在那里。这篇笔记就按我自己的习惯，从版本选择、安装、域与用户、SMTP 与 Routes、认证与日志一路写到客户端验证，把 hMailServer 4.4.1 这套环境完整走一遍，适合第一次搭内部邮件服务、或者接手了一台半成品邮件服务器需要排查的开发者照着复现。

2. 装前准备：hMailServer 4.4.1 的版本选择与安装落地

2.1 为什么锁定 4.4.1-B273 这个版本

hMailServer 的版本迭代里，4.4.x 是一条比较稳的分支，B273 这个 build 在当年属于 4.4.1 的正式发布包，安装文件名就是hMailServer-4.4.1-B273.exe。我一般不建议在这种内部邮件场景里追最新版，原因很实际：邮件服务一旦跑起来，升级意味着要停服务、备份数据库、重新验证一遍认证和路由，收益却往往只是几个用不上的新特性。4.4.1 的安装包自带服务注册、自带管理客户端，功能上覆盖 SMTP、POP3、IMAP 三件套，对内部通知、系统告警邮件这类用途完全够用。

选版本时还有两个细节要盯住。第一是操作系统位数，4.4.1 时代的安装包以 32 位为主，装在 64 位 Windows 上会走 WOW64 兼容层，能跑，但服务路径和注册表位置要心里有数，后面排查权限问题时别找错地方。第二是数据库后端，hMailServer 支持内置的 MySQL 精简版，也支持外接 MySQL、MSSQL。内部小规模用内置的就够，省掉一个外部依赖；如果预期用户数上百、或者要和别的系统共库，那就提前规划外接数据库，别等数据攒起来再迁移。

安装前我会先确认三样东西：机器上 25、110、143 这几个端口没有被别的服务占着（Windows 上偶尔会有别的邮件组件或测试工具占 25）；安装账户有本地管理员权限，因为安装过程要注册 Windows 服务；以及准备一个固定的域名，比如内部用的corp.local这类，后面加域、配账号格式都围绕它来。

2.2 安装过程与服务注册

安装本身没什么玄学，双击hMailServer-4.4.1-B273.exe，一路下一步，中途会让你设一个管理密码，这个密码是管理客户端连服务端用的，记牢。安装向导结束前会问要不要把 hMailServer 注册为 Windows 服务，默认是勾上的，保持勾选。

# 安装完成后确认服务已经注册并处于运行状态 sc query hMailServer # 期望看到 STATE : 4 RUNNING # 如果服务没起来，手动拉起 net start hMailServer

这段命令的作用是确认服务注册成功。sc query hMailServer查的是服务名，hMailServer 安装时默认就用这个名字注册，返回RUNNING说明服务端进程已经在后台跑着了。如果返回STOPPED，先net start hMailServer拉起来；如果报“服务不存在”，那多半是安装时没勾服务注册，重新跑一遍安装包选修复，或者手动用hMailServer.exe /Register这类方式补注册。服务跑起来之后，管理程序可以随时关掉，邮件收发不依赖管理界面开着——这一点原文里特意提了，我踩过一次坑：早期以为管理程序关了服务就停，结果白白让管理界面挂了一晚上。

安装完成后目录结构大致是：程序文件在Program Files\hMailServer下，数据目录默认在Program Files\hMailServer\Data，日志在Logs子目录。数据目录建议在正式投用前就改到一个独立分区，邮件多了以后 Data 目录膨胀很快，和程序放一起容易把系统盘撑满。

2.3 管理客户端首次连接

管理程序是hMailServer Administrator，从开始菜单启动，第一次连会弹连接对话框，主机填localhost，密码填安装时设的那个。连上之后左侧树状结构就是全部配置入口：Domains、Settings、Status、Logging 这几大块。我习惯先点 Status 看一眼服务状态和版本号，确认连的是对的实例，再开始动配置。

提示：管理密码如果忘了，官方给的做法是改配置文件里的密码字段再重启服务，但这一步会清掉原有密码，操作前先备份hMailServer.ini。

3. 域、用户与协议：hMailServer 核心配置逐项落地

3.1 添加域：IP 地址这一项别乱填

左侧 Domains 右键 Add，填域名，比如corp.local。域配置页里有一项是绑定 IP，原文说“针对域，只需配置 IP 地址就可以了”，这句话要理解对：这里的 IP 是指这个域在服务端监听时绑定的本地地址，不是让你填公网出口 IP。机器只有一块网卡、一个内网地址时，填那个内网地址或者留空走默认都行；多网卡机器上填错，会出现“本机发得出去、外部连不进来”的怪现象。

; 域配置的关键项（管理界面里对应填写，这里用 ini 形式示意） [Domain] Name=corp.local Postmaster=postmaster@corp.local ; 绑定地址留空表示监听所有本地地址 BindAddress=

Name是域名，客户端账号的 @ 后半段必须和它一致；Postmaster是域管理员邮箱，退信、系统通知会往这发，建议建域之后立刻把这个账号建出来；BindAddress留空最省事，除非机器多网卡且你明确只想在某块网卡上收信。域名一旦投用再改，所有客户端账号都要跟着改，所以这一步宁可多想五分钟。

3.2 建用户：账号格式从这一刻就定死

在域下面 Accounts 右键 Add，填用户名和密码。用户名部分只填 @ 前面那段，比如alert，完整地址就是alert@corp.local。这里有个容易被忽略的点：hMailServer 里账号的“地址”是用户名加域名拼出来的，管理界面里显示的 Address 才是客户端要用的完整账号。原文在客户端配置那节特意强调账号要写成xxx@server.com的形式，根子就在这里——很多客户端默认把用户名当登录名，不带域名，服务端认不出来。

; 账号配置示意 [Account] Address=alert@corp.local Password=******** ; 是否允许该账号通过 POP3/IMAP 取信 POP3Enabled=true IMAPEnabled=true

Address是完整邮件地址，客户端登录名必须和它一致；Password建议用强口令，内部服务也别图省事；POP3Enabled、IMAPEnabled按客户端类型开，只用 SMTP 发通知的账号可以把取信协议关掉，减少暴露面。建完账号我会立刻用管理界面的“测试账号”功能发一封测试信，确认域和账号的拼装没问题，再往下配协议。

3.3 协议配置：SMTP、POP3、IMAP 各管一段

Settings 下面 Protocols 展开就是 SMTP、POP3、IMAP 三块。SMTP 管发信和收信（服务器之间投递也走 SMTP），POP3 和 IMAP 管客户端取信。内部场景里我一般三个都开，但如果只是做“系统告警往外发”的单向用途，POP3 和 IMAP 可以关掉，少两个监听端口。

每个协议页里都有端口和连接数设置。SMTP 默认 25，POP3 默认 110，IMAP 默认 143，内部网络不涉及加密传输的话保持默认即可；要开 SSL 就换 465/995/993，并且得先在 Settings 里配好证书。连接数上限按用户规模调，几十人的内部环境默认值够用，上百人再往上加，别一上来就拉满，连接数开太大反而容易在资源紧张时拖垮服务。

3.4 SMTP 配置：allow plain text authentication 这个勾是重灾区

SMTP 页里最值得单独拎出来说的是认证相关选项。原文给了一条非常具体的经验：对 trac 这类系统的配置来说，“allow plain text authentication”不能选，否则会报错。这条经验放到今天依然成立，而且不只 trac，很多老系统的邮件通知模块在明文认证上有自己的脾气。

; SMTP 认证相关（管理界面 Settings > Protocols > SMTP 下） [SMTP] ; 允许明文认证：对接老系统时按需关闭 AllowPlainTextAuthentication=false ; 要求认证后才能发信（防开放中继） RequireAuthentication=true ; 允许的投递范围 AllowDeliveriesToLocalAccounts=true AllowDeliveriesToRemoteAccounts=true

AllowPlainTextAuthentication设成 false 的意思是服务端不主动接受明文口令认证，客户端得走更安全的认证方式；但注意，这个开关和客户端能力是联动的，某些老客户端只会明文认证，关掉之后就连不上，这时候要么换客户端配置，要么针对特定来源放开。RequireAuthentication一定要开，否则这台服务器就成了开放中继，谁都能借它往外发垃圾邮件，这是邮件服务器最经典的血泪教训。AllowDeliveriesToLocalAccounts和AllowDeliveriesToRemoteAccounts控制投递范围，内部只发内部的话，远程投递可以关掉。

3.5 Routes 配置：邮件出站的路由表

Routes 是 hMailServer 里最容易被跳过、又最容易出问题的一块。它的作用是告诉服务端：发往某个域名的邮件，该交给哪台服务器。内部域之间互发不需要配 Routes，走本地投递；要往外部域发信，就得有一条覆盖目标域的路由，指向能出网的中继服务器，或者直接配成直投。

; Routes 配置示意：把所有非本地域的邮件交给上游中继 [Route] Domain=* TargetSMTPHost=relay.internal.example TargetSMTPPort=25 ; 是否需要认证到上游 RequiresAuthentication=false

Domain填*表示兜底路由，匹配所有没有单独配置的域；TargetSMTPHost是上游中继地址，内部环境里通常是公司统一的邮件网关；RequiresAuthentication看上游要不要认证，要的话还得在路由里填账号密码。配完 Routes 一定要用管理界面的诊断工具发一封到外部域的测试信，看日志里投递是成功还是卡在队列里。我见过最常见的翻车是 Routes 配了但顺序不对，或者Domain写成了具体域名却漏了别的域，结果一部分邮件出得去、一部分出不去。

3.6 认证与日志：出问题时唯一能救你的黑匣子

认证配置在 Settings 的 Advanced 下面，主要管两件事：允许哪些认证方式、以及是否允许中继。前面 SMTP 那节已经提了RequireAuthentication，这里再补一层——如果内部有应用系统用固定账号发信，可以在 IP Ranges 里给那台机器的 IP 单独放行，免认证发信，比全局关认证安全得多。

日志是排查问题的后悔药。Settings 下面 Logging 页，把 SMTP、POP3、IMAP、Application 几类都勾上，日志文件落在Logs目录，按天切分。出问题时先看 SMTP 日志里的会话记录，能清楚看到客户端连进来、认证、投递每一步的结果。

# 实时盯日志（Windows 下可用 PowerShell） Get-Content "C:\Program Files\hMailServer\Logs\hmailserver_$(Get-Date -Format yyyy-MM-dd).log" -Wait -Tail 50

这条命令持续输出当天日志的最后 50 行并跟随新增内容，复现问题时开着它，客户端一操作就能看到服务端视角发生了什么。日志级别别长期开到最详细，量大了会拖慢服务，排查完记得调回去。

4. 避坑与排查：hMailServer 配置里最容易翻车的五处

4.1 客户端连不上，日志显示认证失败

现象：客户端配置完账号密码，收信报认证失败，服务端日志里能看到连接建立但认证被拒。原因通常是账号写法不对——只填了alert而不是alert@corp.local，服务端按完整地址匹配账号，对不上就拒。解决：把客户端登录名改成完整邮件地址，同时确认域名的拼写和服务端 Domains 里的一致，大小写不敏感但拼错一个字母就废。

4.2 邮件发得出去收不进来

现象：本机往外发正常，外部往这个域发信一直退。原因多半是域配置里的绑定地址填错了，或者防火墙没放行 25 端口入站。解决：先把域配置的 BindAddress 清空走默认，再在机器上telnet localhost 25确认本地能连，然后检查 Windows 防火墙入站规则有没有放行 SMTP 端口。

4.3 开了明文认证反而报错

现象：按某些教程勾上 allow plain text authentication，结果 trac 这类系统的邮件通知直接失败。原因就是原文那条经验——这类系统在明文认证握手阶段的行为和服务端预期不一致。解决：把这个勾去掉，让客户端走标准认证流程；如果客户端确实只支持明文，就在 IP Ranges 里针对那台机器单独放行，而不是全局打开。

4.4 邮件堆在队列里不投递

现象：日志显示邮件已接收，但一直停在队列，外部收不到。原因通常是 Routes 没配或者配错，服务端不知道往哪投。解决：检查 Routes 里有没有覆盖目标域的条目，TargetSMTPHost能不能连通，用telnet 中继地址 25验证上游可达性，再看日志里投递重试的具体报错。

4.5 服务重启后配置丢失或连不上

现象：改完配置重启服务，管理客户端连不上，或者部分设置回到默认。原因一般是管理密码或配置文件被改动，或者数据目录权限在重启后变化。解决：操作前备份hMailServer.ini和 Data 目录，重启后用sc query hMailServer确认服务状态，连不上先核对 ini 里的密码字段和端口。

5. 装完怎么验证：从服务端到客户端跑通一条完整链路

配置全部落完之后，别急着宣布完工，按下面这条链路走一遍，任何一环断了都能立刻定位。

第一步，服务端自检。管理界面 Status 页看服务运行时长和版本，Settings 里的诊断工具跑一遍域名解析和端口连通测试。第二步，本地账号互发。用两个内部账号互发一封，确认域内投递通。第三步，出站测试。往一个外部地址发一封，看日志里 SMTP 会话是否走到投递成功。第四步，入站测试。从外部往内部账号发一封，确认能收进来。第五步，客户端实测。用实际要用的客户端（Outlook、Thunderbird 或者业务系统自带的邮件模块）按真实参数配一遍，账号写完整地址，认证方式按服务端开的来。

这张表我一般会存一份在部署记录里，每次改完配置重跑一遍，比凭感觉判断靠谱。特别是客户端那一项，一定要用最终要用的那个客户端实测，别拿管理界面的测试功能代替——两者走的认证路径不完全一样，管理界面能通不代表业务系统能通。

从那以后我每次搭 hMailServer，都强制自己先把日志开到位、再按这条链路走一遍验证，哪怕只是改了一个认证开关。邮件服务这种东西，配置项之间耦合太深，少走一步验证，后面可能就是半天翻日志。希望这套流程能帮到你，少踩几个我踩过的坑。

本文还有配套的精品资源，点击获取