Chuyển tới nội dung chính

aaPanel: Khắc Phục Lỗi Gửi Email

Giới Thiệu​

aaPanel là một bảng điều khiển máy chủ web mạnh mẽ và dễ sử dụng, giúp bạn quản lý server Linux một cách trực quan. Tuy nhiên, một trong những vấn đề thường gặp mà người dùng aaPanel có thể đối mặt là lỗi gửi email từ server của họ. Điều này có thể ảnh hưởng đến các chức năng quan trọng như gửi thông báo, xác nhận đăng ký, hoặc email đặt lại mật khẩu cho các ứng dụng web.

Lỗi gửi mail có thể xuất phát từ nhiều nguyên nhân khác nhau, từ việc port SMTP bị chặn bởi nhà cung cấp dịch vụ internet (ISP), cấu hình firewall không chính xác, thiếu hoặc sai sót trong các bản ghi DNS như SPF và DKIM, cho đến các vấn đề về cấu hình mail server nội bộ hoặc việc sử dụng dịch vụ SMTP bên ngoài. Hướng dẫn này sẽ giúp bạn từng bước xác định và khắc phục các sự cố phổ biến nhất, đảm bảo email của bạn được gửi đi một cách đáng tin cậy.

📋 Thời gian: ~20-30 phút | Độ khó: Trung bình

Yêu Cầu​

Để thực hiện theo hướng dẫn này, bạn cần có:

  • Một máy chủ Linux đã cài đặt aaPanel.
  • Quyền truy cập root hoặc người dùng sudo trên máy chủ.
  • Tên miền đã được trỏ về máy chủ của bạn.
  • Hiểu biết cơ bản về DNS và cách cấu hình các bản ghi.
  • Khả năng sử dụng dòng lệnh Linux cơ bản.

Các Bước Thực Hiện​

Bước 1: Kiểm Tra Tình Trạng Port 25 (SMTP) và Firewall​

Port 25 là port tiêu chuẩn cho SMTP (Simple Mail Transfer Protocol), dùng để gửi email. Nhiều ISP và nhà cung cấp dịch vụ đám mây thường chặn port này để chống spam. Ngoài ra, firewall trên server của bạn cũng có thể chặn các kết nối ra/vào.

1.1. Kiểm tra Port 25 bị chặn bởi ISP​

Bạn có thể thử kiểm tra xem port 25 có bị chặn từ bên ngoài hay không bằng cách sử dụng công cụ như telnet hoặc nc (netcat) từ một máy tính khác (không phải server aaPanel của bạn) hoặc từ chính server nếu bạn muốn kiểm tra kết nối ra.

# Kiểm tra kết nối đến một máy chủ email bên ngoài (ví dụ: Gmail)
# Từ server aaPanel của bạn để kiểm tra kết nối ra
telnet gmail-smtp-in.l.google.com 25

# Nếu telnet không có, cài đặt nó:
# CentOS/RHEL
sudo yum install telnet -y
# Ubuntu/Debian
sudo apt install telnet -y

# Hoặc dùng netcat (nc)
nc -vz gmail-smtp-in.l.google.com 25

Nếu bạn nhận được thông báo "Connection refused" hoặc "Connection timed out", có khả năng port 25 đã bị chặn bởi ISP hoặc firewall bên ngoài. ⚠️ Trong trường hợp này, bạn sẽ cần liên hệ với nhà cung cấp dịch vụ của mình để yêu cầu mở port 25 hoặc sử dụng dịch vụ SMTP relay bên ngoài (sẽ đề cập ở Bước 4).

1.2. Kiểm tra và cấu hình Firewall trên Server​

Firewall trên server (như firewalld trên CentOS hoặc ufw trên Ubuntu) có thể chặn các port cần thiết.

Trên CentOS/RHEL (sử dụng firewalld):

# Kiểm tra trạng thái firewalld
sudo systemctl status firewalld

# Liệt kê các port và dịch vụ đã mở
sudo firewall-cmd --list-all

# Mở các port cần thiết cho email (25, 465, 587)
# 25: SMTP tiêu chuẩn
# 465: SMTPS (SMTP Secure)
# 587: Submission (SMTP với TLS)
sudo firewall-cmd --permanent --add-port=25/tcp
sudo firewall-cmd --permanent --add-port=465/tcp
sudo firewall-cmd --permanent --add-port=587/tcp

# Tải lại firewalld để áp dụng thay đổi
sudo firewall-cmd --reload

# ✅ Xác nhận các port đã được mở
sudo firewall-cmd --list-all

Trên Ubuntu/Debian (sử dụng ufw):

# Kiểm tra trạng thái ufw
sudo ufw status verbose

# Mở các port cần thiết cho email
sudo ufw allow 25/tcp
sudo ufw allow 465/tcp
sudo ufw allow 587/tcp

# ✅ Xác nhận các port đã được mở
sudo ufw status verbose

💡 Mẹo: Nếu bạn đang sử dụng plugin "Security Group" hoặc "Firewall" của aaPanel, hãy đảm bảo rằng các port 25, 465, 587 đã được cho phép.

Bước 2: Kiểm Tra và Cấu Hình Bản Ghi DNS (SPF, DKIM, DMARC)​

Các bản ghi DNS như SPF (Sender Policy Framework), DKIM (DomainKeys Identified Mail) và DMARC (Domain-based Message Authentication, Reporting, and Conformance) rất quan trọng để xác thực email, giúp email của bạn không bị đánh dấu là spam.

2.1. Bản ghi SPF​

Bản ghi SPF chỉ định các máy chủ được phép gửi email thay mặt cho tên miền của bạn.

  • Cách kiểm tra: Sử dụng các công cụ trực tuyến như MXToolbox SPF Check.
  • Cách khắc phục: Thêm hoặc chỉnh sửa bản ghi TXT trong DNS của tên miền. 
    Loại: TXT
    Tên: @ hoặc tên miền của bạn
    Giá trị: v=spf1 a mx ip4:YOUR_SERVER_IP ~all
    Thay YOUR_SERVER_IP bằng địa chỉ IP của máy chủ aaPanel của bạn. Nếu bạn sử dụng dịch vụ SMTP relay bên ngoài, hãy thêm các include của dịch vụ đó (ví dụ: include:sendgrid.net cho SendGrid).

2.2. Bản ghi DKIM​

DKIM cung cấp một chữ ký số cho email, giúp người nhận xác minh rằng email không bị giả mạo hoặc thay đổi trong quá trình gửi.

  • Cách kiểm tra: aaPanel Mail Server thường tự động tạo khóa DKIM. Bạn có thể tìm thấy nó trong phần cài đặt Mail Server của aaPanel.
  • Cách khắc phục: Copy bản ghi TXT do aaPanel cung cấp (thường có dạng mail._domainkey) và dán vào cài đặt DNS của tên miền.

2.3. Bản ghi DMARC​

DMARC xây dựng trên SPF và DKIM, cho phép bạn chỉ định chính sách xử lý email không xác thực (ví dụ: đưa vào spam, từ chối).

  • Cách kiểm tra: Sử dụng các công cụ trực tuyến như DMARC Analyzer.
  • Cách khắc phục: Thêm bản ghi TXT vào DNS của tên miền. 
    Loại: TXT
    Tên: _dmarc
    Giá trị: v=DMARC1; p=quarantine; rua=mailto:[email protected]; fo=1;
    Thay [email protected] bằng địa chỉ email của bạn để nhận báo cáo DMARC. p=quarantine có nghĩa là email không xác thực sẽ được đưa vào spam. Bạn có thể thay đổi thành p=reject sau khi tự tin vào cấu hình của mình.

💡 Mẹo: Sau khi thay đổi DNS, hãy chờ một thời gian để các thay đổi được lan truyền (thường là vài phút đến vài giờ).

Bước 3: Phân Tích Log Mail Server​

Log mail server là nguồn thông tin quý giá để xác định nguyên nhân gốc rễ của lỗi gửi mail.

3.1. Truy cập Log​

Tùy thuộc vào hệ điều hành và cấu hình mail server của bạn, log có thể nằm ở các vị trí khác nhau:

  • CentOS/RHEL: Thường là /var/log/maillog
  • Ubuntu/Debian: Thường là /var/log/mail.log
# Xem 50 dòng log cuối cùng
tail -n 50 /var/log/maillog # hoặc /var/log/mail.log

# Theo dõi log theo thời gian thực (nhấn Ctrl+C để thoát)
tail -f /var/log/maillog # hoặc /var/log/mail.log

Khi bạn cố gắng gửi một email, hãy theo dõi log để xem thông báo lỗi cụ thể.

3.2. Các Lỗi Thường Gặp Trong Log​

  • "Connection refused" / "Host not found": Có thể do tên miền nhận không tồn tại, hoặc server nhận chặn kết nối.
  • "Relay access denied": Server của bạn không được phép relay qua server SMTP mục tiêu, thường do thiếu xác thực hoặc địa chỉ IP không được phép.
  • "Recipient address rejected: User unknown in local recipient table": Địa chỉ email người nhận không tồn tại trên server nhận.
  • "Sender address rejected: Domain not found" / "Sender verification failed": Vấn đề với tên miền của người gửi (có thể là SPF/DKIM).
  • "Message size exceeds maximum permitted": Email quá lớn.
  • "Temporary lookup failure": Vấn đề với DNS resolver trên server của bạn.

Bước 4: Cấu Hình SMTP Relay (Nếu Cần)​

Nếu port 25 bị chặn bởi ISP hoặc bạn muốn tăng cường độ tin cậy và khả năng gửi email, việc sử dụng dịch vụ SMTP relay bên ngoài là một giải pháp hiệu quả. Các dịch vụ phổ biến bao gồm SendGrid, Mailgun, AWS SES, G Suite SMTP.

Bạn cần cấu hình Postfix (mail server mặc định trên aaPanel) để sử dụng SMTP relay.

4.1. Cài đặt và cấu hình saslauthd (nếu chưa có)​

# CentOS/RHEL
sudo yum install cyrus-sasl-plain cyrus-sasl-md5 -y
sudo systemctl enable saslauthd
sudo systemctl start saslauthd

# Ubuntu/Debian
sudo apt install sasl2-bin -y
sudo systemctl enable saslauthd
sudo systemctl start saslauthd

4.2. Cấu hình Postfix​

Chỉnh sửa file cấu hình Postfix main.cf:

sudo vi /etc/postfix/main.cf

Thêm hoặc chỉnh sửa các dòng sau:

# Thêm hoặc chỉnh sửa dòng này để chỉ định SMTP relay host
relayhost = [smtp.your-smtp-provider.com]:587

# Bật xác thực SMTP
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_sasl_tls_security_options = noanonymous
smtp_use_tls = yes
smtp_tls_security_level = encrypt

Thay [smtp.your-smtp-provider.com]:587 bằng địa chỉ máy chủ SMTP và port của nhà cung cấp dịch vụ của bạn (ví dụ: [smtp.sendgrid.net]:587).

4.3. Tạo file mật khẩu SMTP​

Tạo file /etc/postfix/sasl_passwd và thêm thông tin đăng nhập của dịch vụ SMTP relay:

sudo vi /etc/postfix/sasl_passwd

Thêm dòng sau:

[smtp.your-smtp-provider.com]:587 YOUR_USERNAME:YOUR_PASSWORD

Thay YOUR_USERNAME và YOUR_PASSWORD bằng thông tin đăng nhập từ dịch vụ SMTP relay của bạn.

4.4. Tạo cơ sở dữ liệu băm và thiết lập quyền​

sudo postmap /etc/postfix/sasl_passwd
sudo chmod 600 /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db

4.5. Khởi động lại Postfix​

sudo systemctl restart postfix

✅ Sau khi hoàn tất các bước này, Postfix sẽ sử dụng dịch vụ SMTP relay bên ngoài để gửi email.

Troubleshooting​

  • Email vẫn vào Spam: ⚠️ Thường xuyên kiểm tra lại cấu hình SPF, DKIM, DMARC. Đảm bảo không có lỗi chính tả và các bản ghi đã được lan truyền đầy đủ. Sử dụng các công cụ kiểm tra độ tin cậy email trực tuyến.
  • Kết nối từ chối ngay lập tức: Kiểm tra lại firewall trên server và đảm bảo port 25, 465, 587 đã mở. Nếu sử dụng SMTP relay, kiểm tra lại thông tin đăng nhập và địa chỉ máy chủ.
  • Mail queue đầy: Điều này có nghĩa là Postfix không thể gửi email đi. Kiểm tra log mail server (/var/log/maillog hoặc mail.log) để tìm lỗi cụ thể. Có thể do port bị chặn, lỗi DNS, hoặc lỗi xác thực SMTP relay.
  • Lỗi PHP mail() function không hoạt động: Chức năng mail() của PHP thường dựa vào cấu hình của Postfix trên server. Nếu Postfix không gửi được mail, mail() cũng sẽ không hoạt động. Đảm bảo Postfix đã được cấu hình chính xác và đang chạy.

Kết Luận​

Khắc phục lỗi gửi mail trên aaPanel đòi hỏi một cách tiếp cận có hệ thống, từ việc kiểm tra các yếu tố cơ bản như port và firewall, đến việc cấu hình chính xác các bản ghi DNS quan trọng như SPF, DKIM, DMARC. Việc phân tích log mail server là bước không thể thiếu để xác định nguyên nhân gốc rễ của mọi vấn đề.

💡 Best practices:

  • Luôn kiểm tra log: Đây là công cụ chẩn đoán mạnh mẽ nhất của bạn.
  • Cấu hình DNS chính xác: Đảm bảo SPF, DKIM, DMARC được thiết lập đúng để tăng cường khả năng gửi email và tránh bị đánh dấu spam.
  • Sử dụng dịch vụ SMTP relay chuyên nghiệp: Đối với các ứng dụng yêu cầu độ tin cậy cao hoặc khi port 25 bị chặn, SMTP relay là giải pháp tối ưu.
  • Kiểm tra định kỳ: Các thay đổi về mạng, firewall hoặc chính sách của ISP có thể ảnh hưởng đến khả năng gửi mail, vì vậy hãy kiểm tra định kỳ.

Với các bước trên, bạn sẽ có thể khắc phục hầu hết các vấn đề gửi email trên máy chủ aaPanel của mình, đảm bảo các ứng dụng của bạn có thể giao tiếp hiệu quả qua email. ✅