fileHeron
Plataforma auto-alojada de intercambio de archivos bidireccional con enlaces temporales, hasta 30 GB, licencias MIT. Incluye frontend Vue/Next.js, backend FastAPI/Python, antivirus ClamAV y soporte S3.
Ficha actualizada 25 sept 2026, 0:46 · upstream 25 sept 2026, 0:38 · release client-v1.4.6
Qué es fileHeron
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
file:Heron es una plataforma auto-alojada para compartir archivos bidireccional entre empresas y clientes. Permite transferencias resumibles de hasta 30 GB con control de acceso basado en grupos, enlaces públicos con token+contraseña+límite de descargas, y gestión de sesiones.
La arquitectura combina FastAPI (Python) para el backend, Vue 3 para el frontend, MariaDB 11 para persistencia, Redis 7-alpine para caché/colas ARQ, y tusd (Go) para uploads resumibles vía TUS. Incluye panel de administración completo con auditoría, análisis, webhooks y gestión de usuarios/grupos.
El despliegue se realiza mediante Docker Compose con soporte para Traefik como reverse proxy TLS. Ofrece actualizaciones automáticas con rollback, modo mantenimiento y backups configurables. Compatible con ClamAV para escaneo antivirus en cada subida.
- Compartir archivos outbound de empresa a clientes externos con enlaces temporales
- Recibir archivos inbound de clientes a buzón corporativo o empleados específicos
- Auditoría completa de historial de archivos y sesiones de usuario
- Gestión de usuarios con roles admin/employee/cliente en misma UI
- Integración SSO OIDC multi-proveedor para autenticación centralizada
- Escaneo antivirus ClamAV asíncrono con cuarentena automática
- Transfers resumibles hasta 30 GB vía TUS con multipart directo <100 MB
- Antivirus ClamAV en cada subida con cuarentena reversible y revocación auto
- Autenticación multi-factor: Argon2id, JWT rotativo, TOTP, WebAuthn/passkeys
- Enlaces públicos con token+contraseña+límite descargas+brute-force lockout
- Actualización automática con rollback en app + modo mantenimiento + drain
- Observabilidad completa: analytics, error log, webhooks, Prometheus metrics
- Solo almacenamiento local bind-mount o S3-compatible (no otros backends)
- Frontend solo light theme disponible actualmente
- Requiere Traefik para TLS en producción según documentación
- ClamAV requiere configuración externa del daemon clamd
- Soporte i18n limitado a EN+DE en la versión actual
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar ./install.sh --url=https://... para producción o docker compose up -d para desarrollo. Reemplazar 4 secretos (DB_PASSWORD, DB_ROOT_PASSWORD, JWT_SECRET, TUS_HOOK_SECRET) con valores aleatorios antes de arrancar en producción. Asegurar UID 1000 en data dirs si el host no es usuario 1000. Traefik debe terminar TLS y enrutar a loopback-bound compose stack.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.