Blog

Backup agentless vía SFTP/SSH, zero deployment en el host remoto, soporte a network equipment (Cisco/Juniper/MikroTik/…), NAS (Synology/QNAP/TrueNAS), cloud SFTP (AWS Transfer, Hetzner Storage Box) y cloud VMs. Reemplaza mountpoints SSHFS/NFS/CIFS frágiles con conexiones SFTP per-job sin estado stale.

Documento técnico complementario a la página del plugin PodHeitor SFTP.

1. El problema: SSHFS/NFS/CIFS mountpoints son frágiles

El patrón tradicional de «backup remoto sin agente Bacula» es montar el filesystem remoto vía SSHFS/NFS/CIFS en el host del FD. Suena simple pero falla en campo de varias formas:

2. Modelo arquitectónico

┌──────────────┐     PTCOMM protocol      ┌──────────────────────────┐
│  Bacula FD   │◄═══════════════════════►  │ podheitor-sftp-backend   │
│              │     (stdin/stdout)         │ (Rust + libssh2)         │
│ loads .so:   │                           │                          │
│ podheitor-   │   Handshake → Job Info    │ connect() → walk() →    │
│ sftp-fd.so   │   → Params → Start →     │ FNAME/STAT/DATA →       │
│ (Rust cdylib,│   ← file data ←          │ filtros include/exclude  │
│ metaplugin-  │                           │                          │
│ rs)          │                           │                          │
└──────────────┘                           └──────────────────────────┘

Misma arquitectura PodHeitor de cdylib + backend. El backend hospeda el cliente SFTP (libssh2 vía Rust ssh2), hace walk recursivo del path remoto, y streama metadata + data vía PTCOMM. Sin disco intermedio; el FD recibe los bytes directo.

3. Features

• Agentless — solo SFTP/SSH, sin software en el host remoto
• Full / Incremental / Differential — niveles Bacula nativos vía comparación de mtime
• Filtros include/exclude — glob-based (*.pdf, *.tmp) por archivo y directorio
• Metadata preservada — permisos, UID/GID, timestamps, symlinks
• Autenticación — SSH key (ed25519, RSA, ECDSA), agent forwarding, password
• Host key verification — protección MITM vía known_hosts
• File listing — estimate (pre-backup), catalog queries, restore tree browsing
• Multiple sources — N servidores SFTP en un solo FileSet
• Compression & Encryption — LZ4/GZIP nativo Bacula + AES

4. Casos de uso documentados

4.1 Network equipment

4.2 NAS y Storage

4.3 Cloud SFTP services

4.4 Cloud VMs y hosting

AWS EC2, GCP Compute, Azure VMs, DigitalOcean, Linode, Vultr, Hetzner Cloud, OVH; cPanel/WHM, Plesk, DirectAdmin — cualquier hosting con SFTP/SSH.

4.5 Embedded e IoT

Raspberry Pi, IoT gateways — backup ligero sin overhead de mount. Devices con storage limitado — sin layer FUSE/mount necesario.

5. Parámetros del plugin

6. Quick start

# 1. Prepara llave para acceso SFTP
sudo mkdir -p /etc/bacula/.ssh
sudo ssh-keygen -t ed25519 -f /etc/bacula/.ssh/id_ed25519 -N ""
sudo ssh-copy-id -i /etc/bacula/.ssh/id_ed25519.pub [email protected]

# 2. Configura FileSet
FileSet {
  Name = "SFTP-Backup"
  Include {
    Options { Signature = SHA256; Compression = LZ4 }
    Plugin = "podheitor-sftp: host=server.local user=backup keyfile=/etc/bacula/.ssh/id_ed25519 path=/data"
  }
}

Job {
  Name     = "SFTP-Daily"
  Type     = Backup
  Level    = Incremental
  FileSet  = "SFTP-Backup"
  Client   = myserver-fd
  Storage  = File1
  Pool     = Default
  Schedule = "WeeklyCycle"
}

7. Ejemplos include/exclude y multi-source

# Solo PDFs y Office docs
Plugin = "podheitor-sftp: host=server user=backup path=/data include=*.pdf,*.docx,*.xlsx"

# Skip temp y cache
Plugin = "podheitor-sftp: host=server user=backup path=/data exclude=*.tmp,*.cache,*.log"

# Network switch — solo configs
Plugin = "podheitor-sftp: host=10.0.0.1 user=admin path=/ include=*.conf,*.cfg verify_host=no"

# MikroTik — backup y export files
Plugin = "podheitor-sftp: host=10.0.0.3 user=admin path=/ include=*.backup,*.rsc verify_host=no"

Multi-source en un solo FileSet:

FileSet {
  Name = "AllServers"
  Include {
    Options { Signature = SHA256; Compression = LZ4 }
    Plugin = "podheitor-sftp: host=web1.prod user=deploy keyfile=/etc/bacula/.ssh/key path=/var/www exclude=*.log"
    Plugin = "podheitor-sftp: host=web2.prod user=deploy keyfile=/etc/bacula/.ssh/key path=/var/www exclude=*.log"
    Plugin = "podheitor-sftp: host=nas.local user=admin keyfile=/etc/bacula/.ssh/key path=/volume1/shared"
    Plugin = "podheitor-sftp: host=switch-core user=admin keyfile=/etc/bacula/.ssh/key path=/ include=*.conf verify_host=no"
  }
}

8. Restore

Restore opera en el namespace @sftp/host:port/path:

bconsole
* restore where=/tmp/sftp-restore select all done yes

9. Requirements

10. Postura de licencia

Propietaria — LicenseRef-PodHeitor-Proprietary (tanto el .so FD-side como el backend). Ningún código statically-linked third-party es AGPL u otro copyleft. Las dependencias Rust transitivas (ssh2, libssh2-sys, libc, parking_lot, openssl-sys) son todas MIT / Apache-2.0.

¿Listo para evaluar?

Trial gratuito de 30 días para deployments SFTP calificados (network equipment, NAS, cloud, embedded). Garantizamos al menos 50% de descuento vs Bacula Enterprise, Veeam o Commvault, con más funcionalidades — incluyendo agentless puro sin el mountpoint frágil que el competidor fuerza.

Heitor Faria — Fundador, PodHeitor International
✉ [email protected]
☎ +1 (789) 726-1749 · +55 (61) 98268-4220 (WhatsApp)
🔗 Página del plugin PodHeitor SFTP

Disponível em: Português (Portugués, Brasil)English (Inglés)Español