Construiți un cluster Nextcloud rezilient cu Galera

Construiți mai întâi clusterul bazei de date, apoi plasați mai multe noduri identice ale aplicației Nextcloud în spatele unui echilibrator de încărcare verificat. Pentru o configurație stabilă, toate nodurile aplicației trebuie să utilizeze aceeași stocare durabilă de fișiere, configurație, serviciu de blocare Redis sau Valkey și un endpoint al bazei de date care direcționează scrierile doar către un membru Galera sănătos. Manualul de administrare actual al Nextcloud listează MariaDB ca bază de date acceptată, dar nu publică o rețetă de implementare specifică Galera; verificați versiunile exacte de Nextcloud, MariaDB, Galera și proxy cu furnizorii înainte de producție.

Începând cu 9 octombrie 2026, pagina cu cerințe de sistem pentru Nextcloud 35 listează MariaDB 10.11, 11.4, 11.8 și 12.3, versiunea 12.3 fiind marcată ca recomandată. Aceasta este o listă de versiuni ale bazei de date Nextcloud, nu o promisiune că fiecare combinație de Galera sau proxy este certificată. Începeți cu cerințele de sistem pentru Nextcloud 35 și matricea de suport Galera a distribuției dvs. MariaDB.

1. Definiți limitele de defecțiune

Un cluster cu disponibilitate ridicată are mai mult decât o bază de date replicată. Galera protejează nivelul bazei de date; nu replică fișierele utilizator Nextcloud, sesiunile PHP, blocările Redis sau codul aplicației. O singură bază de date partajată nu poate compensa nici o montare eșuată a spațiului de stocare sau un echilibrator de încărcare care continuă să trimită trafic către un nod de aplicație defect.

Planificați aceste componente înainte de instalare:

• Cel puțin două servere de aplicații care rulează aceeași versiune Nextcloud, aceeași versiune PHP, aceleași aplicații activate și aceeași configurație web.
• Un echilibrator de încărcare sau un proxy invers cu un nume de gazdă public stabil, HTTPS și verificări de stare pentru serverele de aplicații.
• Stocare de date Nextcloud partajată și durabilă, vizibilă pe aceeași cale și cu permisiunile corecte pe fiecare server de aplicație. Directorul de date Nextcloud trebuie setat în timpul instalării; instrucțiunile de instalare avertizează că mutarea sa ulterioară este dificilă.
• Un cluster Galera cu un număr impar de noduri ale bazei de date cu vot, de obicei trei, plasate astfel încât o eroare a gazdei să nu elimine majoritatea.
• Un serviciu Redis sau Valkey partajat pentru cache distribuit și blocarea fișierelor tranzacționale.

Alegeți modele de stocare și rețea care au propria redundanță și recuperare testată. O cale partajată nu este automat disponibilă doar pentru că o pot monta mai multe servere web.

2. Instalați și validați mai întâi MariaDB Galera

Alegeți o versiune MariaDB care îndeplinește cerințele actuale ale Nextcloud și un pachet Galera corespunzător, acceptat de furnizorul MariaDB. Urmați documentația de implementare MariaDB Galera pentru configurarea nodurilor, porturile de rețea, transferul instantaneelor ​​de stare, TLS și bootstrapul inițial. Nu porniți fiecare nod gol ca un cluster nou; bootați un nod, apoi uniți celelalte la acel cluster.

Nextcloud necesită InnoDB și READ-COMMITTEDnivelul de izolare a tranzacțiilor pentru MySQL sau MariaDB. Pagina curentă a bazei de date Nextcloud recomandă, de asemenea, înregistrarea binară pe rânduri. Confirmați valorile pe fiecare nod al bazei de date, nu doar pe nodul care primește trafic în prezent. Consultați cerințele de configurare MariaDB ale Nextcloud .

Înainte de a conecta Nextcloud, verificați starea clusterului pe fiecare nod. De exemplu, rulați SHOW GLOBAL STATUS LIKE 'wsrep_cluster_status';și SHOW GLOBAL STATUS LIKE 'wsrep_local_state_comment';. Clusterul ar trebui să raporteze o Primarycomponentă, dimensiunea așteptată a clusterului și nodurile din Syncedstarea respectivă. MariaDB explică faptul că cvorumul necesită mai mult de jumătate din ultima apartenență cunoscută a clusterului; prin urmare, un cluster cu trei noduri poate tolera pierderea unui nod, nu a două. Consultați instrucțiunile privind cvorumul și recuperarea .

3. Oferiți Nextcloud un endpoint al bazei de date care să fie compatibil cu starea de funcționare

Configurați Nextcloud să se conecteze la o adresă proxy stabilă pentru baza de date, nu la o listă round-robin de adrese IP Galera. Deși Galera replică scrierile în cluster, aplicațiile au nevoie în continuare de o gestionare previzibilă a tranzacțiilor. Un proxy care monitorizează apartenența la Galera poate opri rutarea către noduri care nu sunt disponibile sau nu sunt sincronizate și poate selecta un nod de scriere. Monitorul Galera din MariaDB MaxScale este o opțiune documentată; comportamentul său exact și modurile de rutare acceptate depind de versiunea și configurația MaxScale.

Folosește punctul final de conexiune documentat al proxy-ului ca fiind al Nextcloud dbhost. Creează conturi separate, cu privilegii minime, pentru monitorizare și accesul aplicațiilor, protejează acreditările și criptează traficul bazei de date atunci când acesta traversează o rețea neîncrezătoare. Evită activarea divizării citire/scriere ca o scurtătură presupusă pentru performanță: Funcția de replicare proprie a Nextcloud trimite citiri către replici, păstrând în același timp scrierile și citirile cauzale pe conexiunea implicită, dar Galera nu este un aranjament de replici asincrone obișnuit. Folosește un design de rutare testat special pentru stiva ta.

4. Faceți ca fiecare nod al aplicației să vadă aceeași instanță Nextcloud

Instalați același cod Nextcloud și același set de aplicații pe fiecare server de aplicații. Mențineți config.phpconsecvența fiecărui nod pentru instanța partajată, inclusiv endpoint-ul bazei de date, valorile secrete, domeniile de încredere și calea directorului de date. Nu rulați o actualizare independent pe mai multe noduri. Faceți mai întâi o copie de rezervă, plasați instanța în modul de întreținere, actualizați printr-o singură cale controlată și readuceți traficul numai după ce toate nodurile rulează aceeași versiune.

Configurați toate nodurile aplicației să utilizeze același serviciu Redis sau Valkey pentru memoria cache distribuită și blocare. O memorie cache locală, cum ar fi APCu, poate rămâne locală la nivel de nod, dar memcache.distributedși memcache.lockingtrebuie să indice către un serviciu comun, nu către cel al fiecărui server localhost. De exemplu, configurația Redis a Nextcloud poate utiliza 'memcache.locking' => '\OC\Memcache\Redis'și o gazdă Redis partajată în redisconfigurație. Urmați ghidul actual de configurare a memoriei cache și ghidul de blocare a fișierelor tranzacționale . Memcached nu este potrivit pentru blocările fișierelor tranzacționale Nextcloud.

Dacă centralizați și sesiunile PHP în Redis, tratați acest lucru ca pe o sarcină separată de configurare PHP. Manualul Nextcloud avertizează că blocarea sesiunii nu este activată în mod implicit pentru gestionarea sesiunii Redis; aplicați setările de blocare și testați comportamentul sesiunii înainte de a vă baza pe ea. Nu confundați replicarea bazei de date sau blocarea fișierelor cu continuitatea sesiunii.

5. Testați failover-ul înainte de a-l considera disponibilitate ridicată

Mai întâi confirmați utilizarea normală prin intermediul numelui public de gazdă: conectați-vă, încărcați și descărcați un fișier de test și verificați dacă este vizibil după ce o solicitare ajunge la un alt nod al aplicației. Apoi goliți un nod web și confirmați că solicitările continuă prin celălalt. Restaurați-l și confirmați că se reunește fără a servi un cod sau o versiune de configurare învechită.

Apoi, utilizați o fereastră de mentenanță pentru a simula o eroare a unui nod al bazei de date, conform runbook-ului furnizorului. Confirmați că proxy-ul elimină membrul eșuat sau nesincronizat, că Nextcloud poate încă citi și scrie și că nodul care returnează ajunge Syncedînainte de a accepta trafic. Monitorizați starea principală a Galera, dimensiunea clusterului, sincronizarea nodurilor, starea proxy-ului, erorile aplicației și starea de montare a spațiului de stocare.

O pierdere a cvorumului este o oprire de siguranță, nu o dovadă că datele au dispărut. Nu forțați bootarea mai multor noduri și nu alegeți unul la întâmplare. Ghidul de recuperare MariaDB recomandă identificarea celui mai avansat nod și bootarea doar a acelui nod, apoi reconectarea celorlalte. Confirmați că ați testat și copiile de rezervă ale bazei de date și ale spațiului de stocare a fișierelor; replicarea Galera oglindește modificările bazei de date și nu înlocuiește copiile de rezervă la un moment dat.

Verificați rezultatul

Configurarea este gata de producție numai atunci când un nod de aplicație și un nod de bază de date pot fi eliminate fără a întrerupe operațiunile normale ale fișierelor, toate nodurile Galera supraviețuitoare rămân într-o componentă primară, iar depozitul de fișiere partajat și serviciul Redis sau Valkey rămân accesibile. Dacă un test eșuează, identificați ce nivel a oprit servirea solicitării înainte de a modifica timeout-urile sau setările de reîncercare. Manualul Nextcloud documentează setările de bază de date și aplicație acceptate, în timp ce matricea de compatibilitate a furnizorilor și testele de failover determină dacă această implementare Galera specifică este acceptată.