Pagină de înregistrare pentru mailcow: cutii poștale sau administratori de domeniu după confirmarea adresei

Dacă rulezi mailcow pentru o școală, un club, o comunitate sau câțiva clienți mici, cunoști deja blocajul: mailcow-dockerized nu are o pagină de înregistrare, așa că fiecare cutie poștală și fiecare domeniu trec prin mâinile unui administrator. E în regulă pentru cinci conturi; devine dureros pentru cincizeci. Sign-up for mailcow adaugă o pagină publică, /mlw-signup/, pe propriul tău mailcow, astfel încât vizitatorii să își poată crea singuri contul, în limitele pe care le stabilești, și numai după ce își confirmă adresa de e-mail. Acest tutorial parcurge configurarea pentru cazul furnizor/școală/comunitate: ce primesc vizitatorii, cum sunt gestionate numele și cotele, cum se îmbină confirmarea, aprobarea și codurile de invitație și cum ții abuzul departe.

Ce primești și ce rămâne în mâinile tale

Plugin-ul vine în pachetul mailcow Toolkit (0.4.0 sau mai nou) și are propria licență. Adaugă o pagină publică de înregistrare pe interfața mailcow și pe numele de gazdă al webmail-ului; cât timp înregistrările sunt deschise, pagina de conectare mailcow afișează un link Creează un cont. Tu decizi ce poate primi un vizitator: o cutie poștală pe unul dintre domeniile pe care le deschizi pentru înregistrare, un cont de administrator de domeniu pentru domeniile proprii ale vizitatorului, sau ambele. Conturile sunt create cu funcțiile proprii ale mailcow, folosind șabloanele și limitele tale, exact ca și cum le-ar fi adăugat un administrator.

Promisiunea esențială pentru oricine rulează un server partajat: nimic nu se creează în mailcow înainte ca adresa să fie confirmată (și aprobată, sau plătită cu Cashier for mailcow). Înregistrările neconfirmate pur și simplu expiră.

Cerințe preliminare

• Pachetul mailcow Toolkit 0.4.0 sau mai nou instalat pe mailcow-dockerized (Linux, docker compose, systemd), cu acces root pe gazdă pentru a rula install.sh. Sign-up face parte din pachet; nu mai e nimic de descărcat.
• HTTPS ieșire către medialab.works de pe server (verificarea licenței) și un mailcow care trimite e-mailuri (mesaje de confirmare, aprobare și bun venit).
• Cel puțin un domeniu mailcow pe care să îl deschizi pentru înregistrare, dacă vizitatorii trebuie să primească cutii poștale.
• Pentru domeniile proprii: clientul trebuie să poată adăuga o înregistrare TXT la furnizorul său de DNS.
• Pentru planurile plătite: Cashier for mailcow, cu propria licență. Pentru conturile gratuite nu ai nevoie de el.

Pasul 1 — Instalează sau actualizează Toolkit-ul

install.sh din pachet (0.4.0 sau mai nou) instalează Sign-up lângă Toolkit: fișierele web în data/web/mlw-signup din mailcow, folderul de setări, tabelele mlw_su_* în baza de date a mailcow și timer-ul mlw-mailcow-accounts-<name>.timer, care rulează joburile Sign-up și Cashier la fiecare 5 minute. Un Toolkit deja instalat primește toate acestea când îl actualizezi la 0.4.0 din System > Updates (Toolkit) sau rulând noul install.sh. Sign-up rămâne oprit până când este licențiat și până când deschizi înregistrările.

Sign-up se actualizează împreună cu Toolkit-ul: un pachet, o actualizare. Actualizarea poate fi pornită din cardul License al oricărui produs cu licență validă.

Pasul 2 — Activează licența

Deschide System > Updates (Toolkit) (doar administratorii). Începând cu 0.4.0, pagina afișează un card License pentru fiecare produs; folosește cardul License · Sign-up for mailcow. Introdu cheia de licență și apasă Activate, sau pornește perioada de probă gratuită de 30 de zile cu adresa ta de e-mail. Cu o cheie de pachet mailcow, introdu aceeași cheie în cardul License al fiecărui produs. În shell poți rula și, din folderul mailcow:

docker compose exec -u www-data php-fpm-mailcow php /web/mlw-toolkit/cli.php activate mailcow-signup <KEY>

Licența este verificată la pornirea serverului și o dată pe zi; fără internet, Sign-up funcționează în continuare 7 zile după ultima verificare reușită. Fără o licență validă, înregistrările se închid și joburile din fundal pentru Sign-up se opresc — conturile, cutiile poștale și domeniile existente nu sunt niciodată atinse.

Pasul 3 — Alege ce primesc vizitatorii

Deschide System > Sign-up. Cardul Registration conține alegerile principale; salvează formularul cu butonul de la finalul lui.

• Registrations open activează pagina publică și afișează linkul Creează un cont pe pagina de conectare mailcow (interfața și numele de gazdă al webmail-ului).
• O cutie poștală pe unul dintre domeniile tale: bifează și alege Domains open for registration. Setează Min. characters și Max. characters pentru numele dinaintea lui @, Free quota (MB), More reserved names (numele de rol precum postmaster, abuse, admin, support și noreply sunt întotdeauna rezervate) și mailcow mailbox template (gol = valoarea implicită a mailcow). Pentru o școală sau un club aceasta este de obicei toată configurarea: deschizi un domeniu, rezervi numele de rol, setezi o cotă rezonabilă.
• Un administrator de domeniu pentru domeniile proprii ale clientului: clientul adaugă domenii după o verificare DNS (TXT), în limitele pachetului. Free package stabilește Domains, Mailboxes/domain, Aliases/domain, Quota/domain (MB) și Default quota/mailbox (MB); mailcow domain template este folosit pentru domeniile noi ale clienților. Cu opțiunea despre new domain wizard, wizard-ul Toolkit-ului creează adresele de rol ale unui domeniu al clientului către e-mailul clientului.
• Free registration (next to Cashier's paid plans): lasă bifat pentru conturi gratuite; debifează când fiecare cont trebuie să cumpere un plan.

Pasul 4 — Confirmare, aprobare și invitații

În cardul Confirmation, approval, invitations:

• Address confirmation: cod de 6 cifre, link, cod și link, sau niciunul (nerecomandat). Expires (hours) merge de la 1 la 168. Un vizitator poate cere un e-mail nou după un minut, cel mult de 5 ori pe zi, și are 5 încercări pe cod.
• Administrator approval: înregistrările gratuite așteaptă un administrator; setează E-mail for registrations to approve pentru a fi anunțat despre fiecare înregistrare nouă. Înregistrările plătite nu sunt niciodată reținute pentru aprobare. Pentru o școală, acesta este modul discret de a ține lista membrilor curată.
• Invitation code: oprit, opțional sau obligatoriu.
• Terms link (asks for acceptance): un link către termenii tăi; vizitatorul trebuie să îi accepte.
• Form fields: nume, companie, telefon și țară — oprite, opționale sau obligatorii.

Aprobarea înregistrărilor

Cardul Registrations le listează pe cele Waiting for approval. Approve creează contul și trimite e-mailul de bun venit; Reject (cu un Reason opțional) îi trimite vizitatorului un e-mail cu decizia. Recent afișează ultimele înregistrări și starea lor.

Coduri de invitație

În Invitation codes completează Code (empty = random), Uses (0 = unlimited), Expires, Account kind (cutie poștală, domeniu sau oricare) și, cu Cashier, Plan-ul pe care îl deschide codul (inclusiv unul ascuns), bifează No approval dacă codul trebuie să sară peste aprobare, adaugă o Note și apasă Create the code. Lista arată cât de des a fost folosit fiecare cod; Disable și Enable îl opresc și îl pornesc. Pentru o comunitate, un singur cod cu multiple folosiri, cu expirare și fără aprobare este adesea echilibrul potrivit: membrii intră fără să aștepte, străinii nu.

Pasul 5 — Configurează anti-abuzul

În cardul Anti-abuse:

• Minimum time to fill in (s): un formular trimis mai repede este refuzat. Un câmp ascuns prinde singur cei mai simpli boți.
• Registrations / IP / day (0 = no limit).
• Block disposable addresses: lista încorporată plus lista MediaLab Works, care sosește odată cu verificarea licenței cât timp licența este validă.
• Only these e-mail domains (empty = any) și Blocked e-mail domains, separate prin spații, virgule sau linii noi. Un domeniu acoperă și subdomeniile lui; *.example.com înseamnă doar subdomeniile. Pentru o școală, restricționarea la propriul domeniu (și poate la al unui partener) este un filtru puternic și simplu.
• Parola trebuie să respecte politica de parole proprie a mailcow, cea setată în interfața de administrare a mailcow.

Pasul 6 — E-mailul de bun venit și conectarea

În cardul New accounts: Own text in the welcome e-mail (engleză și română), Sender name of the e-mails (gol = numele de gazdă al mail-ului) și Sign in the browser that registered (pornit implicit). O cutie poștală gratuită este creată imediat ce adresa este confirmată (și aprobată). Un administrator de domeniu este creat odată cu primul domeniu verificat: până atunci clientul are o pagină, My account, unde pasul următor este adăugarea domeniului.

Pasul 7 — Domeniile proprii ale clientului

Clientul deschide My account (/mlw-signup/account.php, disponibil și în meniul mailcow cât timp este conectat) și adaugă un domeniu. Pagina afișează o înregistrare TXT de publicat la furnizorul de DNS al clientului:

_mlw-verify.example.com.  TXT  "mlw-verify=<token>"

Verify o verifică imediat; Sign-up verifică de asemenea la fiecare 10 minute timp de 7 zile. Când înregistrarea este găsită, domeniul este adăugat în mailcow cu limitele pachetului (domenii, cutii poștale, aliasuri, cotă), iar pagina afișează înregistrările DNS de care are nevoie domeniul (MX, SPF, DKIM, DMARC și cele recomandate), calculate de modulul DNS al Toolkit-ului. Wizard-ul de domenii noi al Toolkit-ului poate trimite adresele de rol ale unui domeniu al clientului către client, iar domeniile clienților sunt ținute în afara configurării tale automate Cloudflare.

Sfaturi și depanare

• Lipsește linkul Creează un cont. Verifică faptul că Registrations open este salvat și că licența este validă: fără ea, pagina publică afișează că înregistrarea nu este disponibilă, iar linkul dispare.
• Vizitatorii nu primesc e-mailul de confirmare. Sign-up se bazează pe trimiterea de e-mailuri de către mailcow; testează mailul de ieșire înainte de a deschide pagina.
• O înregistrare nu se finalizează niciodată. Înregistrările neconfirmate expiră; vizitatorul poate cere un e-mail nou după un minut, de până la 5 ori pe zi, cu 5 încercări pe cod. Dacă aprobarea este pornită, caută în Registrations > Waiting for approval.
• Un nume este refuzat. Numele de rol precum postmaster, abuse, admin, support și noreply sunt întotdeauna rezervate; adaugă-le pe ale tale sub More reserved names și verifică lungimea minimă și maximă.
• Un domeniu rămâne neverificat. Înregistrarea TXT trebuie să fie exact _mlw-verify.<domain> cu valoarea afișată; verificarea rulează la fiecare 10 minute timp de 7 zile, după care clientul trebuie să o adauge din nou.
• Date și backup-uri. Înregistrările sunt păstrate în baza de date proprie a mailcow (tabelele mlw_su_*), deci fac parte din backup-urile mailcow. Setările se află în folderul Toolkit-ului de pe server.

Concluzie

Pentru un furnizor, o școală sau o comunitate, valoarea înregistrării publice nu stă doar în viteză — ci în faptul că fiecare cont este mărginit de regulile pe care le-ai scris o singură dată: nume rezervate, cote, domenii permise, coduri de invitație și aprobare acolo unde contează. Nimic nu ajunge în mailcow până când adresa nu este confirmată, iar dacă licența expiră vreodată, înregistrările noi se opresc în timp ce tot ce există deja continuă să funcționeze. Referința completă a opțiunilor se află în ghidul utilizatorului; pagina produsului este Sign-up for mailcow, iar changelog-ul urmărește actualizările. Dacă ceva nu se comportă așa cum este descris aici, baza de cunoștințe și FAQ sunt următoarea oprire, iar ne poți contacta oricând.