进阶 hestiacp.com 2026-11-15 08:32:00 · 12 阅读

第11章 邮件与邮件服务器配置

邮件与邮件服务器 ​如何在 Hestia 中配置通过 SMTP 发送内部邮件? ​默认情况下,Hestia 生成的邮件(如通知、密码重置、更新日志等)会通过内部邮件服务器发送。如果你希望使用外部服务,可以配置 Hestia 通过 SMTP 账号发送邮件。请执行以下脚本并遵循提示: bash /usr/local/hestia/install/upgrade/manual/configure-server-smtp.sh 脚本会要求你输入以下 SMTP 参数: * 主机(例如 smtp.example.com) * 端口(例如 25、465 或 587) * 安全类型(例如 STARTTLS) * 用户名 * 密码 * 邮箱地址(即发件人地址)。

​无法发送邮件 ​首先,检查端口 25 是否对出站流量开放。许多云服务商为打击垃圾邮件,默认会封锁端口 25。 运行以下命令进行测试: telnet ASPMX.L.GOOGLE.COM 25 如果连接成功,你会看到类似这样的输出: Trying 2a00:1450:400c:c00::1b... Connected to ASPMX.L.GOOGLE.COM. Escape character is '^]'. 220 mx.google.com ESMTP a7si1253985wrr.455 - gsmtp 如果连接失败,你有两个选择: 1. 联系你的服务商,请求他们为出站流量开放端口 25。 2. 在邮件域名设置中配置邮件中继(Mail Relay),或在系统设置中为整个服务器配置中继。这需要你使用类似以下服务的 SMTP 中继:Amazon SES、SMTP2GO、Brevo。

​什么是 SMTP 中继服务以及如何配置? ​SMTP 邮件中继是指将邮件从一台服务器转移到另一台服务器进行投递的过程。通常,由于担心垃圾邮件,服务商可能会封锁来自某台服务器的邮件。或者因为 IP 信誉度较低,所有邮件都会直接进入收件人的垃圾箱。为了防止这些问题,许多公司提供 SMTP 中继服务,专门负责邮件投递。由于这些服务商通过相同的 IP 地址发送大量邮件,它们拥有更好的 IP 信誉。 配置时,请在你想要使用的服务商处创建一个账户,并遵循其指示更新你的 DNS 记录。完成后,你可以在设置中的“全局 SMTP”或“编辑邮件域名” -> “SMTP 中继”处输入服务商提供的 SMTP 用户账号。

​无法接收邮件 ​如果你无法接收邮件,请确保你的 DNS 记录配置正确。如果你正在使用 Cloudflare,请关闭 mail.domain.tld 的代理开关(橙色云图标)。 配置完成后,可以通过 MXToolBox 检查配置是否正确。

​自动清除旧的垃圾邮件和回收站消息 ​邮件客户端通常不会自动清空“回收站”或“垃圾邮件”文件夹,导致这些文件夹不断膨胀,占用大量磁盘空间。你可以让 Dovecot 自动移除这些文件夹中的旧消息,或者运行一个计划任务清理脚本。 在启用自动删除之前,请确保保留期限符合用户的预期。以下示例会删除超过 30 天的消息。

推荐:使用 Dovecot autoexpunge ​Dovecot 可以使用 autoexpunge 功能自动从配置的邮箱中移除消息。编辑 /etc/dovecot/dovecot.conf,在现有的 Trash、Spam 和 Junk 邮箱配置块中添加 autoexpunge = 30d: text mailbox Trash { auto = subscribe special_use = \Trash autoexpunge = 30d }

mailbox Spam { auto = subscribe special_use = \Junk autoexpunge = 30d }

mailbox Junk { auto = no special_use = \Junk autoexpunge = 30d } 对于繁忙的邮件服务器,Dovecot 建议在启用 autoexpunge 时开启 mailbox_list_index = yes,这样它可以更快地找到需要清理的邮箱,而无需打开每一个邮箱。如果邮件存储使用的是 Maildir 或 sdbox,还请考虑设置 mail_always_cache_fields = date.save。 验证 Dovecot 配置并重启服务: bash doveconf -n > /dev/null systemctl restart dovecot

替代方案:运行计划清理脚本 ​如果你更喜欢通过 cron 运行清理任务,可以创建一个脚本,例如 /usr/local/sbin/hestia-purge-mail-folders: bash #!/bin/bash

set -euo pipefail

HESTIA="/usr/local/hestia" RETENTION="30d" DRY_RUN="${DRY_RUN:-yes}" MAILBOXES=("Trash" "Spam" "Junk")

"$HESTIA/bin/v-list-users" list | while read -r user; do while read -r domain; do while read -r account; do address="${account}@${domain}"

for mailbox in "${MAILBOXES[@]}"; do if doveadm mailbox list -u "$address" | grep -Fxq "$mailbox"; then if [ "$DRY_RUN" = "yes" ]; then echo "Would purge ${mailbox} for ${address}" else echo "Purging ${mailbox} for ${address}" doveadm expunge -u "$address" mailbox "$mailbox" savedbefore "$RETENTION" fi fi done done < <("$HESTIA/bin/v-list-mail-accounts" "$user" "$domain" plain 2> /dev/null | cut -f1 || true) done < <("$HESTIA/bin/v-list-mail-domains" "$user" plain 2> /dev/null | cut -f1 || true) done

使脚本可执行: bash chmod 750 /usr/local/sbin/hestia-purge-mail-folders

首先手动运行它。默认情况下,脚本只会打印将要清除的内容(试运行模式): bash /usr/local/sbin/hestia-purge-mail-folders

设置 DRY_RUN=no 以实际执行清理: bash DRY_RUN=no /usr/local/sbin/hestia-purge-mail-folders

然后添加一个 root 用户的 cron 任务,例如每天 03:30 运行: text 30 3 * * * DRY_RUN=no /usr/local/sbin/hestia-purge-mail-folders >/var/log/hestia-purge-mail-folders.log 2>&1

​提示“被拒绝,因为 [ip] 在 zen.spamhaus.org 黑名单中。错误:无法打开解析器:https://www.spamhaus.org/returnc/pub/65.1.174.102” ​前往 Spamhaus 免费数据查询账户页面。 填写表单并通过收到的邮件中的链接验证你的邮箱地址。 登录后,进入 Products → DQS,你会看到你的 Query Key,以及在下方用于 Zen Spamhaus 黑名单查询的具体 FQDN。格式类似:HereYourQueryKey.zen.dq.spamhaus.net。 运行 v-delete-sys-mail-dnsbl zen.spamhaus.org 以移除默认的 Spamhaus 条目。 运行 v-add-sys-mail-dnsbl HereYourQueryKey.zen.dq.spamhaus.net 以添加你自定义的 DQS 键。(注意:HestiaCP 会自动防止你的 Spamhaus 查询密钥在退信消息中泄露。)

​如何禁用邮件的内部查找? ​如果你使用 SMTP 中继,或者希望在你的 Web 服务器上启用 DKIM 但将邮件托管在 Gmail 上,你需要在 Exim4 中禁用内部查找。 编辑 /etc/exim4/exim4.conf.template: bash nano /etc/exim4/exim4.conf.template

找到如下配置: bash dnslookup: driver = dnslookup domains = !+local_domains transport = remote_smtp no_more

将其替换为: bash dnslookup: driver = dnslookup domains = * transport = remote_smtp no_more

​如何安装 SnappyMail? ​你可以通过运行以下命令安装 SnappyMail: bash v-add-sys-snappymail

​我可以登录 SnappyMail 的后端管理界面吗? ​在根目录中,有一个名为 .snappymail 的文件,其中包含用户名和密码: bash Username: admin_ce115495 Password: D0ung4naLOptuaa Secret key: admin_f0e5a5aa

你可以通过访问 https://webmail.domain.tld/?admin_f0e5a5aa 来进入管理面板,其中 admin_f0e5a5aa 是密钥,使用文件中找到的用户名和密码登录。一旦不再需要,出于安全原因,请删除该文件。

​我可以使用 Cloudflare 代理处理邮件吗? ​不可以,Cloudflare 的代理功能不适用于邮件。如果你使用服务器托管的邮件,请确保 mail.domain.tld 的 A 记录代理处于关闭状态。否则,你将无法接收邮件。如果你希望使用 Hestia 作为邮件服务器,建议配置以下记录: * 名为 mail 的 A 记录,指向你的服务器 IP。 * 名为 webmail 的 A 记录,指向你的服务器 IP。 * 名为 @ 的 MX 记录,指向 mail.domain.tld。 * 名为 @ 的 TXT 记录,内容为 v=spf1 a mx ip4:your ip; \~all。 * 名为 ._domainkey(默认选择器为 mail)的 TXT 记录,内容为 v=DKIM1; k=rsa; p=;。 * 名为 _dmarc 的 TXT 记录,内容为 v=DMARC1; p=quarantine; sp=quarantine; adkim=s; aspf=s;。

DKIM 密钥和 SPF 记录可以在“邮件域名”列表中找到(参见文档)。

​从我服务器发出的邮件进入垃圾邮件文件夹 ​确保你已正确配置了 RDNS、SPF 记录和 DKIM 记录。 如果这不起作用,可能是你的 IP 地址被列入了一个或多个黑名单。你可以使用 Suped 的 Blocklist Checker 检查你的 IP。你可以尝试解除封锁,但通常更简单的方法是使用 Amazon SES 或其他 SMTP 提供商的 SMTP 和 SMTP 中继服务。 为了进一步缩小原因范围,发送一封测试邮件到 Mail Tester,并查看报告中关于身份验证、黑名单和邮件内容的问题。这些发现有助于识别配置或信誉问题,但不能保证在所有提供商的收件箱中都能成功投递。

​如何启用 ManageSieve? ​在安装 Hestia 时,使用 --sieve 标志。如果 Hestia 已经安装,可以使用位于以下路径的升级脚本:/usr/local/hestia/install/upgrade/manual/install_sieve.sh。

​我可以通过外部邮件客户端访问 ManageSieve 吗? ​在防火墙中开放端口 4190。请阅读防火墙文档。

​如何在 SnappyMail 中启用 ManageSieve? ​编辑 /var/lib/snappymail/data/_data_/_default_/domains/default.json 并修改以下设置: json "Sieve": { "host": "localhost", "port": 4190, "type": 0, "timeout": 10, "shortLogin": false, "lowerLogin": true, "sasl": [ "SCRAM-SHA3-512", "SCRAM-SHA-512", "SCRAM-SHA-256", "SCRAM-SHA-1", "PLAIN", "LOGIN" ], "ssl": { "verify_peer": false, "verify_peer_name": false, "allow_self_signed": false, "SNI_enabled": true, "disable_compression": true, "security_level": 1 }, "enabled": false # 将此改为 true },

​Oracle Cloud + SMTP 中继 ​如果你想在 Oracle Cloud 上使用 SMTP,需要对 Exim4 配置进行以下更改: 打开 /etc/exim4/exim4.conf.template 并替换以下代码: bash smtp_relay_login: driver = plaintext public_name = LOGIN hide client_send = : SMTP_RELAY_USER : SMTP_RELAY_PASS

替换为: bash smtp_relay_login: driver = plaintext public_name = PLAIN hide client_send = ^SMTP_RELAY_USER^SMTP_RELAY_PASS

更多信息请参见论坛主题。

​设置邮件钩子(Hooks) ​某些 SMTP 中继服务可能要求你在 SMTP 中继账号中设置域名。为此,已在 v-add-mail-domain 和 v-delete-mail-domain 中添加了钩子。 创建文件:$HESTIA/data/extensions/add-mail-domain.sh 和 $HESTIA/data/extensions/v-delete-mail-domain.sh。

Proxmox 邮件服务器 ​参见:Github

bash # v-add-mail-domain SMTP_RELAY_PMG_USER="user" SMTP_RELAY_PMG_PASS="password" SMTP_RELAY_PMG_HOST="host" SMTP_RELAY_PMG_PORT="port"

pmg_auth=$(curl -s --request POST -d "username=$SMTP_RELAY_PMG_USER&password=$SMTP_RELAY_PMG_PASS" \ --url https://$SMTP_RELAY_PMG_HOST:$SMTP_RELAY_PMG_PORT/api2/json/access/ticket) pmg_ticket=$(echo $pmg_auth | jq -r '.data.ticket') pmg_csrf=$(echo $pmg_auth | jq -r '.data.CSRFPreventionToken') if [ -n "$pmg_ticket" ]; then pmg_config_domain=$(curl -s --request POST -d "domain=$domain" \ -H "CSRFPreventionToken: $pmg_csrf" -H "Cookie: PMGAuthCookie=$pmg_ticket" \ https://$SMTP_RELAY_PMG_HOST:$SMTP_RELAY_PMG_PORT/api2/json/config/domains) pmg_config_transport=$(curl -s --request POST -d "domain=$domain&host=$SMTP_RELAY_PMG_LOCAL_IP" \ -H "CSRFPreventionToken: $pmg_csrf" -H "Cookie: PMGAuthCookie=$pmg_ticket" \ https://$SMTP_RELAY_PMG_HOST:$SMTP_RELAY_PMG_PORT/api2/json/config/transport) fi

# v-delete-mail-domain.sh SMTP_RELAY_PMG_USER="user" SMTP_RELAY_PMG_PASS="password" SMTP_RELAY_PMG_HOST="host" SMTP_RELAY_PMG_PORT="port"

if [ -n "$SMTP_RELAY_PMG" ]; then pmg_auth=$(curl -s --request POST -d "username=$SMTP_RELAY_PMG_USER&password=$SMTP_RELAY_PMG_PASS" \ --url https://$SMTP_RELAY_PMG_HOST:$SMTP_RELAY_PMG_PORT/api2/json/access/ticket) pmg_ticket=$(echo $pmg_auth | jq -r '.data.ticket') pmg_csrf=$(echo $pmg_auth | jq -r '.data.CSRFPreventionToken') if [ -n "$pmg_ticket" ]; then pmg_config_domain=$(curl -s --request DELETE \ -H "CSRFPreventionToken: $pmg_csrf" -H "Cookie: PMGAuthCookie=$pmg_ticket" \ https://$SMTP_RELAY_PMG_HOST:$SMTP_RELAY_PMG_PORT/api2/json/config/domains/$domain) pmg_config_transport=$(curl -s --request DELETE \ -H "CSRFPreventionToken: $pmg_csrf" -H "Cookie: PMGAuthCookie=$pmg_ticket" \ https://$SMTP_RELAY_PMG_HOST:$SMTP_RELAY_PMG_PORT/api2/json/config/transport/$domain) fi fi

评论 (0)