PermLens 1.2.0 – Änderungen am Host

Wichtig beim Update: Die neuen Funktionen brauchen auf dem Proxmox das Wächter-Script Version 9 und eine eigene Freigabe. Nach dem Update in PermLens Einstellungen → Neu einrichten und den Befehl einmal auf jedem Proxmox ausführen. Ohne Freigabe ändert sich nichts: PermLens ändert am Host erst, wenn du die Datei /etc/permlens/host-aendern-erlaubt anlegst (Container-Nummern, dazu Zeilen mit / für Ordner, die neu eingehängt werden dürfen), z. B. mkdir -p /etc/permlens && printf '9001-9006\n/srv/daten\n' > /etc/permlens/host-aendern-erlaubt. schreiben-erlaubt gibt dafür nichts frei.

• Mount-Punkte: Container → Host-Einstellungen: „Mount-Punkt hinzufügen …“ und „Entfernen …“ je Ordner vom Host, mit Vorschau, nur bei gestopptem Container. Eingehängt werden nur Ordner, die schon in einem Container hängen oder unter einem freigegebenen Ordner liegen.
• Mapping ausführen: Mapping-Assistent → Bestehender Container → „Ausführen …“ trägt fehlende Zeilen in /etc/subuid//etc/subgid ein und tauscht die lxc.idmap-Zeilen aus. Dateien im Container nachziehen bleibt von Hand (Befehl in der Vorschau, Häkchen zum Bestätigen).
• Sicherung und Rückgängig: Vor jeder Änderung sichert der Wächter /etc/pve/lxc/<Nr>.conf selbst. Unter „Änderungen“ spielt „Rückgängig“ die Sicherung zurück, solange die Datei seitdem niemand geändert hat.
• PermLens startet, stoppt und legt keine Container an. Alle Befehle von Wächter 9: SICHERHEIT.md, Abschnitt 3a.

In English: With guard script version 9 and the separate switch file /etc/permlens/host-aendern-erlaubt, PermLens can add and remove mount points and replace the mapping of existing, stopped containers, with preview, backup and undo. Updating files after a new mapping stays manual. After updating: Settings → Set up again on every Proxmox host.

Update: Dockhand → Pull → Redeploy, danach Neu einrichten (Wächter 9) / then set up again (guard 9).

PermLens 1.1.2 – gespeicherte Baupläne

• Baupläne speichern: Im Mapping-Assistenten (Neuer Container) einen Bauplan unter einem Namen speichern, später laden, umbenennen und löschen. Gespeichert wird je Proxmox in der Datenbank von PermLens, ohne Container-Nummer; beim Laden rechnet PermLens mit dem aktuellen Stand neu.
• Bauplan aus einer Docker-App: Im Reiter Docker öffnet „Bauplan für neuen Container …“ den Mapping-Assistenten mit den Ordnern des Hosts und den Nummern der App.

In English: Save blueprints in the mapping assistant under a name, load, rename and delete them (per Proxmox). The Docker tab opens the mapping assistant prefilled from a running app.

Update: Dockhand → Pull → Redeploy. Kein Neu einrichten nötig / no new setup needed.

PermLens 1.1.1 – Docker-Reiter mit langen Pfaden

• Behoben: Im Reiter Docker schob ein anonymes Docker-Volume (Pfad mit 64 Zeichen langer Kennung, z. B. bei hawser) die Tabelle über den Rand der Karte hinaus. Die Kennung wird jetzt gekürzt angezeigt (b5db0401…e55b), der volle Pfad steht im Tooltip, lange Pfade brechen um.

In English: Fixed: in the Docker tab, an anonymous Docker volume (path with a 64-character ID, e.g. with hawser) pushed the table beyond the card. The ID is now shortened, the full path is in the tooltip, long paths wrap.

Update: Dockhand → Pull → Redeploy. Kein Neu einrichten nötig / no new setup needed.

PermLens 1.1.0 – Docker-Einblick und Nachschauen

Wichtig beim Update: Die neuen Funktionen brauchen auf dem Proxmox das Wächter-Script Version 8. Nach dem Update in PermLens Einstellungen → Neu einrichten und den Befehl einmal auf jedem Proxmox ausführen. Ohne das läuft alles wie bisher, nur ohne Docker-Reiter und ohne Konsole für Container. Alles, was dazukommt, liest nur.

Docker-Apps

• Neuer Reiter „Docker“ auf der Container-Seite, wenn im LXC Docker läuft: je App, als welche Nummer sie wirklich schreibt, wer das im Container und auf dem Proxmox ist, und je eingehängtem Ordner Besitzer, Lesen und Schreiben.
• Schreibt als misst PermLens an den laufenden Programmen der App. Viele Images starten als root und wechseln dann zu PUID; gezählt wird, als wer die eigentlichen Programme laufen. Läuft die App nicht, gelten PUID/USERMAP_UID aus der Stack-Datei oder der Benutzer aus dem Image.
• Neue Probleme: „App kann nicht in … schreiben“, „App schreibt als root“ (unprivilegierte Container), „App läuft nicht als PUID“.
• Prüfen kennt Docker-Apps als Benutzer, mit der passenden Empfehlung (PUID/PGID bzw. user: passend zum Ordner).
• Der Wächter gibt aus docker inspect nur ausgewählte Felder heraus. Andere Umgebungsvariablen (oft Passwörter und Tokens) und Befehlszeilen verlassen den Proxmox nie.

Nachschauen

• Konsole für den schnellen Blick auf Host, Container oder Docker-App (Zahnrad → Nachschauen, auf der Container-Seite „Nachschauen →“). Sie sieht aus wie ein Terminal, kennt aber nur feste, lesende Befehle wie id, ls -ld, stat, getfacl, df -h, docker ps. Keine Shell, keine Dateiinhalte. ls -l (Inhalt eines Ordners) nur in Containern, in denen Ändern freigegeben ist.
• Ins Protokoll kommt nur, wann welcher Befehl lief, nie die Ausgabe.

Außerdem

• Neue Anleitung Installation (seit 1.0.1), Anleitungen um Docker und Konsole ergänzt, SICHERHEIT.md mit allen Befehlen von Wächter 8.
• README verlinkt die Projektseite lurohome.de/permlens.

In English: Docker apps: a new Docker tab shows, for every app in an LXC, which number it really writes as, who that is on the host and whether it may write to its folders; new problems and Check for apps. Quick look-up: a console with fixed, read-only commands for the host, a container or a Docker app. Requires guard script version 8: after updating, Settings → Set up again and run the command once on each Proxmox host. The guard never hands out other environment variables or command lines.

Update: Dockhand → Pull → Redeploy, danach Einstellungen → Neu einrichten / then Settings → Set up again.

PermLens 1.0.1 – Installationsanleitung

Nur Dokumentation, am Programm ändert sich nichts.

• Neue Installationsanleitung docs/INSTALLATION.md, auch auf Englisch (docs/INSTALLATION.en.md): was du brauchst, sechs Schritte vom leeren Proxmox bis zur Übersicht, alle Einstellungen der Stack-Datei und Hilfe bei Problemen mit den Meldungen, die PermLens und der Einrichtungs-Befehl zeigen können.
• README: Link „Installation“ ganz oben, der Abschnitt „Schnellstart“ heißt jetzt „Installation“.
• BETRIEB.md enthält nur noch, was nach der Installation kommt: neue Version, Neu einrichten, Sichern, Entfernen.

In English: documentation only, no changes to the program. New step-by-step installation guide with prerequisites, all stack file settings and troubleshooting.

Update: Dockhand → Pull → Redeploy (nicht nötig, wenn 1.0.0 läuft / not required if 1.0.0 is running).

PermLens 1.0.0 – Erste öffentliche Version

PermLens ist ein Rechte-Manager für LXC-Container, derzeit speziell für Proxmox VE. Er zeigt, welche Benutzer es in deinen Containern gibt, wer sie auf dem Proxmox-Host sind und wer auf welche eingehängten Ordner und NAS-Freigaben zugreifen darf. Er erklärt Rechte-Probleme in Klartext und setzt die Lösung auf Wunsch selbst um, immer mit Vorschau und Rückgängig.

Was PermLens kann

• Ist alles in Ordnung? Nach jedem Einlesen prüft PermLens von selbst bekannte Fehlerquellen: Ordner, die ein Container als nobody sieht, fehlende Mount-Quellen, gemeinsame Ordner ohne setgid, gleiche Namen mit verschiedenen Nummern, NFS mit no_root_squash und mehr. Jeder Befund mit Erklärung und Befehl.
• Kann X hier schreiben? Container, Benutzer und Ordner wählen. PermLens rechnet wie Linux selbst (Besitzer, Gruppe, ACL, Mapping, jeder Ordner auf dem Weg) und kann gegenprüfen: das System im Container fragen oder ein echter Schreibtest.
• Benutzer und Gruppen ändern: anlegen, Mitgliedschaften, Nummern, Besitzer, Rechte und ACLs im Container, auch für ganze Ordnerbäume mit Sicherung. Jede Änderung mit Vorschau, Einstufung, Protokoll und Rückgängig. Nur in Containern, die du auf dem Proxmox freigibst, nie root, nie Systemkonten, nie Passwörter.
• Container unprivilegiert machen: Der Mapping-Assistent rechnet lxc.idmap, /etc/subuid und /etc/subgid aus, für neue Container, für bestehende, die Ordner als nobody sehen, und für den Umstieg von privilegiert. Alle Befehle zum Kopieren, mit Weg zurück.
• Außerdem: mehrere Proxmox in einer Oberfläche, Benutzer in Klartext erklärt, die Einstellungen jedes Containers aus der conf-Datei, Zwei-Faktor-Anmeldung, HTTPS mit eigenem Zertifikat, Hinweis auf neue Versionen, Deutsch und Englisch, hell und dunkel.

Sicherheit

PermLens spricht mit dem Proxmox nur per SSH mit eigenem Schlüssel. Der Schlüssel ist auf dem Host fest an ein Wächter-Script mit Erlaubnisliste gebunden, es gibt keine Shell und kein API-Token. Geschrieben wird nur, wenn du es auf dem Host ausdrücklich für einzelne Container freigibst. Das Image läuft ohne root, mit festen, geprüften Paketversionen, SBOM und Herkunftsnachweis. Alles Weitere: docs/SICHERHEIT.md.

In English

PermLens is a permission manager for LXC containers, currently built for Proxmox VE. It shows which users exist in your containers, who they are on the host and who may access which mounted folders and NAS shares. It finds common permission problems on its own, answers “can X write here?” step by step, changes users, groups and permissions inside allowed containers with preview and undo, and helps you make containers unprivileged. Access to Proxmox is SSH only, bound to a guard script with a fixed allow list. See the README and the user manual.

Einrichten / Setup: README · Update: Dockhand → Pull → Redeploy.