Pocketbase: Firebase alternatyva

Kas yra Pocketbase ir kodėl apie jį verta žinoti

Jei kada nors kūrėte mobilią aplikaciją ar web projektą, turbūt susidūrėte su Firebase. Tai puikus įrankis, bet kartais jaučiasi, kad Google’as per daug įsikišęs į jūsų projektą, o kainos gali netikėtai išaugti. Čia ir ateina Pocketbase – open-source backend sprendimas, kuris telpa į vieną failą ir veikia be jokių išorinių priklausomybių.

Pocketbase sukurtas Go programavimo kalba ir iš esmės tai vienas vykdomasis failas, kurį galite paleisti bet kurioje sistemoje. Jokių sudėtingų diegimų, jokių konteinerių (nors galite naudoti ir juos, jei norite), jokių priklausomybių. Tiesiog atsisiuntėte, paleidote ir turite veikiantį backend su duomenų baze, autentifikacija, realiu laiku atnaujinimais ir net admin panele.

Kas įdomiausia – Pocketbase nėra bandymas nukopijuoti Firebase. Tai savarankiškas projektas su savo filosofija. Jis sukurtas būti paprastu, lengvai prižiūrimu ir visiškai jūsų kontroliuojamu. Nereikia mokėti už duomenų bazės užklausas, nereikia baimintis, kad staiga pakeistos sąlygos ar kainos, ir svarbiausia – viskas veikia jūsų serveryje.

Techninė architektūra ir galimybės

Pocketbase viduje naudoja SQLite duomenų bazę. Kai kurie gali pakelti antakius – SQLite? Ar tai rimta? Atsakymas: taip, labai rimta. SQLite yra viena patikimiausių duomenų bazių sistemų pasaulyje, naudojama milijonuose įrenginių. Ji puikiai tinka mažiems ir vidutiniams projektams, o su tinkamu konfigūravimu gali aptarnauti ir gana didelį srautą.

Sistema palaiko visas pagrindines backend funkcijas. Turite autentifikaciją su email/slaptažodžiu, OAuth2 integraciją (Google, Facebook, GitHub ir kiti), JWT token’us, slaptažodžių atkūrimą. Duomenų bazės lygmenyje galite kurti kolekcijas (lenteles), nustatyti laukų tipus, validacijas, ryšius tarp lentelių. Yra net failų saugykla su automatiniais thumbnail’ais paveikslėliams.

Realaus laiko funkcionalumas įgyvendintas per Server-Sent Events (SSE). Tai reiškia, kad galite prenumeruoti bet kokius duomenų pasikeitimus ir gauti atnaujinimus realiu laiku. Nereikia WebSocket’ų, nereikia sudėtingų konfigūracijų – tiesiog veikia iš dėžės.

Kūrėjams labai patinka tai, kad Pocketbase galima išplėsti. Tai ne juodoji dėžė – galite rašyti savo hooks’us, middleware, custom endpoints. Jei mokate Go, galite Pocketbase naudoti kaip framework’ą ir kurti ant jo savo logiką. Jei ne – tiesiog naudokite REST API ir JavaScript/Dart/Python SDK.

Kaip pradėti: praktinis vadovas

Pradėti su Pocketbase yra juokingai paprasta. Eikite į oficialią svetainę, atsisiųskite failą savo operacinei sistemai. Linux/Mac vartotojams tai bus vienas failas, kurį reikia padaryti vykdomą su chmod +x pocketbase. Windows vartotojams – .exe failas.

Paleidžiate komandą ./pocketbase serve ir viskas – serveris veikia. Pagal nutylėjimą jis startuoja ant http://127.0.0.1:8090. Atsidarote naršyklėje šį adresą su /_/ keliu ir matote admin panelę. Pirmą kartą paleidus, sistema paprašys sukurti admin paskyrą.

Admin panelis yra tikrai gerai padaryta dalis. Čia galite kurti kolekcijas, nustatyti laukų tipus (text, number, email, url, file, relation ir t.t.), konfigūruoti API taisykles, valdyti vartotojus. Viskas intuityviai ir greitai. Nereikia rašyti SQL užklausų ar migracijų – bent jau pradžioje.

Sukūrę kolekcijas, galite iš karto pradėti naudoti API. Pocketbase automatiškai sugeneruoja REST endpoints visoms jūsų kolekcijoms. Pavyzdžiui, sukūrę „posts” kolekciją, galite daryti GET, POST, PATCH, DELETE užklausas į /api/collections/posts/records. Dokumentacija aiški ir su pavyzdžiais.

Jei norite integruoti į frontend, yra oficialus JavaScript SDK:


import PocketBase from 'pocketbase';
const pb = new PocketBase('http://127.0.0.1:8090');

// Realaus laiko prenumerata
pb.collection('posts').subscribe('*', function (e) {
console.log(e.action); // create, update, delete
console.log(e.record);
});


Saugumo konfigūravimas ir API taisyklės

Vienas iš svarbiausių dalykų bet kokiame backend’e – saugumas. Pocketbase turi labai lankstų taisyklių sistemą, kuri leidžia kontroliuoti, kas gali skaityti, kurti, atnaujinti ar trinti įrašus.

Kiekvienai kolekcijai galite nustatyti API Rules. Tai JavaScript’o tipo išraiškos, kurios įvertinamos kiekvienos užklausos metu. Pavyzdžiui, jei norite, kad vartotojai galėtų redaguoti tik savo įrašus:

@request.auth.id = author.id

Arba jei norite, kad tik admin’ai galėtų trinti įrašus:

@request.auth.role = "admin"

Galite naudoti sudėtingesnes sąlygas, tikrinti ryšius tarp lentelių, validuoti laukų reikšmes. Sistema labai galinga, bet reikia atsargiai – blogai sukonfigūruotos taisyklės gali sukelti saugumo spragų.

Rekomenduoju visada pradėti nuo griežčiausių taisyklių ir palaipsniui jas atpalaiduoti pagal poreikį. Geriau turėti per daug saugumo nei per mažai. Testuokite API su skirtingais vartotojų lygiais, bandykite prieiti prie duomenų, kurių neturėtumėte matyti.

Dar vienas svarbus aspektas – CORS konfigūracija. Jei jūsų frontend’as veikia kitame domene nei Pocketbase, reikės sukonfigūruoti CORS. Tai daroma per admin panelę Settings sekcijoje arba per aplinkos kintamuosius.

Diegimas produkcijai

Kai projektas paruoštas, reikia jį iškelti į produkciją. Yra keletas būdų tai padaryti, ir kiekvienas turi savo pliusų bei minusų.

Paprasčiausias būdas – tiesiog nukopijuoti Pocketbase failą į serverį ir paleisti su systemd ar panašiu process manager’iu. Sukuriate service failą, nustatote, kad automatiškai startuotų po serverio perkrovimo, ir viskas. Tai veikia puikiai mažiems projektams.

Pavyzdinis systemd service failas:


[Unit]
Description=Pocketbase
After=network.target

[Install]
WantedBy=multi-user.target


Jei norite profesionalesnio setup’o, galite naudoti Docker. Yra oficialių Docker image’ų, arba galite sukurti savo. Docker leidžia lengviau valdyti versijas, daryti backup’us, migruoti tarp serverių.

Svarbu nepamirsti apie backup’us. Pocketbase duomenys saugomi SQLite faile, paprastai pb_data/data.db. Šį failą reikia reguliariai kopijuoti. Galite naudoti paprastus cron job’us arba specializuotus backup sprendimus. SQLite palaiko online backup’us, tad nereikia sustabdyti serverio.

Dėl HTTPS – būtinai naudokite. Galite paleisti Pocketbase už reverse proxy (Nginx, Caddy, Traefik) su SSL sertifikatais. Caddy yra ypač patogus, nes automatiškai gauna Let’s Encrypt sertifikatus. Arba galite naudoti Cloudflare, kuris suteikia ne tik HTTPS, bet ir DDoS apsaugą, CDN.

Kada Pocketbase yra geriausias pasirinkimas

Pocketbase nėra universalus sprendimas visoms problemoms. Yra situacijų, kur jis puikiai tinka, ir situacijų, kur geriau rinktis ką nors kita.

Idealūs scenarijai Pocketbase:
– Prototipai ir MVP. Galite labai greitai sukurti veikiantį backend be jokios infrastruktūros galvos skausmo.
– Mažos ir vidutinės aplikacijos. Jei tikitės iki 100k vartotojų, Pocketbase tikrai susidoros.
– Indie projektai ir startup’ai. Nereikia mokėti už infrastruktūrą, kol neturite pajamų.
– Vidinės įmonės aplikacijos. Kai reikia greitai sukurti įrankį komandai.
– Mobilios aplikacijos su offline funkcionalumu. SQLite puikiai tinka sinchronizacijai.

Situacijos, kur verta pagalvoti apie alternatyvas:
– Labai didelis skaitymo/rašymo srautas. SQLite turi limitų, nors jie gana aukšti.
– Reikia sudėtingų analitinių užklausų. PostgreSQL ar specializuotos duomenų bazės būtų geresnės.
– Mikroservisų architektūra. Pocketbase yra monolitas, kas ne visada tinka.
– Reikia specifinių Firebase funkcijų, kaip Cloud Functions ar ML Kit.

Praktiškai, daugelis projektų pradeda su Firebase ar panašiais sprendimais, o vėliau migruoja į savarankiškus backend’us, kai sąskaitos pradeda gąsdinti. Pocketbase leidžia pradėti su savarankišku sprendimu nuo pat pradžių, bet su tokiu pat paprastumu kaip Firebase.

Bendruomenė ir ekosistema

Vienas iš svarbiausių dalykų renkantis technologiją – bendruomenė. Pocketbase, nors ir gana naujas projektas (pradėtas 2022-aisiais), jau turi aktyvią bendruomenę.

GitHub’e projektas turi daugiau nei 30k žvaigždučių, kas rodo didelį susidomėjimą. Yra oficialus Discord serveris, kur kūrėjai ir vartotojai dalijasi patirtimi, sprendžia problemas, siūlo funkcijas. Dokumentacija nuolat atnaujinama ir papildoma pavyzdžiais.

Ekosistema auga. Yra neoficialių SDK įvairioms kalboms – Python, Dart, Rust, PHP. Bendruomenė kuria įvairius papildinius, starter template’us, integracijas su populiariais frontend framework’ais. Pavyzdžiui, galite rasti ready-made sprendimus su Next.js, SvelteKit, Flutter.

Kas įdomu – pats projekto kūrėjas labai aktyvus. Atsakinėja į issues, priima pull request’us, klauso bendruomenės atsiliepimų. Tai nėra korporacinis projektas, kur sprendimai priimami už uždarų durų. Tai tikras open-source projektas su visa to prasme.

Jei planuojate rimtai naudoti Pocketbase, rekomenduoju prisijungti prie Discord ir sekti GitHub discussions. Ten sužinosite apie būsimus atnaujinimus, best practices, galite paklausti patarimų iš patyrusiųjų vartotojų.

Išplėtimai ir custom logika

Vienas iš galingiausių Pocketbase aspektų – galimybė jį išplėsti. Nors basic funkcionalumas dažnai pakanka, kartais reikia specifinės logikos.

Galite rašyti hooks – funkcijas, kurios vykdomos prieš ar po tam tikrų įvykių. Pavyzdžiui, prieš sukuriant naują vartotoją, galite patikrinti papildomus dalykus, siųsti email’ą, atnaujinti kitas lenteles. Hooks rašomi Go kalba, bet nereikia būti Go ekspertu – sintaksė paprasta.

Pavyzdinis hook, kuris siunčia welcome email po registracijos:


app.OnRecordAfterCreateRequest("users").Add(func(e *core.RecordCreateEvent) error {
// Siųsti email
message := &mailer.Message{
From: mail.Address{Address: app.Settings().Meta.SenderAddress},
To: []mail.Address{{Address: e.Record.Email()}},
Subject: "Welcome!",
HTML: "Welcome to our platform!",
}
return app.NewMailClient().Send(message)
})


Galite kurti custom API endpoints. Tai naudinga, kai reikia sudėtingesnės logikos, kurią sunku išreikšti per standartinį CRUD API. Pavyzdžiui, mokėjimų apdorojimas, išorinių API integracijos, sudėtingos ataskaitos.

Jei naudojate Pocketbase kaip framework’ą (importuojate jį kaip Go package), turite beveik neribotą kontrolę. Galite keisti bet kokią elgseną, pridėti middleware, integruoti kitas bibliotekas. Tai reiškia, kad Pocketbase gali augti kartu su jūsų projektu – pradėti kaip paprastas backend, vėliau virsti sudėtinga sistema.

Ką verta žinoti prieš pradedant

Pocketbase yra puikus įrankis, bet kaip ir bet kokia technologija, turi savo niuansų ir dalykų, kuriuos geriau žinoti iš anksto.

Pirma – versijų suderinamumas. Projektas dar aktyviai vystomas, ir kartais būna breaking changes. Prieš atnaujinant produkcinę versiją, būtinai perskaitykite changelog’ą ir išbandykite development aplinkoje. Dažniausiai migracija paprasta, bet geriau būti atsargiems.

Antra – backup strategija. SQLite failas yra jūsų viskas. Jei jį prarasite, prarasite viską. Automatizuokite backup’us nuo pirmos dienos. Galite naudoti paprastus script’us, cloud storage (S3, Backblaze), arba specializuotus įrankius kaip Litestream, kuris daro realaus laiko replikaciją.

Trečia – performance tuning. Nors SQLite gana greitas, su didėjančiu duomenų kiekiu gali prireikti optimizacijų. Indeksai labai svarbus – sukurkite juos dažnai naudojamiems laukams. Galite naudoti EXPLAIN QUERY PLAN, kad suprastumėte, kaip vykdomos užklausos.

Ketvirta – monitoring. Produkcinėje aplinkoje būtinai stebėkite serverio būseną, duomenų bazės dydį, atsakymo laikus. Galite naudoti įrankius kaip Prometheus, Grafana, arba paprastesnius sprendimus kaip Uptime Robot.

Penkta – saugumas. Niekada nelaikykite Pocketbase tiesiogiai prieinamo internete be reverse proxy. Naudokite rate limiting, HTTPS, stiprius slaptažodžius admin paskyroms. Reguliariai atnaujinkite į naujausią versiją, nes ten būna security fixes.

Šešta – testuokite API taisykles. Tai vieta, kur lengviausia padaryti klaidų. Sukurkite test vartotojus su skirtingais lygiais, bandykite prieiti prie duomenų, kurių neturėtumėte matyti. Geriau atrasti spragą development metu nei po launch’o.

Realūs projektai ir patirtys

Pocketbase jau naudojamas realiuose projektuose, nors ir nėra tokių garsių success stories kaip Firebase ar Supabase. Bet tai ir gerai – reiškia, kad įrankis veikia tyliai ir efektyviai.

Indie kūrėjai naudoja jį mobilioms aplikacijoms. Pavyzdžiui, task management apps, social media alternatives, fitness trackers. Privalumas – galima išleisti aplikaciją be jokių mėnesinių mokesčių už backend. Vienintelės išlaidos – serverio nuoma, kuri gali būti tik 5-10 USD per mėnesį.

Startup’ai naudoja prototipams ir MVP. Galima per savaitę sukurti veikiantį produktą ir pradėti testuoti rinką. Jei projektas nepasitvirtina, nepraradote daug laiko ir pinigų. Jei pasitvirtina, galite toliau naudoti Pocketbase arba migruoti į kažką galingesnio, kai tikrai reikia.

Įmonės naudoja vidinėms sistemoms. CRM, inventory management, employee portals. Čia Pocketbase privalumas – duomenys lieka jūsų serveriuose, nereikia baimintis GDPR ar kitų reguliacijų. Viskas po jūsų kontrole.

Yra ir kritikos. Kai kurie sako, kad SQLite nėra pakankamai patikimas produkcijai. Bet tai daugiau mitas nei realybė – SQLite naudojamas milijonuose kritinių sistemų. Kiti sako, kad Go kalba yra barjeras – ne visi kūrėjai ją moka. Bet jei naudojate tik REST API, Go žinios nereikalingos.

Bendras įspūdis iš bendruomenės – žmonės patenkinti. Projektas daro tai, ką žada, be jokių staigmenų. Dokumentacija aiški, performance geras, kaina (nulis) neįtikėtina. Tai ne hype train projektas, bet solidus įrankis realiems darbams.

Alternatyvos ir kaip pasirinkti

Pocketbase nėra vienintelis Firebase alternatyva. Verta žinoti, kas dar yra rinkoje, kad galėtumėte priimti informuotą sprendimą.

**Supabase** – turbūt populiariausia open-source Firebase alternatyva. Naudoja PostgreSQL, turi daugiau funkcijų nei Pocketbase, bet ir sudėtingesnis. Reikia daugiau resursų, daugiau konfigūravimo. Gerai tinka didesnėms aplikacijoms, kur reikia SQL galios.

**Appwrite** – kitas open-source backend-as-a-service. Panašus į Pocketbase, bet su daugiau funkcijų out of the box – cloud functions, storage, realtime. Bet ir sunkesnis – reikia Docker, daugiau serverio resursų.

**Parse** – senas žaidėjas, Facebook’o sukurtas ir vėliau atvirtas. Vis dar naudojamas, bet bendruomenė ne tokia aktyvi. Naudoja MongoDB, kas gali būti pliusas ar minusas priklausomai nuo jūsų poreikių.

**Directus** – headless CMS su backend funkcionalumu. Gerai tinka content-heavy projektams. Gražus admin panelė, bet gali būti overkill paprastoms aplikacijoms.

Kaip pasirinkti? Klauskite savęs:
– Kiek turiu laiko setup’ui? Jei mažai – Pocketbase.
– Kokio dydžio projektas? Jei mažas/vidutinis – Pocketbase. Jei didelis – Supabase ar custom solution.
– Ar reikia specifinių duomenų bazės funkcijų? Jei taip – Supabase (PostgreSQL). Jei ne – Pocketbase.
– Koks biudžetas? Jei ribotas – Pocketbase (pigiausia infrastruktūra).
– Ar komanda moka Go? Jei taip – Pocketbase (lengviau išplėsti). Jei ne – bet kuris kitas.

Mano asmeninė rekomendacija – pradėkite su Pocketbase, jei projektas nedidelis ir nereikia specifinių funkcijų. Galite labai greitai sukurti MVP ir išbandyti idėją. Jei projektas išaugs ir reikės daugiau galios, visada galėsite migruoti. Bet dažnai to nereikia – Pocketbase pakanka ilgam laikui.

Ateities perspektyvos ir bendros mintys

Pocketbase ateitis atrodo šviesiai. Projektas aktyviai vystomas, bendruomenė auga, vis daugiau įmonių ir kūrėjų jį pasirenka. Roadmap’e yra įdomių funkcijų – geresnis clustering support, daugiau database driver’ių, enhanced security features.

Kas svarbu – projekto filosofija lieka ta pati: paprastumas, lengvumas, developer experience. Tai nėra bandymas konkuruoti su AWS ar Google Cloud funkcijų kiekiu. Tai įrankis, kuris daro vieną dalyką gerai – suteikia paprastą, patikimą backend’ą be bereikalingo sudėtingumo.

Technologijų pasaulyje yra tendencija viskam komplikuoti. Microservices, Kubernetes, serverless, edge computing – visi šie dalykai turi savo vietą, bet ne kiekvienas projektas jų reikia. Kartais tiesiog reikia serverio, kuris veikia ir nedaro problemų. Pocketbase primena, kad paprastumas yra vertybė.

Jei esate indie kūrėjas, startup’as ar tiesiog žmogus su idėja, Pocketbase verta išbandyti. Atsisiųskite, paleiskite, sukurkite pirmą kolekciją. Per valandą turėsite veikiantį backend’ą. Jei patiks – tęskite. Jei ne – nieko nepraradote.

Svarbiausia – nebijokite eksperimentuoti. Technologijos egzistuoja tam, kad palengvintų mūsų darbą, o ne komplikuotų jį. Pocketbase yra vienas iš tų įrankių, kuris tikrai palengvina. Jis gali būti ne idealus kiekvienai situacijai, bet daugeliui projektų – daugiau nei pakankamas. O kartais „pakankamai gero” yra geriau nei „teoriškai tobulo”.