Files
sorsfonalak/docs/levelkuldes.md
T
fecoandClaude Opus 5.5 7f761a0f0e
CI / test (push) Successful in 52s
CI / build (push) Successful in 11s
CI / deploy (push) Skipped
docs: allow outbound TCP 2525 in the droplet firewall for mail
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-17 18:37:32 +00:00

4.2 KiB

Levélküldés élesben (meghívók, értesítések)

Élesben most nincs levélküldő beállítva (SMTP_URL üres), így minden levél az email_outbox táblában vár. Amíg ez így van, a meghívót kézzel is továbbadhatod: az admin „Meghívók” oldala küldés után kiírja a linket („Link másolása”).

A meghívó a legkényesebb levéltípus, mert a címzett nem kérte. A spammappát elsősorban a feladó hírneve és a domain hitelesítése dönti el, a sablon csak ezután számít. Ezért kell a lenti négy lépés.

1. Levélküldő szolgáltatás

Javaslat: Brevo (EU-s, napi 300 levélig ingyenes; egy induló, meghívásos oldalnak bőven elég). Ha később fontosabb lesz a kézbesítési arány, a Postmark (fizetős) a legjobb; a beállítás ugyanígy megy.

A DigitalOcean a dropleteken alapból tiltja a kimenő SMTP-portokat (25, 465, 587), ezért a 2525-ös portot kell használni; ezt a Brevo és a Postmark is tudja.

A droplet saját tűzfala (sorsfonalak-fw, DigitalOcean → Networking → Firewalls) a kimenő forgalmat is szűri: az Outbound rules közé fel kell venni a TCP 2525-öt (cél: All IPv4, All IPv6), különben a worker nem éri el a levélküldőt.

  1. Brevo-fiók létrehozása.
  2. Senders, Domains & Dedicated IPs → Domains → Add a domain: sorsfonalak.hu. A Brevo kiírja a szükséges DNS-rekordokat (lásd 2. pont).
  3. Senders: feladó felvétele, javaslat: hello@sorsfonalak.hu. A noreply cím a szűrőknél rosszabb, és válaszolni sem lehet rá.
  4. SMTP & API → SMTP: itt van az SMTP-login (…@smtp-brevo.com alakú) és egy új SMTP-kulcs (ez a jelszó).

2. DNS a Cloudflare-en

A rekordokat a Brevo pontosan megadja; ezek szoktak lenni:

Típus Név Tartalom
TXT sorsfonalak.hu brevo-code:… (a domain igazolása)
CNAME brevo1._domainkey a Brevo által megadott cél (DKIM)
CNAME brevo2._domainkey a Brevo által megadott cél (DKIM)
TXT _dmarc v=DMARC1; p=none; rua=mailto:<a te címed>
  • A CNAME-ek legyenek DNS only (szürke felhő), különben a DKIM nem működik.
  • SPF: ha a Brevo kér SPF-et, egy domainnek csak egy v=spf1 rekordja lehet, a szolgáltatókat abba kell összevonni (például v=spf1 include:spf.brevo.com ~all).
  • DMARC: induláskor p=none (csak jelentés). Ha pár hétig minden levél átmegy a DKIM-en, szigorítható p=quarantine-ra.
  • Ha a hello@sorsfonalak.hu címre érkező válaszokat is olvasni szeretnéd: a Cloudflare Email Routing ingyen továbbítja őket a Gmailedre. Ez MX- és SPF-rekordot is ad; az SPF-et ilyenkor a Brevóéval egy rekordba kell összevonni.

3. A szerver .env fájlja

/opt/sorsfonalak/.env:

SMTP_URL=smtp://<login>:<smtp-kulcs>@smtp-relay.brevo.com:2525?tls=required
MAIL_FROM=Sorsfonalak <hello@sorsfonalak.hu>
  • A loginban lévő @ jelet %40-re kell írni (például abc123%40smtp-brevo.com), mert az URL-ben az @ választja el a jelszót a géptől.
  • Utána: docker compose up -d worker. A naplóban ennek kell megjelennie: e-mail delivery enabled.
  • Az eddig várakozó levelek ekkor kimennek. Ha ezt nem szeretnéd, előtte töröld őket: DELETE FROM email_outbox WHERE sent_at IS NULL;.

4. Próba

  1. Admin → Meghívók → Teszt küldése magamnak: megérkezik-e, és nem a spamben van-e.
  2. A Gmailben a levélnél ⋮ → Eredeti megjelenítése: az SPF, a DKIM és a DMARC mellett is PASS álljon.
  3. A mail-tester.com ad egy egyszeri címet: küldj rá meghívót az admin oldalról (utána vond vissza), és nézd meg a pontszámot. 9/10 fölött jó.

Amit a kód már elintéz

  • HTML és szöveges változat ugyanazzal a tartalommal; egyhasábos, képek és követés nélkül; minden link a saját domainre mutat.
  • Message-ID a feladó domainjén.
  • List-Unsubscribe és List-Unsubscribe-Post (RFC 8058): a Gmail és a többi levelező saját „Leiratkozás” gombot mutat. Aki leiratkozik, annak a címére soha többé nem megy meghívó (email_optouts, csak a cím hash-e).
  • Meghívót csak admin küldhet; egy meghívó legfeljebb háromszor megy ki, 24 óránként egyszer. A személyes üzenet legfeljebb 300 karakter, és nem lehet benne link.