Formular de Contact Gratuit cu Cloudflare Workers și KV

Site-urile statice sunt ideale: sunt rapide, sigure și extrem de ieftin de găzduit. Dar cum rezolvi problema elementelor dinamice – precum un formular de contact – fără să complici arhitectura cu un backend clasic sau să plătești abonamente SaaS inutile?

Aceasta a fost provocarea de la care am pornit pentru două dintre proiectele noastre (un site de prezentare și unul personal), ambele dezvoltate cu Next.js (static export) și rulate direct pe Cloudflare Workers ca asset-uri statice. Ne-am dorit o soluție fără backend dedicat, cu costuri zero și fără dependențe externe.

Răspunsul a fost unul simplu și elegant: Cloudflare Workers și Workers KV.

De ce Cloudflare Workers și KV pentru formularul de contact?

Cloudflare Workers este o platformă serverless care rulează cod (JavaScript, Rust sau C++) direct la marginea rețelei (edge), asigurând latențe minime și performanțe excelente [1]. Serviciul acționează ca un „creier serverless” [1], preluând logica de backend fără a fi nevoie de administrarea unui server dedicat.

Pentru stocare, apelăm la Cloudflare Workers KV (Key-Value): o bază de date NoSQL simplă, extrem de rapidă și distribuită global în cele 335 de locații Cloudflare [4]. KV este ideală pentru stocarea datelor de volum mic, cum sunt mesajele din formulare [2]. Cel mai mare avantaj? Ambele servicii vin cu un plan gratuit extrem de generos, ideal pentru site-uri mici și medii [5], [11]. Un exemplu concret este cel al lui Antonio Pagano, care a înlocuit un serviciu de 200$/lună cu o astfel de soluție cu cost zero [1].

Cum funcționează arhitectura unui formular de contact cu Workers și KV

Mecanismul este simplu: formularul trimite o cerere POST către un endpoint. Worker-ul preia datele, le validează și le salvează direct în Workers KV. Ulterior, mesajele pot fi accesate sau descărcate oricând direct din consolă sau prin CLI.

Ce am învățat pe pielea noastră construind formularul

1. O arhitectură integrată și curată Am integrat logica în același Worker care servește fișierele statice ale site-ului. Folosind un binding de tip main + assets în wrangler.toml și directiva run_worker_first, Worker-ul interceptează cererile POST pe /api/contact. Datele sunt validate riguros pe server (lungime text, regex pentru email, câmpuri obligatorii), apoi sunt salvate în KV. Cheile de stocare folosesc un format cronologic (ex: contact-YYYYMMDDHHMMSS-randomID), permițând sortarea simplă a mesajelor. Rezultatul? Zero infrastructură administrată și costuri zero.

2. Anti-spam inteligent, fără CAPTCHA enervant Pentru a nu strica experiența utilizatorilor, am evitat sistemele clasice CAPTCHA. În schimb, am implementat o capcană „honeypot”: un câmp suplimentar ascuns prin CSS/JS (de exemplu, website). Utilizatorii reali nu-l văd, însă bot-urile de spam îl completează automat. Dacă acest câmp conține date, Worker-ul returnează instant un status 200 OK (pentru a păcăli bot-ul că trimiterea a reușit), dar nu salvează nimic în baza de date. Lipsa unei astfel de protecții ne-a adus în trecut, pe un alt proiect, peste 86.000 de înregistrări de spam în baza de date. Despre eficiența Workers KV și protecția anti-spam au scris și alți dezvoltatori, precum Dave Long [6] sau comunitatea axată pe securitate [7], [9].

3. Consimțământ GDPR versionat Conformitatea GDPR cere dovezi clare. Nu este suficient să știi că utilizatorul a bifat o căsuță, ci trebuie să știi exact ce text a aprobat în acel moment. De aceea, salvăm în KV și versiunea politicii de confidențialitate active la momentul trimiterii (ex: v1-2026-07). Dacă modificăm termenii în viitor, vom ști cu precizie ce acord și-a dat fiecare persoană.

4. Degradare controlată (Fallback elegant) Un formular de contact nu are voie să devină un punct unic de eșec (single point of failure). Dacă conexiunea cu KV pică sau serviciul devine indisponibil, API-ul returnează 503 Service Unavailable. Frontend-ul interceptează eroarea și afișează un fallback util: un link mailto: precompletat cu subiectul și mesajul deja scrise. Astfel, utilizatorul poate trimite mailul clasic, fără a pierde textul redactat.

5. Securitate nativă: fără cookie-uri, fără CSRF clasic Deoarece formularul nu folosește sesiuni sau cookie-uri, atacurile de tip Cross-Site Request Forgery (CSRF) sunt excluse din start. Validarea pe server, controlul originii cererilor (CORS) și honeypot-ul oferă o securitate robustă implicită. Totuși, dacă ulterior adăugați autentificare bazată pe cookie-uri, va trebui să implementați token-uri anti-CSRF dedicate.

6. Capcana din Wrangler: atenție la flag-ul --remote Am pierdut zeci de minute încercând să înțelegem de ce datele nu apăreau în KV. În wrangler v4, comenzile CLI (cum ar fi wrangler kv namespace list) interoghează implicit baza de date locală de testare. Pentru a vedea sau manipula datele reale din producție, trebuie să adăugați obligatoriu flag-ul --remote. Detalii complete despre utilizarea corectă a instrumentelor Wrangler se găsesc în documentația oficială Cloudflare [2], [3], [10].

7. Notificările prin email: decizia pragmatică Workers nu pot trimite emailuri direct prin SMTP (portul 25 este blocat din motive de securitate). Opțiunile clasice implică utilizarea unui API terț, cum ar fi Resend, AWS SES sau SendGrid [7]. Pentru început, noi am ales o abordare minimalistă: stocare exclusivă în KV și verificare periodică. Acest lucru a eliminat orice dependență de servicii externe și a păstrat costurile la zero absolut. Totuși, pentru integrări mai complexe, se pot folosi și alte instrumente, precum Airtable [12], ca alternativă la KV.

8. Testarea end-to-end este obligatorie Înainte de lansare, simulați scenarii reale: efectuați un POST în producție și verificați apariția cheii în KV (wrangler kv key list --remote). Testați și scenariile negative: o adresă de email invalidă trebuie să returneze 422 Unprocessable Entity, iar o tentativă de spam (cu honeypot-ul completat) trebuie să returneze 200 OK fără a genera o înregistrare în KV.

Concluzie

Implementarea unui formular de contact folosind Cloudflare Workers și KV este o soluție modernă, rapidă, sigură și complet gratuită. Elimină complexitatea unui backend tradițional și valorifică la maximum rețeaua edge globală a Cloudflare. Aceasta este dovada că un site static nu trebuie să fie limitat, ci poate căpăta un „suflet dinamic” [1] prin tehnologii serverless inteligente.

Dacă dețineți un site static și vreți să scăpați de costurile și mentenanța serviciilor terțe, această arhitectură reprezintă cea mai bună investiție de timp pe care o puteți face.