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 #
- macOS 26 oder neuer; Build für Apple Silicon (
arm64) oder Intel (x64). Beide sind mit Developer ID signiert und notarisiert. - Ausgehendes HTTPS zu
console.caryvane.com. - Ein Administrator für die Installation und zum Erteilen des Festplattenvollzugriffs (oder ein MDM-Profil, das ihn erteilt).
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:
- Von Hand: Systemeinstellungen → Datenschutz & Sicherheit → Festplattenvollzugriff →
/Applications/Caryvane.apphinzufügen, dann den Daemon neu starten (sudo launchctl kickstart -k system/com.caryvane.agent). - Per MDM: Verteilen Sie ein PPPC-Profil (Privacy Preferences Policy Control), das
SystemPolicyAllFilesfür die Bundle-ID und die Code-Anforderung der App gewährt. Das Installationsprogramm liefertmake-pppc-profile.shmit, das ein solches Profil mit der exakten Anforderungszeichenfolge erzeugt.
Was wo landet #
| Element | Ort |
|---|---|
| Anwendung (Daemon, Menüleiste, FSKit-Modul) | /Applications/Caryvane.app |
| Daemon | system/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).