Deep Dive: Redis – object cache, file locking en waarom een wachtwoord achter de firewall

Wat Redis doet voor WordPress en Nextcloud, waarom de ene instantie zonder wachtwoord draait en de andere met, wat de metingen zeggen over hitrates en geheugen – en drie dingen die een review vond die de setup nog niet deed.

Illustratie bij de serie Deep Dive

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Deep Dive in de serie rond de Ansible-tour. De tour legt de rollen uit, de deep dives de techniek eronder: hoe het werkt, waarom het hier zo wordt gebruikt en wat er onderweg misging.

Redis is de kleinste service in deze setup – een paar megabyte geheugen, een fractie van een CPU-core – en beide applicaties zijn ervan afhankelijk. De blog gebruikt het als object cache (deel 3), Nextcloud voor file locking en als gedeelde cache tussen processen (deel 4). Deze post legt uit wat Redis daar doet, waarom de twee instanties verschillend beveiligd zijn, wat de cijfers zeggen en wat een review voor dit artikel opleverde.

Inhoud

🧭 Hoe Redis werkt

Eén thread, alles in het geheugen

Redis houdt alle data in het RAM en voert commando’s na elkaar uit in één enkele event loop. Dat klinkt als een bottleneck en is het tegendeel: er zijn geen locks tussen threads, elk commando is atomair en een simpele read duurt microseconden. Netwerk en systeemaanroepen kosten meer dan het commando zelf.

Keys, types, verloop

Elke entry is een key met een waarde – een string, een hash, een list, een set. Elke key kan een time to live hebben; Redis verwijdert hem als die verloopt. Beide applicaties zetten op bijna elke key een verlooptijd, dus de dataset ruimt zichzelf op.

Als het geheugen opraakt

maxmemory zet een limiet; maxmemory-policy bepaalt wat er bij de limiet gebeurt. allkeys-lru gooit de minst recent gebruikte key eruit – goed voor een pure cache, waarin elke entry opnieuw opgebouwd kan worden. noeviction weigert in plaats daarvan nieuwe writes – goed voor data die niet stilletjes mag verdwijnen, zoals een lock.

Persistentie – of geen

Redis kan snapshots schrijven (RDB, gestuurd door save) en een append-only log van alle writes (AOF). Beide zijn voor data die een herstart moet overleven. Een cache en kortlevende locks hebben geen van beide nodig: na een herstart vult de cache zich opnieuw en nemen de applicaties nieuwe locks.

Authenticatie en protected mode

requirepass (of, sinds Redis 6, ACL-gebruikers) laat elke client zich eerst authenticeren. Protected mode weigert alleen verbindingen van buiten als Redis zonder wachtwoord op alle interfaces luistert – zodra een bind-adres en geen wachtwoord zijn geconfigureerd, helpt het niet meer.

🛡️ Waarom het hier is

  • WordPress object cache. WordPress vraagt de database bij elke request naar dezelfde opties, menu’s en post-metadata. Met de plugin Redis Object Cache komen de antwoorden in plaats daarvan uit Redis.
  • Nextcloud file locking. Als twee clients tegelijk hetzelfde bestand schrijven, heeft Nextcloud een lock nodig die elk PHP-proces, in elke pod, meteen ziet. Zonder dat overschrijven sync-clients elkaar. Nextcloud raadt Redis hier expliciet voor aan.
  • Nextcloud distributed cache. Data die tussen processen gedeeld wordt – app-configuratie, sessiegerelateerde toestand – staat daar ook; de cache per proces is APCu.

🔧 Wat deze repository doet

BlogNextcloud-servers
WaarPod in K3s (redis:7.4-alpine)Op de host, AlmaLinux-pakket (Redis 7.2, module stream redis:7; 6.2 tot 26 okt 2026)
Rolblog_k3s_deploynext_packages + next_redis
Gebruikt voorObject cacheFile locking + distributed cache
Geheugenlimiet80 MB, allkeys-lrugeen, noeviction
Persistentiegeen (--save "", AOF uit)RDB-snapshots (pakketstandaard)
Wachtwoordgeenrequirepass uit de vault
Bereikt viaClusterIP Service, NetworkPolicy: alleen WordPress-podsNode-IP en 127.0.0.1, nftables: alleen het podnetwerk
SELinuxcontainer_t met eigen MCS-categorieënredis_t

De blog: een wegwerpcache in een afgesloten pod

Alles in deze Redis mag weggegooid worden, en zo is hij ook geconfigureerd: geen schrijfacties naar schijf, een geheugenplafond met LRU-eviction, een read-only root-bestandssysteem, geen capabilities. Hij heeft geen wachtwoord, omdat niets buiten het podnetwerk hem kan bereiken en daarbinnen alleen de WordPress-pods dat mogen – een NetworkPolicy weigert elke andere pod, inclusief de database en de ingress controller.

Nextcloud: waarom het wachtwoord

Op de Nextcloud-servers draait Redis op de host, en de pods bereiken hem via een Kubernetes Service die naar het node-IP wijst. Dat betekent dat Redis op het publieke adres van de server luistert. Tussen het internet en Redis zat in het begin precies één nftables-regel. De rol next_redis voegt requirepass toe als tweede laag, omdat een regel die stilletjes faalt hier niet hypothetisch is: fail2ban lag op de blog ooit twee dagen dood zonder dat iemand het merkte. Het wachtwoord bereikt Nextcloud via een Kubernetes Secret, gemount als redis.config.php – niet via de ConfigMap met de rest van de configuratie, want ConfigMaps zijn niet bedoeld voor geheimen.

De flush_handlers is geen versiering: de rollen erna draaien occ-commando’s in de pod, die via het node-IP met Redis verbinden. Zonder de directe herstart zou Redis op dat moment nog alleen op 127.0.0.1 luisteren.

De les: een service die pods via het node-IP bereiken, luistert op een adres dat meer dan alleen de pods kunnen bereiken. Die heeft een wachtwoord nodig, ook achter een firewall.

noeviction met opzet

De host-Redis heeft geen geheugenlimiet en de standaardpolicy noeviction. Voor locks klopt dat: een verwijderde lock zou een lock zijn die stilletjes is opgehouden een bestand te beschermen. De dataset is sowieso piepklein (zie hieronder), en de server heeft geheugen genoeg.

De les: voor locks is eviction een bug; voor een cache is het de juiste keuze. De policy volgt uit wat er opgeslagen wordt.

Sinds 26 oktober 2026 komt de host-Redis uit de AppStream module stream redis:7 (7.2) in plaats van de EL9-standaard 6.2. Red Hat zou 6.2 van securityfixes zijn blijven voorzien; de overstap zet de Nextcloud-servers op dezelfde major-versie als de blog. Omdat Redis hier niets naar schijf schrijft, kostte de herstart alleen een moment cache en locks. SELinux-domein (redis_t) en configuratie bleven hetzelfde.

📊 Gemeten

BlogNextcloud ANextcloud B
Versie7.4.116.2.24 → 7.2.166.2.24 → 7.2.16
Gebruikt geheugen14,8 MB1,7 MB1,3 MB
Keys19.0795683
Hitrate sinds herstart87,6 %85,9 %64,4 %
Verwijderde keys000
Slow-log-entries130

De twee workloads lijken totaal niet op elkaar. De blogcache bevat tienduizenden kleine objecten; Nextcloud bevat een paar dozijn locks en cache-entries die voortdurend aangemaakt worden en verlopen – op de grotere server verliepen binnen een dag meer dan 11.000 keys. De lagere hitrate op de kleinere Nextcloud-server is de aard van locking, geen probleem: “is dit bestand gelockt?” is een miss zodra het antwoord “nee” is. De fragmentatieratio die Redis voor de host-instanties meldt (7 tot 9) ziet er alarmerend uit en betekent op deze schaal niets – een paar megabyte procesoverhead gedeeld door een of twee megabyte data.

De blog gebruikt Predis, een client geschreven in PHP, omdat het officiële WordPress-image de extensie phpredis niet meelevert. De C-extensie zou sneller zijn; met een hitrate van 88 % en page cache ervoor is het verschil in de responstijden niet te zien.

🔍 Wat de review voor dit artikel vond

Bij het verzamelen van de feiten voor deze post kwamen vier dingen boven die de setup niet deed – geen ervan gevaarlijk, allemaal goed om te weten. Alle vier zijn op 20 oktober 2026 opgelost.

  • Geen systemd-sandbox voor de host-Redis. MariaDB op dezelfde servers kreeg een hardening-drop-in (geen capabilities, read-only bestandssysteem, system-call-filter); Redis draait alleen met de unit van het pakket. SELinux sluit hem nog steeds op in redis_t, dus onbeschermd is hij niet – maar de tweede laag die MariaDB heeft, ontbreekt. De opzet van juist dit artikel beweerde dat die bestond. Opgelost: hetzelfde soort drop-in als voor MariaDB – met één valkuil onderweg: de sandbox-opties impliceren NoNewPrivileges, en daaronder weigerde SELinux de overgang naar redis_t; Redis startte twee minuten niet. Een kleine lokale module (init_nnp_daemon_domain(redis_t)) staat precies die overgang toe.
  • Snapshots die niemand nodig heeft. De host-Redis houdt de pakketstandaard save 3600 1 300 100 60 10000 aan en schrijft regelmatig dump.rdb – voor locks met een time to live en een cache die zichzelf opnieuw opbouwt. Teruggezet na een reboot zouden oude locks zelfs eerst moeten verlopen. Opgelost: save "", zoals op de blog, en de oude dump.rdb verwijderd.
  • Een gewijzigd wachtwoord zou Nextcloud niet bereikt hebben. De verbindingsinstellingen komen uit een Secret, gemount met subPath – en een subPath-mount wordt in een draaiende pod nooit bijgewerkt. De pod wordt opnieuw uitgerold als zijn configuratie verandert, via een checksum-annotatie, maar het Secret hoorde niet bij die checksum. Het wachtwoord wijzigen zou Redis met het nieuwe hebben herstart, terwijl Nextcloud het oude hield tot zijn volgende toevallige herstart: geen locks, foutpagina’s. Opgelost: het Secret hoort nu bij de checksum. Het laatste handmatige stuk – de push-daemon notify_push leest het wachtwoord uit config.php, waar de installer het ooit neerzette – is ook geautomatiseerd: het playbook kopieert het wachtwoord uit het Secret naar config.php zodra ze verschillen.
  • Monit houdt hem niet in de gaten. Monit herstart en meldt K3s, sshd en de monitoringservices, maar niet de host-Redis of MariaDB van de Nextcloud-servers. Als Redis zou stoppen, zou Nextcloud als eerste falen en Grafana het als tweede merken. Opgelost: beide staan nu in de lijst van Monit.

De les: “het werkt” en “het is ingericht zoals de rest” zijn twee verschillende uitspraken. De tweede controleer je door de kleine service naast de grote te zetten: sandbox, monitoring, wachtwoordrotatie.

🧰 Dagelijks beheer

  • MONITOR print elk commando live – handig voor een paar seconden, duur en vol data op een drukke instantie.
  • Leegmaken. Op de blog maakt wp cache flush de object cache veilig leeg. Op Nextcloud gooit een FLUSHALL ook alle locks weg; doe dat alleen met de instantie in onderhoudsmodus.
  • Het wachtwoord roteren. Pas het aan in de vault, draai het playbook: next_redis schrijft het in redis.conf en herstart Redis, next_k3s_deploy werkt het Secret bij en rolt – sinds de fix hierboven – de Nextcloud-pod in dezelfde run opnieuw uit. notify_push krijgt het in dezelfde run.
  • Updates. Het hostpakket krijgt securityfixes via dnf-automatic, dat Redis daarna herstart; het blog-image volgt de pin in versions.yml.

🆘 Spiekbriefje: symptoom → commando

De korte versie van dit artikel voor het moment dat er iets mis is. Draai op de host als root; <…> zijn placeholders. occ en wp zijn de shellfuncties uit de deep dives over Nextcloud en WordPress.

SymptoomCommando
Draait hij, en is hij opgesloten?systemctl status redis
ps -eZ | grep redis # redis_t
Met hem praten zonder het wachtwoord op de commandoregelexport REDISCLI_AUTH="$(awk '/^requirepass/{print $2}' /etc/redis/redis.conf)"
redis-cli PING
Doet de cache zijn werk?redis-cli INFO stats | grep -E 'keyspace_(hits|misses)|evicted'
Geheugen vol?redis-cli INFO memory | grep -E "used_memory_human|maxmemory_human"
Trage commando’s, hoge latencyredis-cli SLOWLOG GET 5
redis-cli --latency # Ctrl-C to stop
Geen pushmeldingen in Nextcloudk3s kubectl -n nextcloud logs deploy/notify-push --tail=20
occ notify_push:self-test
De blogcachek3s kubectl -n wordpress exec deploy/redis -- redis-cli INFO keyspace
wp redis status
wp cache flush # empties it, safe

🎯 De lessen

  • Cache of lock: dat bepaalt eviction en persistentie.
  • Wat op een bereikbaar adres luistert, heeft een wachtwoord nodig.
  • Een gewijzigd wachtwoord moet in dezelfde run elke client bereiken.
  • Kleine services krijgen dezelfde hardening en monitoring als grote.
  • De versie van de distributie is een standaard, geen beslissing – die kan en moet gecontroleerd worden.

⚖️ Alternatieven – en waarom Redis

OptieSterk puntWaarom niet hier
MemcachedSimpele, snelle cacheGeen locking-semantiek die Nextcloud kan gebruiken; zou de locking in de database laten.
Alleen APCuIn het proces, geen netwerkNiet gedeeld tussen PHP-processen of pods – nutteloos voor locking. Nextcloud gebruikt het daarnaast als lokale cache.
Database-lockingGeen extra serviceDe fallback van Nextcloud; legt extra last op de drukste component en is trager.
Valkey / KeyDBForks met andere governance of threadingValkey is de waarschijnlijke volgende stap; KeyDB is minder actief.
RedisWat beide applicaties verwachten en waartegen ze testen, piepkleine footprintGekozen.

Redis is het soort component dat je makkelijk vergeet, omdat het nooit klaagt. De review voor dit artikel was een herinnering dat “het werkt” en “het is ingericht zoals de rest” twee verschillende uitspraken zijn – en dat het de moeite waard is om de tweede ook bij de kleine services te controleren.

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details