Live Web & Security 2025

RTFM: Technische Wissensdatenbank

Ein WordPress-Blog für Fehlerbilder aus Betrieb und Sicherheit, mit eigenem Theme im Design von disisto.de, Artikeln in Markdown, Login über Keycloak und einem Frontend, das nur Inhalte vom eigenen Server lädt.

Seit

2025

Umfang

Theme, Plugins, Login und Betrieb

Startseite hell
0
Anfragen an Dritte im Frontend
0
Inline-Skripte und -Styles im Frontend
2
Designs: hell und dunkel
1
Login für Redaktion: Keycloak

Technologien

WordPress PHP MariaDB Redis nginx Docker Keycloak (OIDC) Content Security Policy Markdown Matomo (serverseitig)

Die Herausforderung

Lösungen für Fehler aus dem Betrieb landen sonst in Notizen, Tickets oder Chatverläufen und sind beim nächsten Mal nicht auffindbar. Eine öffentliche Wissensdatenbank muss dabei so gehärtet sein wie die Systeme, über die sie schreibt, und darf Leser nicht an Dritte weiterreichen.

Die Lösung

WordPress als Redaktionssystem, aber mit eigenem Theme, eigenen Plugins und einer Auslieferung, die nur den eigenen Server kennt. Artikel entstehen in Markdown, die Anmeldung läuft über den zentralen Keycloak, und nginx setzt für jeden Bereich eine eigene Content Security Policy.

Aufbau

Eigenes Theme

Farben, Verläufe und Komponenten folgen disisto.de. Hell und dunkel lassen sich umschalten, die Startseite zeigt Themen, beliebte Artikel und eine Suche. Wechselnde Sprüche im Kopfbereich pflegt ein eigenes Plugin nach Kategorien.

Schreiben in Markdown

Artikel entstehen in Markdown statt im Block-Editor, mit Tabellen, Codeblöcken und Inline-Code. Fehlerbilder lassen sich so mit Logzeilen, Befehlen und Zeitstempeln genau nachstellen.

Gehärtete Auslieferung

nginx vor PHP-FPM, WordPress-Objekte im Redis-Cache. Das Frontend erlaubt Skripte und Styles nur vom eigenen Server, Uploads werden ohne ausführbare Inhalte ausgeliefert, und PHP verrät weder Version noch Standard-Session-Namen.

Login über Keycloak

Redakteure melden sich über OpenID Connect am zentralen Keycloak an, mit dem selbst entwickelten Plugin Simple OIDC SSO. Benutzerkonten werden bei der Anmeldung abgeglichen, ein eigenes WordPress-Passwort ist für den Alltag nicht nötig.

Themen

Sicherheit, Linux und Systemadministration, Netzwerk, Docker und Container, Monitoring und Observability, Audio sowie KI- und Entwicklungswerkzeuge. Jeder Artikel geht von einem konkreten Fehlerbild aus und endet mit einer nachvollziehbaren Lösung.

Betrieb

rtfm läuft in eigenen Docker-Containern für WordPress, Datenbank, Cache und nginx und ist nur über den vorgelagerten Reverse Proxy erreichbar. Images werden mit den Paketständen des Bautags gebaut, Änderungen an Theme und Konfiguration liegen versioniert in Git.

Datenschutz

Die Seiten laden nichts von Dritten. Statistik misst selbst gehostetes Matomo serverseitig und erst nach Einwilligung; wer nur das Nötige zulässt, wird nicht gezählt.

Ergebnisse

Eine Wissensdatenbank, die selbst nach den Regeln arbeitet, über die sie schreibt: gehärtet, ohne Abhängigkeit von fremden Diensten und mit einem Login, der an die übrige Infrastruktur angebunden ist.

Galerie

Screenshots von rtfm.disisto.de.