hmailserver+Mysql邮件服务器环境搭建
报告概述
本文档旨在详细记录并指导如何在一台 Windows 服务器上，从零开始搭建一套基于 hMailServer 和 MySQL 的内部邮件服务器系统。该系统主要用于企业或团队内部的局域网邮件通信，实现安全、高效、免费的内部邮局功能。
核心组件：
邮件服务器软件： hMailServer 5.6.8
数据库系统： MySQL Server 8.0
操作系统： Windows (以 Windows 11/10 为例)
测试客户端： Foxmail
准备工作
准备图 1 环境搭建所需资料，所需都能在官网上收集，我也准备了资料已放入云盘，自取。
资源链接：https://pan.baidu.com/s/5ofkAdsHjYDKyegGu0D2x-w 提取码：zzcs
图 1 环境搭建所需资料
步骤一：数据库环境搭建
hMailServer 需要一个数据库来存储域名、账户、邮件索引等信息。
先安装 MySQL Server，注意事项：如果之前有下载过别的MySQL版本，在更新前一定要确保自己删除干净旧版本的所有痕迹，包括注册表、缓存等内容。
- 运行 MySQL 安装程序，选择“自定义(Custom)”安装。
- 仅需选择安装 MySQL Server 组件即可。
- 在配置步骤中，设置 root 用户的密码，并牢记该密码
安装步骤就不详细介绍，大部分都是直接默认下一步，就说说重点：
如图 2 mysql认证方法，此处官方推荐是默认采用第一种方式下载，但是如果后面要用到数据库图形化工具的话（比如navicate）,如果navicate版本过老，比如11，会产生数据库连接错误，所以建议选择第二个密码选项方式下载（如果采用第一种方式下载，后期升级数据库图形化工具版本也可以）。此处我采用方式二。
图 2 mysql认证方法当安装到Apply Configuration这一步时，如图 3 starting the server错误，是因为没用提供本地账户管理员权限。
win+R,输入 services.msc，然后回车。找到MySQL服务，右键选择“属性”。在“登录”选项卡中，选择“本地系统账户”或确保使用具有管理员权限的账户。
图 3 starting the server错误
步骤二：hMailServer安装与配置
1.运行安装程序；
2.修改自定义路径；
3.数据库选用的MySql,所以Database type选择Use external database engine(MSSQL,MySQL or PostgreSQL);
4.Select option 选择Create a new hMailServer database;
5.选择MySql
6.输入mysql的连接参数信息IP地址Database server address：127.0.0.1(本机自测所有);
Database name: hMail_DB;(设置数据库名);
Port:3306;
Username:root;(默认)
Password:spzz3a532766; (你的mysql登录密码)
- Service选择MySQL，本次安装实际为MySQL80
- 继续next;
- 注意此时若提示如果出现 “The MySQL client (libmysql.dll, 32 bit) could not be loaded” 错误，说明程序未找到所需的 32 位 MySQL 客户端库文件，需要手动复制到指定目录；
原因：是使用64位系统电脑，但hMailServer是32位应用，所以需要32位版本的libmysql.dll才能连接MySQL；
10.可能还会报错“SSL connection error: unknown error number”，是MySQL连接时的SSL协议不匹配。
原因：我的MySQL是8.x版本，该版本会默认强制使用新的认证方式：caching_sha2_password；默认要求SSL连接；而 hMailServer 是老软件（只支持 MySQL 5.x 时代的认证方式）
解决方案：把MySQL用户改成旧认证方式。Win+R,cmd,输入mysql -u root -p,输入命令：“ALTER USER ‘root’@‘localhost’ IDENTIFIED WITH mysql_native_password BY ‘你的密码’;FLUSH PRIVILEGES;”
成功会提示：Query OK；
然后去重启MySQL服务，Win+R输入services.msc找到MySQL80，右键重启。若提示需要关闭hMailServer安装进程就关闭；
- 若未关闭hMailServer安装进程，就回退安装步骤到上一步，重试即可成功；若已关闭hMailServer安装进程，则重新开启“hMailServer-5.6.8-B2574.exe”安装，安装重走一遍步骤即可安装成功；
步骤三：服务器功能验证（本机测试）
打开“hMailServer Administrator”，点击“Connect”,输入密码：spzz3a532766;
右键“Domains”点击“Add…”项；
输入Domain:newTest.com,再Save;点击目录里“Accounts”,添加“Add”新的账号；再Save;
再添加一个测试账号
再使用安装好的“Foxmail”进行测试。打开软件，选择“其他邮箱”，再“手动设置”，填写你的服务器信息，邮件账号：MyNewAddress@newTest.com,POP服务器：127.0.0.1，SMTP服务器：127.0.0.1；
登录后选择系统设置，添加上另一个账号；
最后互发邮件即可通讯。
更改电脑里IPv4的ip地址则可以修改服务器的ip,如：192.168.4.11，此时FoxMail登录后手动设置POP和SMTP时就更换为192.168.4.11即可。