cpKamra
Mentés cPanel szerverekhez
A cpKamra saját infrastruktúrán futó mentőrendszer cPanel szerverekhez. Ha egy szerver törölni is tudja a saját mentéseit, egy feltöréskor a mentései is elveszhetnek. Ezért a cPanel szerverek a cpKamrában csak hozzáírni tudnak: minden fiók saját restic-repositoryt kap, régi mentést pedig csak a tároló oldalán futó karbantartó node törölhet.
A másik cél, hogy egy elveszett fájl visszahozása ne a rendszergazdán múljon. A felhasználók a cPanelben maguk állítanak vissza fájlt, mappát, postafiókot, adatbázist vagy DNS-zónát, a rendszergazda pedig a WHM-ben teljes fiókot, akár egy másik szerver mentéséből.
A rendszer hosting szolgáltatóknak és több cPanel szervert üzemeltetőknek készült, de egy-két szerverhez is van egyszerűbb, controller nélküli mód. A cpKamrát mi fejlesztjük, ingyenesen használható. A programok technikai neve cpbackup (cpbackupd, cpbackupctl).
Felépítés
cPanel szerverek (cpbackupd + cPanel és WHM plugin)
│ mTLS: feladatkiosztás, állapot, kulcsletét
├──────────────────────────────▶ controller + MariaDB ◀── dashboard (adminok)
│ ▲ mTLS
│ restic, csak hozzáírás │
▼ │
tárolószerver (rest-server) ◀──── karbantartó node: megőrzés, prune, ellenőrzés
- Agent (
cpbackupd): minden cPanel szerveren fut, éjszakánként menti a fiókokat. Vele települ a cPanel és a WHM plugin, a parancssori kezelője acpbackupctl. - Controller: külön gépen fut, MariaDB-vel. Tárolónként korlátozza a párhuzamos feladatokat, hogy a sok szerver ne terhelje túl a mentési célt, gyűjti a mentések állapotát, letétben őrzi a repository-kulcsokat, és ezen fut a dashboard. Ha nem érhető el, az agentek tíz perc után a helyi sorukból dolgoznak tovább.
- Tárolószerver: restic rest-server
--append-only --private-reposkapcsolókkal, így minden cPanel szerver csak a saját repositoryjait látja, és azokba is csak írni tud. S3-kompatibilis tároló is használható, törlési jog nélküli kulccsal. - Karbantartó node (
cpbackup-maint): a tároló mellett fut, egyedül ennek van törlési joga. Ez végzi a megőrzés szerinti takarítást, a prune-t, a rendszeresrestic checkellenőrzést és a megszűnt fiókok mentéseinek törlését, és igény szerint minden repositoryt átmásol egy második célra is.
Egyszerveres mód. Egy-két szerverhez, amely bármilyen SFTP- vagy S3-kompatibilis tárolóra, akár egy NAS-ra ment, nem kell controller és karbantartó node: a karbantartást maga az agent végzi. Ennek ára, hogy az agentnek törlési jog kell, ezért a mentéseket a tároló oldalán kell védeni (például pillanatképekkel vagy S3 verziókezeléssel). Később adatmozgatás nélkül át lehet térni a teljes rendszerre.
Mit ment el
Egy fiók mentése több restic-pillanatképből áll:
- Fájlok: a teljes home könyvtár, benne a weboldalak és a levelezés (a postafiókok jelszavaival).
- Fiók-metaadatok: a cPanel saját
pkgacctexportja (beállítások, adatbázis-jogosultságok és -sémák, levelezési, SSL-, cron- és FTP-beállítások) és a domainek DNS-zónái. - Adatbázisok: minden MySQL/MariaDB adatbázis külön pillanatképbe kerül, konzisztens dumpként, ideiglenes fájl nélkül.
A szerver saját konfigurációja (/etc, /var/cpanel, /var/named, crontabok) külön repositoryba kerül, ami egy elveszett szerver újraépítésénél segít.
A kizárások mintákkal adhatók meg; a WHM-ben betölthető egy ajánlott lista (gyorsítótárak, naplók, ideiglenes fájlok). Egy teljes home könyvtárat kizáró mintát a rendszer elutasít.
Linux 5.9 vagy EL9 kernelen egy fanotify-alapú változáskövető figyeli a home könyvtárakat, CageFS alatt is. A változatlan fiók kihagyja a fájlmentést, de az adatbázisai és a metaadatai ekkor is mentődnek; hetente teljes átnézés fut. Ütemezhetők sűrűbb adatbázis-mentések is. Az alapértelmezett megőrzés 7 napi és 4 heti pillanatkép, szerverenként és fiókonként módosítható.
Visszaállítás
A cPanel pluginban (Fájlok → Backup & Restore) a felhasználó:
- fájlt vagy mappát állíthat vissza összefésüléssel, felülírással vagy külön mappába, illetve letöltheti archívumként;
- postafiókot állíthat vissza, a törölt postafiókot a régi jelszavával együtt;
- adatbázist cserélhet a mentett változatra (előtte biztonsági másolat készül, hiba esetén visszaáll az eredeti), visszaállíthat új adatbázisba, vagy letöltheti az SQL-dumpot;
- DNS-zónát vethet össze az élővel és állíthat vissza;
- egyenként visszaállíthat fiókbeállításokat: cron feladatokat, e-mail továbbítókat, SSL-tanúsítványokat, aldomaineket, kiegészítő és alias domaineket;
- a Mentés most gombbal maga indíthat mentést, például egy CMS-frissítés előtt (alapból naponta egyet).
A felhasználó csak a saját fiókja mentéseit látja, a fájlok az ő jogosultságával íródnak vissza.
A WHM pluginban a root és a viszonteladók (utóbbiak a saját fiókjaikra) ugyanezt elérik, és látják a sort meg a naplókat. A root a szerverről már törölt fiókot egészében visszaállíthatja. Másik szerverről is áthozható egy fiók: a karbantartó node átmásolja a repositoryt a célszerver területére, a szerverek egymás mentéseit közben sem látják.
Biztonság
- mTLS: a cPanel szerverek és a karbantartó node a controller saját tanúsítványkiadójától kapott kliens-tanúsítvánnyal kapcsolódnak. A tanúsítványok maguktól megújulnak, visszavonás után azonnal érvénytelenek.
- Egyszer használatos regisztrációs token: egy szerverhez kötött, alapból 24 óráig érvényes, és tartalmazza a controller tanúsítványkiadójának ujjlenyomatát, így egy közbeékelődő gép nem tud a controller nevében válaszolni.
- Kulcsletét: az agent a repository-jelszavakat a controller nyilvános kulcsával titkosítva helyezi letétbe, így a mentések a cPanel szerver elvesztése után is megnyithatók. Kinyitni csak a controller gépén lehet, és minden kinyitás az auditnaplóba kerül.
- Csak hozzáírható tárolás: a cPanel szerver nem tud mentést törölni vagy felülírni. A karbantartó node leállítja az automatikus törlést, ha egy szerverről egyszerre sok fiók tűnik el.
- Szokatlan mentések: ha egy mentésben a fájlok szokatlanul nagy része változott (zsarolóvírus gyanúja), riasztás megy, és kérhető, hogy a fiók mentéseiből addig semmi ne törlődjön.
- Dashboard: admin és csak olvasó szerepkör, kétlépcsős azonosítás, belépési korlát; minden művelet auditnaplóba kerül.
Üzemeltetés
A magyar és angol nyelvű dashboard egy helyen mutatja a szervereket, a fiókok utolsó mentését, a sort, a tárolókat, a megszűnt fiókok mentéseit, a megőrzési szabályokat és az auditnaplót.
Riasztás megy webhookra (Slack- és Mattermost-kompatibilis) vagy e-mailben, ha egy szerver nem jelentkezik, egy mentés hibás, 36 órája nincs jó mentés, vagy egy repository-ellenőrzés hibát talál. Problémánként egy értesítés jön, és egy, amikor megoldódott.
A controller jelzi, ha a szerverek vagy a karbantartó node-ok más kiadást futtatnak, de nem tilt le semmit. Frissítéskor a controller, a karbantartó node-ok, végül a cPanel szerverek jönnek; utóbbiakon ugyanaz az install.sh frissít, amely telepít, és nem nyúl a beállításokhoz, a kulcsokhoz.
A controller (MariaDB-vel) és a karbantartó node Docker image-ként vagy virtuális gépre telepíthető, az agent tar.gz csomagból.
Követelmények
- cPanel & WHM Jupiter témával, AlmaLinux, CloudLinux vagy RHEL 8/9 rendszeren, x86_64 vagy aarch64 processzoron, root hozzáféréssel.
- restic 0.19.1 vagy újabb (a telepítő gondoskodik róla).
- A controllerhez és a tárolószerverhez Linux Docker Engine-nel és Compose-zal, vagy virtuális gép.
- A változáskövetőhöz Linux 5.9 vagy EL9 kernel; nélküle minden éjjel teljes átnézés fut.
- Egyszerveres módban bármilyen SFTP- vagy S3-kompatibilis tároló, akár egy NAS.