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 a cpbackupctl.
  • 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-repos kapcsoló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 rendszeres restic check ellenő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 pkgacct exportja (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.