Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
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.
- Brevo-fiók létrehozása.
- Senders, Domains & Dedicated IPs → Domains → Add a domain:
sorsfonalak.hu. A Brevo kiírja a szükséges DNS-rekordokat (lásd 2. pont). - Senders: feladó felvétele, javaslat:
hello@sorsfonalak.hu. Anoreplycím a szűrőknél rosszabb, és válaszolni sem lehet rá. - SMTP & API → SMTP: itt van az SMTP-login (
…@smtp-brevo.comalakú) é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=spf1rekordja lehet, a szolgáltatókat abba kell összevonni (példáulv=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.hucí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áulabc123%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
- Admin → Meghívók → Teszt küldése magamnak: megérkezik-e, és nem a spamben van-e.
- A Gmailben a levélnél ⋮ → Eredeti megjelenítése: az SPF, a DKIM és a DMARC mellett is
PASSálljon. - 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-IDa feladó domainjén.List-UnsubscribeésList-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.