imgpush
Servicio autoalojado minimalista para gestión de imágenes de usuarios. Ofrece API REST para subida, redimensionamiento y conversión automática con soporte S3, filtrado de contenido y autenticación por claves API.
Ficha actualizada 19 sept 2026, 2:58 · upstream 19 sept 2026, 2:58 · release sin release detectada
Qué es imgpush
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
imgpush es un servicio autoalojado diseñado para gestionar imágenes subidas por usuarios dentro de una aplicación. Proporciona una interfaz de programación simple mediante endpoints REST que permiten la carga directa de archivos, subida por URL y recuperación de versiones redimensionadas dinámicamente. El servicio incluye funcionalidades de seguridad como filtrado de contenido inapropiado mediante NudeNet, limitación de tasa (rate limiting) y autenticación opcional mediante claves API para proteger los endpoints de eliminación o subida.
El sistema soporta almacenamiento local o en objetos compatibles con S3 (como AWS S3, Cloudflare R2 o MinIO), lo que permite escalar la infraestructura sin cambiar la lógica de aplicación. Incluye un endpoint de salud (/liveness) para monitoreo y soporte nativo para despliegues en contenedores Docker y Kubernetes. La configuración se realiza mediante variables de entorno, permitiendo ajustar límites de tamaño, tipos de archivo y estrategias de nombres de archivos.
- Servidor de avatares para aplicaciones web o móviles
- Gestión de imágenes de productos en tiendas online pequeñas
- Endpoint de subida de contenido para CMS headless
- Previsualización de imágenes optimizadas para redes sociales
- Almacenamiento temporal de assets multimedia en microservicios
- API REST unificada para carga, eliminación y recuperación por URL
- Soporte nativo para backend S3 (AWS, R2, MinIO) con caché local
- Filtrado automático de contenido inapropiado integrado
- Redimensionamiento y conversión automática a formatos específicos
- Endpoint /liveness para healthchecks en Docker y Kubernetes
- Configuración flexible vía variables de entorno sin reinicio complejo
- Dependencia de ImageMagick para procesamiento, lo que puede complicar el despliegue en entornos minimalistas
- Filtrado de contenido basado en NudeNet, que podría tener falsos positivos o negativos según el modelo
- Almacenamiento local por defecto requiere gestión manual de discos si no se configura S3
- No incluye panel de administración web, solo interfaz API
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.
Requiere Docker. Para producción, configurar STORAGE_BACKEND=s3 y variables de credenciales. Asegurar límites de subida (MAX_SIZE_MB) y rate limiting (MAX_UPLOADS_PER_DAY). Usar volumen persistente para /images. En Kubernetes, aplicar el ejemplo del directorio kubernetes/ y configurar Ingress. Verificar salud con /liveness.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.