迁移至HestiaCP VPS后PHPMailer无法发送邮件求助

1. 检查HestiaCP邮件服务与端口状态 #

• 登录HestiaCP面板，确认Exim或Postfix（取决于你安装的邮件服务）处于正常运行状态
• 同时检查VPS系统防火墙和HestiaCP自带防火墙，确保开放了25、465、587这几个SMTP常用端口

2. 明确配置PHPMailer的SMTP参数 #

原cPanel主机默认适配了本地邮件服务，无需手动指定Host，但HestiaCP的VPS需要明确配置SMTP信息，以下是标准配置示例：

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);
try {
    // 服务器核心配置
    $mail->isSMTP();                                            // 启用SMTP模式
    $mail->Host       = 'localhost';                            // 用HestiaCP本地邮件服务器，或你的域名SMTP地址（如mail.yourdomain.com）
    $mail->SMTPAuth   = true;                                   // 开启SMTP认证
    $mail->Username   = 'your-email@yourdomain.com';            // HestiaCP后台创建的邮箱账号
    $mail->Password   = 'your-email-password';                  // 对应邮箱的密码
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;         // 启用TLS加密，可选ENCRYPTION_SMTPS（对应465端口）
    $mail->Port       = 587;                                    // 匹配加密方式的端口，587对应STARTTLS，465对应SMTPS

    // 发件人与收件人设置
    $mail->setFrom('your-email@yourdomain.com', 'Your Name');
    $mail->addAddress('recipient@example.com', 'Recipient Name');

    // 邮件内容配置
    $mail->isHTML(true);                                        // 启用HTML格式
    $mail->Subject = 'Test Email from HestiaCP VPS';
    $mail->Body    = '<h1>This is a test email sent via PHPMailer</h1>';
    $mail->AltBody = 'Plain text version for non-HTML email clients';

    $mail->send();
    echo '邮件发送成功';
} catch (Exception $e) {
    echo "发送失败，错误信息: {$mail->ErrorInfo}";
}

3. 测试本地sendmail（如果想沿用无SMTP的方式） #

• 先检查VPS是否安装了sendmail，未安装则执行（Debian/Ubuntu为例）：

  sudo apt-get install sendmail
  

• 修改PHPMailer配置为使用sendmail：

  $mail->isSendmail(); // 替换原有的isSMTP()
  

• 在终端直接测试sendmail可用性：

  echo "测试邮件内容" | sendmail recipient@example.com
  

  如果失败，查看系统邮件日志/var/log/mail.log或/var/log/exim/mainlog定位错误

4. 检查PHP的mail()函数配置 #

• 查看php.ini中的sendmail_path参数，确保指向正确的sendmail路径，示例：

  sendmail_path = /usr/sbin/sendmail -t -i
  

• 修改后重启PHP-FPM服务生效：

  sudo systemctl restart php8.2-fpm # 替换为你的PHP版本
  

5. 利用错误信息精准排查 #

确保脚本中的catch块输出$mail->ErrorInfo，根据具体错误提示解决：

• 提示Connection refused：检查SMTP端口是否开放、Host地址是否正确
• 提示Authentication failed：确认邮箱账号密码无误，HestiaCP是否开启了SMTP认证
• 提示Relay access denied：检查是否允许本地发送邮件，或确认发件人邮箱为HestiaCP托管的域名邮箱

内容的提问来源于stack exchange，提问作者claudio lopez