Sign-up for mailcow — ghid

Înainte de a începe

Pachetul mailcow Toolkit 0.4.0 sau mai nou, instalat cu install.sh cum scrie în ghidul mailcow Toolkit. Sign-up for mailcow face parte din pachet: nu mai e nimic de descărcat.
Cheia de licență Sign-up for mailcow, din contul tău medialab.works (merge și o cheie de pachet mailcow), sau o adresă de e-mail pentru perioada de probă gratuită de 30 de zile.
Acces HTTPS spre medialab.works de pe server (verificarea licenței) și un mailcow care trimite e-mailuri (confirmare, aprobare și bun venit).
Cel puțin un domeniu mailcow de deschis pentru înregistrare, dacă vizitatorii trebuie să primească cutii poștale.

Instalare și actualizări

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 temporizatorul mlw-mailcow-accounts-<nume>.timer, care rulează sarcinile 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 > Actualizări (Toolkit) sau rulezi noul install.sh. Sign-up rămâne oprit până când are licență și deschizi înregistrările.

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

Licență și perioada de probă gratuită

Deschide System > Actualizări (Toolkit) (doar administratorii). Din 0.4.0 pagina arată câte un card Licență pentru fiecare produs; folosește cardul Licență · Sign-up for mailcow:

Introdu cheia de licență și apasă Activează sau pornește perioada de probă gratuită de 30 de zile cu adresa ta de e-mail: cardul se cere pe pagina de plată Stripe și nu se debitează în cele 30 de zile, iar cardul de licență activează Sign-up singur imediat ce pornește proba. Fiecare unealtă mailcow are propria perioadă de probă, o dată pe server și pe adresă de e-mail.
Cu o cheie de pachet mailcow, introdu aceeași cheie în cardul de licență al fiecărui produs.
Din terminal, în folderul mailcow: docker compose exec -u www-data php-fpm-mailcow php /web/mlw-toolkit/cli.php activate mailcow-signup <CHEIE>.

Licența se verifică la pornirea serverului și o dată pe zi; fără internet, Sign-up funcționează 7 zile de la ultima verificare reușită. Fără o licență validă înregistrările se închid (pagina publică spune că înregistrarea nu e disponibilă), iar sarcinile din fundal ale Sign-up se opresc; conturile, cutiile poștale și domeniile existente nu sunt atinse niciodată.

Deschiderea înregistrărilor

Deschide System > Sign-up. Cardul Înregistrare are alegerile principale; salvează formularul cu butonul de la sfârșitul lui.

Înregistrări deschise — pornește pagina publică /mlw-signup/. Pagina de conectare mailcow arată atunci linkul Creează un cont (pe interfață și pe numele de gazdă al webmail-ului).
O cutie poștală pe unul dintre domeniile tale — bifeaz-o și alege Domenii deschise pentru înregistrare. Setează Min. caractere și Max. caractere pentru numele de dinainte de @, Cotă gratuită (MB), Alte nume rezervate (numele de rol, ca postmaster, abuse, admin, support și noreply, sunt mereu rezervate) și Șablon mailcow pentru cutii (gol = implicitul mailcow).
Un administrator de domeniu pentru domeniile clientului — clientul își adaugă domeniile după verificarea DNS (TXT), în limitele pachetului. Pachetul gratuit stabilește Domenii, Cutii/domeniu, Aliasuri/domeniu, Cotă/domeniu (MB) și Cotă implicită/cutie (MB); Șablon mailcow pentru domenii se folosește pentru domeniile noi ale clienților. Cu opțiunea despre asistentul pentru domenii noi, asistentul din Toolkit creează adresele de rol ale unui domeniu de client spre e-mailul clientului.
Înregistrare gratuită (pe lângă planurile plătite din Cashier) — las-o bifată pentru conturi gratuite; debifeaz-o când fiecare cont trebuie să cumpere un plan cu Cashier for mailcow.

Confirmare, aprobare și invitații

În cardul Confirmare, aprobare, invitații:

Confirmarea adresei — cod de 6 cifre, link, cod și link sau fără (nerecomandat). Expiră (ore) — de la 1 la 168. Un vizitator poate cere un e-mail nou după un minut, de cel mult 5 ori pe zi, și are 5 încercări pentru un cod.
Aprobare de administrator — înregistrările gratuite așteaptă un administrator; completează E-mail pentru înregistrările de aprobat ca să afli de fiecare înregistrare nouă. Înregistrările plătite nu așteaptă niciodată aprobarea.
Cod de invitație — oprit, opțional sau obligatoriu.
Link spre termeni (cere acceptarea) — un link spre termenii tăi; vizitatorul trebuie să-i accepte.
Câmpuri din formular — nume, companie, telefon și țară: oprite, opționale sau obligatorii.

Aprobarea înregistrărilor

Cardul Înregistrări arată lista Așteaptă aprobarea. Aprobă creează contul și trimite e-mailul de bun venit; Respinge (cu un Motiv opțional) îi trimite vizitatorului un e-mail cu decizia. Recente arată ultimele înregistrări și starea lor.

Coduri de invitație

În Coduri de invitație completează Cod (gol = aleator), Folosiri (0 = nelimitat), Expiră, Tip de cont (cutie poștală, domeniu sau oricare) și, cu Cashier, Planul pe care îl deschide codul (inclusiv unul ascuns), bifează Fără aprobare dacă, cu acest cod, nu e nevoie de aprobare, adaugă o Notă și apasă Creează codul. Lista arată de câte ori a fost folosit fiecare cod; Dezactivează și Activează îl opresc și îl pornesc.

Împotriva abuzului

În cardul Împotriva abuzului:

Timp minim de completare (s) — un formular trimis mai repede e refuzat (roboți). Un câmp ascuns prinde singur roboții cei mai simpli.
Înregistrări / IP / zi (0 = fără limită).
Blochează adresele temporare — lista încorporată plus lista MediaLab Works, care vine la verificarea licenței cât timp licența e validă.
Doar aceste domenii de e-mail (gol = oricare) și Domenii de e-mail blocate — separate prin spații, virgule sau rânduri noi. Un domeniu acoperă și subdomeniile lui; *.example.com înseamnă doar subdomeniile.
Parola trebuie să respecte regulile de parolă ale mailcow, cele setate în interfața de admin mailcow.

Conturi noi

În cardul Conturi noi: Text propriu în e-mailul de bun venit (engleză și română), Numele expeditorului e-mailurilor (gol = numele serverului de e-mail) și Conectează automat browserul care s-a înregistrat (pornit implicit).

O cutie poștală gratuită se creează imediat ce adresa e confirmată (și aprobată). Un administrator de domeniu se creează odată cu primul domeniu verificat: până atunci clientul are pagina Contul meu, unde pasul următor e adăugarea domeniului.

Domeniile proprii ale clientului

Clientul deschide Contul meu (/mlw-signup/account.php, și în meniul mailcow cât e conectat) și adaugă un domeniu. Pagina arată o înregistrare TXT de publicat la furnizorul lui de DNS:

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

Verifică o caută imediat; Sign-up verifică și singur la fiecare 10 minute, timp de 7 zile. Când înregistrarea e găsită, domeniul se adaugă în mailcow cu limitele pachetului, iar pagina arată înregistrările DNS ale domeniului (obligatorii și recomandate) pe care trebuie să le seteze clientul: MX, SPF, DKIM, DMARC, autodiscover și celelalte, calculate de modulul DNS al Toolkit-ului. Un administrator poate verifica un domeniu din terminal, în folderul mailcow: docker compose exec -u www-data php-fpm-mailcow php /web/mlw-signup/cli.php verify example.com.

Domeniile clienților nu intră în configurarea automată Cloudflare a contului tău (clientul își administrează singur DNS-ul).

Date, copii de rezervă și dezinstalare

Înregistrările, clienții și codurile de invitație sunt în baza de date a mailcow (tabelele mlw_su_*), deci intră în copiile de rezervă ale mailcow. Setările sunt în folderul comun al Toolkit-ului.
Temporizatorul mlw-mailcow-accounts-<nume>.timer rulează la fiecare 5 minute: șterge înregistrările expirate și verifică domeniile clienților aflate în așteptare.
uninstall.sh dezinstalează Sign-up odată cu Toolkit-ul, dar păstrează tabelele și fiecare cutie poștală, domeniu și administrator de domeniu create prin el.

Probleme frecvente

Pagina de conectare nu arată linkul „Creează un cont”. Înregistrările sunt închise, licența nu e validă sau nu se oferă niciun tip de cont (niciun domeniu deschis pentru cutii poștale și niciun administrator de domeniu). Verifică cardul de licență și System > Sign-up.

Pagina publică spune că înregistrarea nu e disponibilă. Aceleași cauze: licența (vezi mesajul din cardul de licență) sau Înregistrări deschise.

Vizitatorii nu primesc e-mailul de confirmare. Verifică dacă mailcow livrează e-mailurile trimise (mesajele pleacă prin mailcow) și folderul de spam. După 5 e-mailuri într-o zi, adresa trebuie să aștepte ziua următoare.

Un domeniu de client rămâne „Așteaptă verificarea”. Înregistrarea TXT lipsește, are altă valoare sau nu s-a propagat încă. Verific-o cu dig TXT _mlw-verify.example.com. După 7 zile verificările automate se opresc; Verifică merge în continuare.

Un domeniu a fost refuzat. E deja pe acest server, îl adaugă alt cont sau pachetul clientului nu mai are niciun domeniu liber (un plan mai mare, cu Cashier, permite mai multe).