CaryvaneHilfe
/
DE

Der Agent unter macOS

Der macOS-Agent läuft als LaunchDaemon in Caryvane.app, mit einem Menüleistensymbol und einer FSKit-Erweiterung für das Cloud-Laufwerk. Er braucht macOS 26 – das Laufwerk basiert auf FSKit, das diese Version voraussetzt – und Festplattenvollzugriff, den root allein nicht gewährt.

Voraussetzungen #

Installieren und registrieren #

# Install (interactive: double-click the .pkg; unattended:)
sudo installer -pkg CaryvaneAgent-arm64.pkg -target /

# Enrol unattended: the daemon reads setup.json on start
sudo mkdir -p "/Library/Application Support/Caryvane"
echo '{"DeploymentToken":"<token>"}' | sudo tee "/Library/Application Support/Caryvane/setup.json" >/dev/null
sudo launchctl kickstart -k system/com.caryvane.agent

# Check
sudo launchctl print system/com.caryvane.agent | head -20

Interaktiv installieren Sie per Doppelklick auf das .pkg. Liegt setup.json schon vor dem Ausführen des Pakets bereit, registriert sich der Agent beim ersten Start; legen Sie die Datei danach ab, starten Sie den Daemon mit kickstart neu. Ohne Token installiert sich das Paket und gibt aus, wohin eines gehört; auch das Menüleistensymbol bietet die Registrierung an.

Festplattenvollzugriff – erforderlich #

macOS lässt selbst root weder Mail, Nachrichten, Safari-Daten, Time-Machine-Backups noch das Benutzerverzeichnis eines anderen Benutzers lesen, solange der Anwendung kein Festplattenvollzugriff erteilt ist. Ohne ihn sieht der Agent nur seine eigenen Dateien, und jedes Backup meldet seine Quellen als leer. Erteilen Sie ihn einmal:

Was wo landet #

ElementOrt
Anwendung (Daemon, Menüleiste, FSKit-Modul)/Applications/Caryvane.app
Daemonsystem/com.caryvane.agent (/Library/LaunchDaemons/com.caryvane.agent.plist)
Token, Datenbank, Manifeste, Cache/Library/Application Support/Caryvane/ (700 root:wheel)
Protokolle/Library/Application Support/Caryvane/logs/; den Zustand des Daemons zeigt außerdem launchctl print

Was bewusst nicht gesichert wird #

Ein Datei-Job auf einem Mac überspringt, was auch Time Machine überspringt, denn niemand möchte eine Kopie von macOS im eigenen Bucket: Platzhalter synchronisierter Cloud-Dienste (~/Library/CloudStorage, nicht heruntergeladene iCloud-Drive-Dateien), Caches und abgeleitete Daten unter ~/Library (Biome, IntelligencePlatform, Spotlight-Indizes), das Systemvolume und die AppleDouble-Begleitdateien ._*, die der Finder auf Nicht-Apple-Dateisystemen anlegt. Was bleibt, sind die Daten des Benutzers.

Das Cloud-Laufwerk #

Es wird von einer FSKit-Dateisystemerweiterung in der App eingebunden, die in der Sitzung des Benutzers läuft; es erscheint also nach der Anmeldung. macOS 26 ist die Untergrenze, weil frühere Versionen keinen FSKit-Ressourcentyp für ein netzwerkgestütztes Volume haben. Prüfen Sie, ob die Erweiterung unter Systemeinstellungen → Allgemein → Anmeldeobjekte & Erweiterungen → Dateisystemerweiterungen aktiviert ist.

Selbstaktualisierung und Upgrades #

Der Agent lädt das neue .pkg herunter, prüft die Notarisierung und übergibt es launchd als einmaligen Job, damit das Beenden des alten Daemons nicht das Installationsprogramm mitbeendet. Das Installationsprogramm hängt alle Cloud-Volumes aus, stoppt den Daemon und wartet auf ihn, ersetzt die App und startet sie wieder. Ein manuelles installer -pkg wird genauso behandelt. Deinstallieren Sie mit dem mitgelieferten uninstall.sh, das App, Daemon und Daten entfernt (die Protokolle bleiben).