E-posta

Siteler → E-posta alanını kullanarak mail sunucu hazırlığını inceleyin, gerekli DNS kayıtlarını doğrulayın ve site alan adı için gerçek posta kutularını canlı Postfix ve Dovecot yapısına provision edin.

Sunucu doğru hazırlanmışsa Herne artık gerçek tek sunucu posta kutularını provision eder. Webmail, alias ve çok sunuculu mail topolojileri halen kapsam dışıdır.

Kurulum ve hazırlama yöntemi

Herne Fazı 2 dosya tabanlı tek sunucu posta sağlayıcı yolu kullanır. panel veritabanı gerçeğin kaynağı olarak kalır ve Herne bu veriler altında özel bir yönetilen kök altında Postfix ve Dovecot eserleri üretir.

Taze bir sunucuda desteklenen birincil yol artık birleşik Herne kurulumudur:

curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash

Kurulum programı e-posta yığınını kurup kurulamayacağını sorduğunda yes cevabını verin, daha sonra da Herne'nin Postfix için tutarlı bir e-posta sunucu ismi oluşturabilmesi için EMAIL_HOSTING_SERVER_HOSTNAME'yi verin. Yerel yığın hazır olduktan sonra, alan adları ve posta kutuları oluşturmak için E-posta sayfaları panelini kullanın.

Eğer Herne zaten kuruluysa ve daha sonra posta ekliyorsanız, bağımsız yol kalacaktır:

php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --apply
php artisan herne:email:check-server

Herne’nin yönettiği bileşenler

  • /etc/herne-mail/generated/postfix/virtual_domains
  • /etc/herne-mail/generated/postfix/virtual_mailboxes
  • /etc/herne-mail/generated/dovecot/passwd
  • /etc/herne-mail/generated/state.json
  • /var/vmail/{domain}/{local_part}/Maildir

Herne kaynak dosyaları yazar, Postfix eşleme tabloları için postmap komutunu çalıştırır, Maildir dizinlerini oluşturur ve yeni dosyalar başarıyla hazırlandıktan sonra postfix ve dovecot hizmetlerini yeniden yükler.

Gerekli Ubuntu paketleri

Operatör kurucuyu root olarak veya parolasız sudo ile çalıştırdığında, kurucu Debian ve Ubuntu’da bu paketleri etkileşimsiz apt kullanarak otomatik yükleyebilir.

  • postfix
  • postfix-pcre eğer sunucu politikanız bunu başka bir yerde bekliyorsa
  • dovecot-core
  • dovecot-imapd
  • dovecot-pop3d
  • dovecot-lmtpd
  • rspamd
  • redis-server (rspamd için tavsiye edilir)
  • dnsutils
  • openssl

Hazır olma kontrolleri

Herne postfix, postconf, postmap, dovecot, doveconf, rspamd, rspamadm, openssl, systemctl, ss ve dig ya da host programlarının kurulu olup olmadığını kontrol eder.

Herne ayrıca postfix, dovecot, rspamd ve redis-server hizmetlerini, 25, 465, 587, 143, 993, 110 ve 995 posta bağlantı noktalarını ve UFW kuruluysa kurallarını kontrol eder.

Faz 2 ayrıca entegrasyon kablolama ve dosya sistemi hazırlığını da kontrol eder: vmail kullanıcı / grup, yazılabilir vmail kökü, Herne tarafından yönetilen konfigürasyon kökü ve postconf -n / doveconf -n gerçekten Herne tarafından yönetilen dosyaları referans gösteriyor mu.

Beklenen sanal posta kullanıcısı modeli

Herne, posta kutularını depolamak için genellikle vmail:vmail adlı özel sistem hesabını kurar ve kullanır. Maildir verilerinin /var/vmail altında olmasını bekler ve silinen posta kutularını /var/vmail/.trash altında arşivler.

Herne, UID/GID 5000'i serbest olduğunda tercih eder, ancak bu kimlik zaten kullanılıyorsa güvenli bir şekilde geri düşer.

Webmail’in ilk sürümü

Herne, /webmail altında kendi hafif Webmail uygulamasının ilk sürümünü sunar. Posta kutusu girişi ayrı çalışır ve Herne Panel hesabı gerektirmez.

  • Posta kutusu kullanıcıları tam e-posta adresi ve posta kutusu şifresiyle giriş yapmaktadır.
  • Sadece aktif, canlı olarak sağlanan Herne posta kutuları giriş yapabilir.
  • İlk sürüm gelen kutusunu, ileti okumayı, göndermeyi, yanıtlamayı ve silmeyi destekler.
  • Giden e-postalar her zaman gönderici olarak giriş yapılmış posta kutusu adresini kullanır.
  • Ekler, klasör yönetimi, takma adlar ve ileticiler, spam karantinası, zengin metin düzenleme ve çok sunuculu Webmail ilk sürümün kapsamı dışındadır.

Gelen postalar için PHP’nin imap uzantısı kullanılır. IMAP bağlantısı genellikle SSL ile 993 numaralı bağlantı noktasından kurulur. SMTP ile gönderim, posta kutusu kimlik bilgilerini kullanarak yapılandırılan posta sunucusuna (genellikle EMAIL_HOSTING_SERVER_HOSTNAME veya mail.{domain}), STARTTLS ile 587 numaralı bağlantı noktasından bağlanır.

Webmail ve Maildir depolaması

Webmail çalışma zamanı verileri ve gerçek posta kutusu depolama kasıtlı olarak ayrı tutulur:

  • Webmail uygulaması/işletim depolama: /var/www/{site}/webmail
  • Webmail çalışma zamanı alt dizinleri: cache, tmp ve drafts
  • Gerçek posta kutusu Maildir depolama: /var/vmail/{domain}/{local_part}/Maildir

Webmail dizini kamusal web_root altında değildir ve site dosyalarının yedeklemelerine otomatik olarak dahil edilmez. MVP, mevcut vmail izin modelini koruyarak, Dovecot posta teslimatını /var/www altına taşımaz.

Yararlı sunucu komutları

php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --apply
php artisan herne:install-mail-stack --repair
systemctl status postfix
systemctl status dovecot
systemctl status rspamd
ss -ltnp | grep -E ':25|:465|:587|:143|:993|:110|:995'
postconf -n
doveconf -n
php artisan herne:email:check-server
php artisan herne:email:health example.com
php artisan herne:email:provision-domain example.com
php artisan herne:email:provision-mailbox support@example.com
php artisan herne:email:rebuild

Herne’nin beklediği DNS kayıtları

dig MX example.com
dig TXT example.com
dig TXT herne._domainkey.example.com
dig TXT _dmarc.example.com

Panel her posta alan adı için önerilen MX, SPF, DKIM ve DMARC kayıtlarını oluşturur ve bunları kamu DNS'sine karşı doğrular. Bir alan adı, sadece gerekli kayıtlar gerçekten mevcut veya açıkça uyumlu olduğunda DNS-hazır olarak işaretlenir.

E-posta sağlığı ve teslim edilebilirlik

Faz 3, ilk olarak teşhis için bir sağlık katmanı ekler. Herne, sahte bir teslim edilebilirlik puanı hesaplamaz. Bunun yerine, açıkça ortaya çıkan bulgular, gruplanmış kategoriler ve önerilen düzeltmelerle kompakt bir yapısal görüntü depolar.

Sağlık kontrolü kategorileri

  • DNS kimliği: MX, SPF, DKIM, DMARC varlığı ve temel gücü
  • Sunucu kimliği: sunucunun ana bilgisayar adı, Postfix HELO kimliği, posta ana bilgisayarının A/AAAA çözümlemesi, PTR ve ileri sorguyla doğrulanan ters DNS tutarlılığı.
  • SMTP erişilebilirliği: Postfix durumuna ek olarak 25, 465 ve 587 için yerel dinleyiciler
  • IMAP/POP/TLS temelleri: 143, 993, 110 ve 995 için Dovecot durumu ve yerel dinleyiciler ve pratik olduğunda kısmi TLS sağduyu kontrolleri
  • Spam önleme gereksinimleri: Rspamd, gerekli olduğunda Redis, DMARC politikasının gücü, SPF politikasının kapsamı, DKIM DNS kayıtlarının hazır olması, Postfix milter bağlantısı ve giden posta DKIM imzasındaki seçicinin uyumu.
  • Kurulum bütünlüğü: paneldeki durum, sunucudaki dosyalar ve oluşturulan yapılandırmadaki sapmalar
  • Güvenlik Duvarı Görünürlüğü: UFW durumunu ve UFW etkin olduğunda posta portlarının izin verildiğini gösterme

Durumların anlamı

  • geçiş: kontrol Herne'nin topladığı kanıtlara dayanarak başarılı oldu
  • uyarı: kurulum çalışıyor olabilir, ama bir zayıflık veya eşleşmezlik görülüyor
  • dosya: beklenen bir önkoşul açıkça eksik veya bozuk
  • bilinmiyor: kontrol mevcut ortamda güvenle kanıtlanamadı
  • kullanılamaz: kontrol için gerekli araç yerel olarak mevcut değil

PTR kaydı neden önemli

Birçok alıcı sistem, gönderen IP'nin ters DNS'ye sahip olmasını ve bu PTR'nin mantıklı bir e-posta sunucu adıyla uyumlu olmasını bekler. Herne, sadece kamusal IP'yi doğru bir şekilde belirlediği zaman PTR'yi kontrol eder. Yerel rota tabanlı keşif belirsiz ise EMAIL_HEALTH_PUBLIC_IPV4 ve EMAIL_HEALTH_PUBLIC_IPV6'yi ayarlayabilirsiniz.

Sağlıklı sistemin beklenen durumu

  • MX hedeflenen posta sunucusuna işaret ediyor
  • E-posta sunucusu adı mevcut sunucu IP'sine çözüldü
  • PTR aynı posta sunucusuna veya tutarlı bir eşdeğerine işaret eder
  • Postfix myhostname veya smtp_helo_name aynı kanonik posta sunucu adını kullanıyor
  • SPF mevcuttur ve aşırı izin vermez
  • DKIM yayınlandı ve yapılandırılmış seçici ile eşleşti
  • Postfix, Rspamd ve Rspamd işaretleriyle aynı seçici ile çıkan postaları yönlendirir Herne, DNS'de gösterilir
  • DMARC mevcuttur ve ideal olarak gönderme akışlarının doğrulandığında p=none'in ötesine geçer
  • Postfix ve Dovecot, beklenen dinleyicilerle birlikte aktif durumda.
  • Yaşayan temin eserleri var ve panel durumuna uyumludur

Yaygın çözümler

  • Eksik MX: yapılandırılmış posta sunucusuna işaret eden bir MX kaydı yayınla
  • PTR eksik: sunucu IP için ters DNS ayarlarını sunucu sağlayıcısından isteyin
  • PTR uyumsuzluğu: PTR, MX, ve A/AAAA'yı tutarlı bir posta sunucu adının etrafında sırala
  • HELO uyumsuzluğu: Postfix myhostname ya da smtp_helo_name'yi kanonik posta sunucu adına ayarladı
  • SPF çok geniş: izin veren SPF kurallarını daha dar bir gönderici politikasıyla değiştir
  • DKIM DNS geçiyor ama Gmail hala DKIM göstermiyor: smtpd_milters, non_smtpd_milters ve rspamadm configdump dkim_signing'ü kontrol edin
  • DMARC p=none: yasal göndericileri doğruladıktan sonra karantinaya al veya reddet
  • Gönderme eksik: 587 port üzerinde Postfix göndermesini etkinleştir
  • TLS belirsizliği: yapılandırılmış posta sunucu adını kapsayan sertifikayı yükle veya düzelt
  • Provisioning drift: artefaktları yeniden üretmek için domain reprovision veya tam yeniden inşa etkinliğini kullan

Gmail spam sorunlarını giderme

macOS Mail, Webmail ve sunucu üzerinden gönderilen iletilerin tümü Gmail’e ulaşıyor ancak spam klasörüne düşüyorsa, sorunu istemci ayarlarından önce gönderen kimliği veya itibarı açısından inceleyin.

  • php artisan herne:email:health example.com komutunu çalıştırın. Önce PTR, HELO sunucu adı, SPF, DKIM, DMARC, milter ve posta kurulumu uyarılarını giderin.
  • Gönderen IP’nin ters DNS kaydı, MX, A, Postfix, SMTP HELO ve TLS tarafından kullanılan aynı ana sunucu adına işaret etmelidir.
  • Kullanıcıdan Gmail’de Orijinali göster seçeneğini açıp SPF, DKIM, DMARC ve Authentication-Results satırlarını paylaşmasını isteyin. İletinin hangi klasöre düştüğüne bakarak karar vermeyin.
  • Herne’de DNS denetimi DKIM’in hazır olduğunu gösterdiği hâlde Gmail DKIM’in eksik veya hatalı olduğunu bildiriyorsa giden posta imzalama akışını kontrol edin. Postfix milter bağlantısını, Rspamd dkim_signing ayarını, seçiciyi, alan adı bloğunu ve özel anahtarın okunabilirliğini inceleyin.
  • Yeni IP’ler, yeni alan adları veya yakın zamanda düzeltilen gönderen kimlikleri için Gmail Postmaster Tools’u kullanın ve gönderim hacmini kademeli artırın. Kimlik doğrulama başarılı olsa bile gönderen itibarı henüz gelen kutusuna ulaşmak için yeterli olmayabilir.

Postfix entegrasyonu

Kurulum aracı /etc/postfix/main.cf'i Herne tarafından yönetilen harita referanslarıyla cerrahi olarak günceller ve /etc/postfix/master.cf'de sunumu etkinleştirir.Bir referans parçası, hedef kabloları incelemek isteyen operatörler için hala stubs/email/postfix-maincf-snippet.txt'te gönderilir.

Dovecot entegrasyonu

Kurulum programı Dovecot'u Herne tarafından yönetilen bir passwd-file include'a çevirir, Maildir, LMTP ve Postfix kimlik doğrulama soketi parçasını yazar ve canlı dosyalara dokunmadan önce yedek kopyalarını tutar. Bir referans parçası hala stubs/email/dovecot-auth-snippet.conf içinde gönderilir.

Webmail SMTP kimlik doğrulama soketi sorunları

Eğer Webmail gönderme Connection to "mail.example.com:587" has been closed unexpectedly ile başarısız olur ve /var/log/mail.log SASL: Connect to Dovecot auth socket 'private/auth' failed veya no SASL authentication mechanisms gösterirse, Postfix gönderimi Dovecot SASL kimliğine ulaşamaz.

php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --repair
sudo systemctl reload dovecot
sudo systemctl reload postfix
sudo ls -la /var/spool/postfix/private/auth
sudo postconf -n | grep -E 'smtpd_sasl_type|smtpd_sasl_path|smtpd_sasl_auth_enable'
sudo doveconf -n | grep -A8 -B2 '/var/spool/postfix/private/auth'

Beklenen Dovecot dinleyicisi /var/spool/postfix/private/auth, mod 0660, kullanıcı postfix ve grup postfix olmalıdır. Postfix smtpd_sasl_type = dovecot, smtpd_sasl_path = private/auth ve smtpd_sasl_auth_enable = yes kullanmalıdır.

Yedekler ve onarım modu

Herne sistem yapılandırmasını değiştirmeden önce /etc/herne-mail/backups/{timestamp}/... altında zaman damgalı yedekler saklar. Daha önce çalışan Herne posta yapılandırması beklenen durumdan sapmışsa veya el ile kısmen düzenlenmişse php artisan herne:install-mail-stack --repair komutunu yeniden çalıştırın.

İşlemin güvenlik nedeniyle reddedildiği durumlar

Herne, görünüşte uyumsuz bir mevcut Postfix veya Dovecot kurulumu tespit ettiğinde, kanonik posta sunucu adı eksik olduğunda veya komut, sistem konfigürasyonunu güvenli bir şekilde değiştirmek için gerekli root-level erişime sahip olmadığında varsayılan olarak otomatik uygulamayı reddediyor.

Parola karma algoritması

Herne, etkin Dovecot passwd-file kaydı için SHA512-CRYPT kullanır. Paneldeki posta kutusu parolalarının karmaları uygulama veritabanında ayrı tutulur.

Sudoers gereksinimleri

Eski posta hazırlama prosedüründe Herne’ye kapsamı dar sudo erişimi gerekiyordu. O prosedürün komut listesi aşağıdadır:

www-data ALL=(root) NOPASSWD: /usr/bin/install -d *
www-data ALL=(root) NOPASSWD: /usr/bin/install -m *
www-data ALL=(root) NOPASSWD: /bin/cp -f *
www-data ALL=(root) NOPASSWD: /bin/mv *
www-data ALL=(root) NOPASSWD: /bin/rm -rf /etc/herne-mail/.staging-*, /bin/rm -rf /etc/herne-mail/.backup-*
www-data ALL=(root) NOPASSWD: /usr/sbin/postmap *
www-data ALL=(root) NOPASSWD: /usr/bin/test *
www-data ALL=(root) NOPASSWD: /usr/bin/id *
www-data ALL=(root) NOPASSWD: /usr/bin/getent group *
www-data ALL=(root) NOPASSWD: /usr/bin/systemctl reload postfix
www-data ALL=(root) NOPASSWD: /usr/bin/systemctl reload dovecot

Silme davranışı

Herne posta kutusu silme işleminde önce etkin kimlik doğrulama ve eşleme kaydını kaldırır, yönetilen dosyaları yeniden oluşturur ve posta kutusu verilerini kalıcı olarak silmek yerine /var/vmail/.trash/{timestamp}-{domain}-{local_part} yoluna arşivler.

Henüz kapsam dışı

  • Roundcube ya da tam masaüstü sınıfı webmail istemcisi
  • Takma adlar ve yönlendiriciler UI
  • Spam karantinası arayüzü
  • Webmail'de bağlantılar ve dizin yönetimi
  • Çok sunuculu posta kümeleri