Instala una vez. Monitorea desde tu sitio.

Usa Raspberry Pi OS de 64 bits basado en Debian 12 o 13. ARM64 es para Raspberry y Linux ARM; no sirve en una computadora AMD64. Una reserva DHCP en el router evita cambios de dirección. Mantén alimentación y conexión estables.

Ubuntu 24.04 usa normalmente Python 3.12; Debian 12 usa 3.11 y Debian 13 usa 3.13. El servicio inicia con Linux, incluso sin sesión abierta. Los paquetes actuales no admiten Ubuntu 22.04/Python 3.10, Ubuntu 26.04/Python 3.14, ARM de 32 bits ni Alpine.

La base del agente es Python 3.11. Python 3.8–3.10 ya terminó su soporte upstream; no se instala una dependencia antigua para forzar compatibilidad. Python 3.14 está en evaluación y aún no tiene instalador publicado. Versiones preliminares y compilaciones sin GIL requieren aceptación independiente. No cambies el Python de tu sistema para forzar un paquete.

wsl --version
wsl --list --verbose
wsl --update
wsl -d Ubuntu-24.04

Si no existe Ubuntu-24.04, usa wsl --install -d Ubuntu-24.04. Sigue los avisos de Windows y después abre esa distribución. Si ya existe, no vuelvas a instalarla.

Dentro de Ubuntu, ps -p 1 -o comm= debe mostrar systemd. Si no, conserva las otras secciones de /etc/wsl.conf y añade [boot] con systemd=true. Tras cerrar los trabajos de esa distribución, ejecuta wsl --terminate Ubuntu-24.04 en PowerShell y ábrela de nuevo.

Copia la instalación AMD64/Python 3.12 del portal, o ARM64 si tu equipo realmente lo indica. No pegues comandos Linux en PowerShell.

sudo systemctl enable --now perzibo-box
sudo perzibo-box-acceso informacion

Abre en el navegador Windows la URL que indique ese comando. El puerto puede cambiar si está ocupado. No necesitas Tailscale ni un puente SSH para WSL local.

Usa la misma cuenta propietaria de Ubuntu. Descarga y verifica el complemento antes de ejecutarlo:

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
Invoke-WebRequest 'https://descargas.perzibo.com/herramientas/d13e56de2da173775089554105ca93bc33117902cba29d9e8e11817aacbfe977/ConfigurarWsl.ps1' -OutFile $configurador -ErrorAction Stop
if ((Get-FileHash -LiteralPath $configurador -Algorithm SHA256 -ErrorAction Stop).Hash -ne 'd13e56de2da173775089554105ca93bc33117902cba29d9e8e11817aacbfe977') { throw 'Descarga incorrecta. No ejecutar.' }
& $configurador -Accion Registrar -Distribucion Ubuntu-24.04 -Modo Sesion

Ubuntu permanece en segundo plano sin una consola abierta. El navegador abre el acceso al iniciar sesión Windows y pide tu contraseña de Perzibo. El monitor sigue activo aunque cierres sesión en Perzibo o cierres el navegador. Cerrar Ubuntu o el navegador y bloquear Windows permite continuar con esa sesión abierta. Si ya configuraste el arranque y aparece una terminal vacía, copia y ejecuta de nuevo el comando anterior para actualizar el complemento; tus datos se conservan.

Si Windows devuelve «Acceso denegado» al reemplazar una tarea anterior, abre PowerShell como administrador con la misma cuenta y repite el comando. Si una política impide ejecutar scripts, consulta al administrador. El complemento no desactiva protecciones ni requiere el repositorio del proyecto.

Al cerrar sesión Windows no se garantiza continuidad. Apagado, suspensión e hibernación detienen el monitoreo. Para un sitio permanente recomendamos Linux o Raspberry. Reinicia Windows manualmente e inicia sesión para aceptar esta prueba.

Piloto separado, sujeto a políticas de la empresa y prueba física. En PowerShell como administrador, con la misma cuenta propietaria de Ubuntu:

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Registrar -Distribucion Ubuntu-24.04 -Modo Arranque

Pide la contraseña real de Windows en un diálogo local, no el PIN ni la de Perzibo. No la pegues en consola ni la compartas con soporte. Si cambia esa contraseña debes registrar otra vez. No se garantiza compatibilidad con cuentas sólo Windows Hello ni políticas que impidan tareas por lotes. Nunca inicia durante suspensión o apagado.

Elige sólo la acción que necesitas. Cada botón copia un comando completo para PowerShell; requiere haber descargado el complemento del paso 3.

Ver la dirección del panel

Comprueba el servicio en Ubuntu y muestra su URL y puerto actuales. Puede iniciar Ubuntu; no abre el navegador ni cambia tus datos.

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Informacion -Distribucion Ubuntu-24.04

Abrir el panel

Comprueba el servicio y abre esa dirección en tu navegador Windows. No necesitas recordar el puerto.

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Abrir -Distribucion Ubuntu-24.04

Ver el estado del arranque

Consulta la tarea Windows sin iniciar Ubuntu ni abrir el panel. Una tarea activa no confirma que Perzibo esté funcionando; para eso usa «Ver la dirección del panel».

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Estado -Distribucion Ubuntu-24.04

Desactivar el arranque automático

Desactiva el inicio con Windows y la apertura automática del navegador. No desinstala Perzibo, borra datos ni detiene el servicio Linux que ya esté activo.

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Detener -Distribucion Ubuntu-24.04

Reactivar el arranque automático

Habilita de nuevo las tareas registradas e inicia el proceso que mantiene Ubuntu activo. El navegador se abrirá en el próximo inicio de sesión; para abrirlo ahora usa «Abrir el panel».

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Reanudar -Distribucion Ubuntu-24.04

Si quitaste las tareas, repite el paso 3. Si detuviste el servicio Linux manualmente, ejecuta sudo systemctl start perzibo-box en Ubuntu. Si una tarea anterior exige permisos, usa PowerShell como administrador con la misma cuenta.

La red virtual de WSL no es la red de tus copiadoras. Autoriza la subred LAN del cliente en Ajustes. NAT puede limitar broadcast y multicast; VPN, firewall y rutas pueden impedir lecturas. No analices todas las redes virtuales por defecto. Windows 10, WSL 1 y acceso automático desde otras computadoras no están certificados por este piloto.

Descarga el instalador verificado. Detecta arquitectura y Python del sistema, comprueba la firma y usa el paquete compatible. En WSL ejecuta esto dentro de Ubuntu.

cd ~ &&
curl --fail --show-error --proto '=https' --tlsv1.2 --connect-timeout 10 --max-time 60 -o InstalarPerzibo.sh 'https://descargas.perzibo.com/herramientas/b1a21d4f2db92d2d65a4771d4c6fee300f5139e5d1883ed840ee5206cee33fc8/InstalarPerzibo.sh' &&
printf '%s  %s\n' 'b1a21d4f2db92d2d65a4771d4c6fee300f5139e5d1883ed840ee5206cee33fc8' 'InstalarPerzibo.sh' | sha256sum -c - &&
sh ./InstalarPerzibo.sh --canal estable

El técnico configura HTTPS y las redes permitidas. Instala la autoridad local en las computadoras autorizadas y guarda la dirección del sitio. No expongas el panel a Internet. Tailscale no es necesario.

Desde 0.1.44 el servicio crea una copia SQLite cifrada al día y limpia las antiguas: siete copias, presupuesto de 1 GiB y 256 MiB libres de reserva. Conserva al menos dos recientes; si no cabe otra, registra el fallo sin borrar tus datos. No elimina historial ni lecturas pendientes. El diagnóstico muestra el último respaldo. Para desastre completo conserva también el respaldo cifrado de instalación: incluye el almacén que permite recuperar el acceso a estas copias.

El diagnóstico sirve para soporte, no para restaurar datos. Solicita una copia cifrada completa y guarda su frase. Tanto apt remove como apt purge conservan los datos de Perzibo; un reinicio limpio es una acción separada y explícita.

Desactivar detiene Perzibo ahora y evita que arranque con Linux. Conserva cuenta, equipos e historial. En WSL no elimina las tareas Windows; desactívalas también si no quieres que Ubuntu se abra en segundo plano.

sudo systemctl disable --now perzibo-box

Activar vuelve a iniciar el servicio y lo habilita para el siguiente arranque de Linux. Muestra la dirección del panel. En WSL registra o reactiva además el arranque Windows si lo necesitas.

sudo systemctl enable --now perzibo-box
sudo perzibo-box-acceso informacion

Primero, en WSL, quita el arranque Windows con el comando de la sección siguiente.

sudo apt remove perzibo-box

Al reinstalar el paquete compatible se recuperan cuenta, inventario e historial.

Esta acción retira los datos activos y genera un respaldo privado recuperable. En WSL primero ejecuta en PowerShell:

$configurador = Join-Path $env:USERPROFILE 'Downloads\ConfigurarWsl.ps1'
& $configurador -Accion Quitar -Distribucion Ubuntu-24.04

Quita las tareas Windows de Perzibo, pero aún no retira el programa ni sus datos Linux. Para volver a crearlas usa el paso 3. Si no descargaste el complemento o no configuraste el arranque, omite este comando.

Después, en la terminal Linux:

cd ~ &&
curl --fail --show-error --location --proto '=https' --tlsv1.2 -o RetirarPerzibo.sh 'https://descargas.perzibo.com/herramientas/e89c44788d528635214c93162b754e7b355713679097fbcad837cf1543de8878/RetirarPerzibo.sh' &&
printf '%s  %s\n' 'e89c44788d528635214c93162b754e7b355713679097fbcad837cf1543de8878' 'RetirarPerzibo.sh' | sha256sum -c - &&
sudo sh ./RetirarPerzibo.sh limpiar

Guarda la ruta del respaldo que muestra el comando. No elimina Ubuntu, WSL, las otras distribuciones ni programas ajenos. No uses wsl --unregister para desinstalar Perzibo. Los archivos descargados y respaldos se conservan para recuperación; los datos activos quedan retirados.

sudo systemctl status perzibo-box --no-pager
sudo journalctl -u perzibo-box -n 100 --no-pager
sudo perzibo-box-acceso informacion

Comparte la salida con soporte autorizado. Conserva la base y la evidencia del error.

sudo perzibo-box-acceso recuperar

Genera un código de un uso, válido diez minutos. Requiere acceso administrador al sistema operativo.