Table of contents
Agents
Version: 2.0.0 Gültigkeit: Linux-x64-Agent und Manager-Anbindung Letzter Stand: 4. Juli 2026
Der Bastelhof-Agent liefert authentifizierte, ausschließlich lesende Statusinformationen lokaler Linux-Systeme.
Inhalt
Der Release enthält den selbstenthaltenden Agent unter agent/linux-x64/. Er stellt ausschließlich GET /api/v1/status bereit und meldet Hostname, Plattform, Agentversion, Laufzeit sowie Arbeitsspeicher- und Datenträgerwerte.
Vor dem Start müssen ein Token mit mindestens 32 Zeichen, ein HTTPS-Endpunkt und ein Kestrel-Zertifikat über die Betriebsumgebung konfiguriert werden:
export BASTELHOF_AGENT_TOKEN='langer-zufaelliger-token'
export BASTELHOF_AGENT_URLS='https://0.0.0.0:7443'
export ASPNETCORE_Kestrel__Certificates__Default__Path='/etc/bastelhof-agent/agent.pfx'
chmod +x ./Bastelhof.HomelabManager.Agent
./Bastelhof.HomelabManager.Agent
In der Windows-App werden Name, absolute HTTPS-Adresse und Token unter Plugins & Automatisierung → Agents registriert. Der Token liegt ausschließlich im Windows Credential Manager. Aktivierte Agents werden minütlich und auf Anforderung geprüft; Status und letzter Kontakt werden in SQLite aktualisiert.
Hinweise
Das Zertifikat muss auf dem Manager vertrauenswürdig sein. Firewallzugriff auf die Manager-IP begrenzen. Der Agent enthält keine Remote-Shell, keine Befehlsausführung und keine schreibende API. Token und Zertifikat nicht in Repository, Wiki, Logs oder Unit-Dateien eintragen.