CaryvaneAyuda
/
ES

El agente en macOS

El agente de macOS se ejecuta como LaunchDaemon dentro de Caryvane.app, con un icono en la barra de menús y una extensión FSKit para la unidad en la nube. Necesita macOS 26 (la unidad se basa en FSKit, que lo requiere) y acceso total al disco, que root por sí solo no concede.

Requisitos #

Instalar y registrar #

# 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

Para una instalación interactiva, haga doble clic en el .pkg. Si coloca setup.json antes de ejecutar el paquete, el agente se registra en el primer arranque; si lo coloca después, reinicie el daemon con kickstart. Sin token, el paquete se instala e indica dónde ponerlo; el icono de la barra de menús también ofrece el registro.

Acceso total al disco: obligatorio #

macOS no deja que ni siquiera root lea Mail, Mensajes, los datos de Safari, las copias de Time Machine ni la carpeta personal de otro usuario si no se ha concedido acceso total al disco a la aplicación. Sin él, el agente solo ve sus propios archivos y todas las copias de seguridad informan de que sus orígenes están vacíos. Concédalo una vez:

Dónde queda cada cosa #

ElementoUbicación
Aplicación (daemon, barra de menús, módulo FSKit)/Applications/Caryvane.app
Daemonsystem/com.caryvane.agent (/Library/LaunchDaemons/com.caryvane.agent.plist)
Token, base de datos, manifiestos, caché/Library/Application Support/Caryvane/ (700 root:wheel)
Archivos de registro (logs)/Library/Application Support/Caryvane/logs/; además, launchctl print muestra el estado del daemon

Lo que se excluye a propósito #

Una tarea de archivos en un Mac omite lo mismo que omite Time Machine, porque nadie quiere una copia de macOS en su bucket: los marcadores de posición de servicios en la nube sincronizados (~/Library/CloudStorage, archivos de iCloud Drive no descargados), las cachés y datos derivados de ~/Library (Biome, IntelligencePlatform, índices de Spotlight), el volumen del sistema y los archivos auxiliares AppleDouble ._* que el Finder escribe en sistemas de archivos que no son de Apple. Lo que queda son los datos del usuario.

La unidad en la nube #

La monta una extensión de sistema de archivos FSKit incluida en la aplicación, que se ejecuta en la sesión del usuario, por lo que aparece después de iniciar sesión. macOS 26 es el mínimo porque las versiones anteriores no tienen un tipo de recurso FSKit para un volumen respaldado por la red. Compruebe que está activada en Ajustes del Sistema → General → Ítems de inicio y extensiones → Extensiones del sistema de archivos.

Actualización automática y actualizaciones #

El agente descarga el nuevo .pkg, verifica su notarización y se lo pasa a launchd como trabajo puntual, para que detener el daemon antiguo no mate al instalador. El instalador desmonta los volúmenes en la nube, detiene el daemon y espera a que termine, sustituye la aplicación y la vuelve a iniciar. Un installer -pkg manual recibe el mismo trato. Para desinstalar, use el uninstall.sh incluido, que elimina la aplicación, el daemon y los datos (los archivos de registro se conservan).