Vom privaten Homelab-Journal auf diese Seite: Export mit Secret-Barriere

Was wir gebaut haben: Die Inhalte hier entstehen aus echter Homelab-Arbeit — und die dokumentieren wir jetzt strukturiert in einem privaten Journal: pro Änderung ein Eintrag mit Ausgangslage, Schritten, Problemen, Messwerten und Erkenntnissen, dazu Systembeschreibungen und eine Messwert-Ablage. Von dort führt eine Export-Pipeline zu LabKompass: Nur Einträge, die explizit freigegeben sind, landen in einem Public-Export; ein Import macht daraus Content-Kandidaten, die ein Mensch redaktionell prüft. Veröffentlicht wird nie automatisch.

Warum es interessant ist: Drei Lektionen aus dem Aufbau, die über unser Setup hinaus gelten:

1. Ein Repo mit git add -A-Workflow braucht zwingend eine gepflegte .gitignore. In unserem System-Repo lagen Arbeitsdateien mit Tokens, Cookies und einem Firewall-Konfig-Backup im Root — ein unbedachtes git add -A, und sie wären in der Historie gelandet.
2. Whitelist schlägt Blacklist. Der Export übernimmt nur explizit erlaubte Felder, statt bekannte Geheimnisse zu schwärzen. Was nicht auf der Liste steht, kommt gar nicht erst raus.
3. Sicherheitsprüfungen gehören auf beide Seiten der Schnittstelle. Exporter und Importer scannen unabhängig voneinander auf Secret-Muster — und blockieren im Verdachtsfall komplett, statt still zu bereinigen. Dabei zeigte sich: Auch Platzhalter wie ein ausgeschriebener Authorization-Header mit <TOKEN> lösen den Scanner aus. Das ist gewollt — lieber einmal zu oft umformulieren als einmal zu wenig blocken.

Für wen: Alle, die ihr Homelab dokumentieren und Teile davon veröffentlichen wollen — sei es im Blog, im Wiki oder im Team. Die Trennung „private Quelle → geprüfter Export → redaktionelle Veröffentlichung“ kostet wenig und verhindert die klassischen Unfälle: geleakte Zugangsdaten, private Netzdetails im öffentlichen Repo, ungewollt veröffentlichte Rohdaten.