Zipline | File Sharing | ShareX Server

Zipline: El servidor de subida de archivos definitivo y acortador de URLs

Súper ligero. Integración perfecta con ShareX. Acortador de links integrado. Webhooks de Discord. OAuth2 y Passkeys. AGPL-3.0 open source. Self-hosted.

¿Qué es Zipline?

Zipline es un servidor de subida de archivos diseñado específicamente para ser el backend ideal de herramientas como ShareX, pero que funciona como una plataforma completa de compartición de archivos y acortador de URLs. Es la solución perfecta para quienes quieren dejar de depender de Imgur o Dropbox y tener sus propios assets bajo control total.

Ventaja clave: Combina la potencia de un servidor de archivos con la utilidad de un acortador de enlaces. Todo en una sola interfaz moderna, rápida y extremadamente fácil de configurar mediante Docker.

Características principales: Gestión de archivos mediante carpetas y etiquetas. Acortador de URLs integrado. Integraciones profundas con Discord mediante Webhooks. Sistema de seguridad avanzado con OAuth2 (Discord, GitHub, Google), 2FA y Passkeys. Protección de archivos mediante contraseñas. Optimización automática: compresión de imágenes y generación de miniaturas para vídeo. API robusta para automatizaciones. PWA para acceso rápido desde el móvil.

Ideal para: Creadores de contenido, administradores de bots de Discord y cualquier usuario de ShareX que quiera soberanía sobre sus capturas y archivos.

Características principales

Backend para ShareX

Diseñado para integrarse a la perfección con ShareX, facilitando la subida instantánea de capturas.

Acortador de URLs

No solo subas archivos; crea enlaces cortos y personalizados para cualquier destino.

Webhooks de Discord

Notifica automáticamente a tus canales de Discord cada vez que se suba un archivo específico.

Seguridad Avanzada

Soporta Passkeys, 2FA y OAuth2 para que solo tú y tus invitados accedan a los datos.

Optimización de Media

Compresión inteligente de imágenes y generación de thumbnails para vídeos automáticamente.

Organización Total

Usa carpetas y etiquetas para clasificar miles de archivos sin perder el control.

Control de Acceso

Protege archivos sensibles con contraseñas y gestiona cuotas de subida por usuario.

API & PWA

Crea tus propias integraciones vía API o usa la aplicación web progresiva en tu móvil.

Requisitos del sistema

CPU con soporte AVX (Obligatorio: Zipline no funciona en CPUs sin AVX)
Docker & Docker Compose
PostgreSQL 16 (Incluido en el compose)
RAM: 1-2 GB recomendados
Espacio en disco: Depende de la cantidad de archivos que planees alojar
Navegador moderno

Aviso Crítico: Asegúrate de que tu procesador soporte la instrucción AVX. Si usas algunos procesadores ARM muy antiguos o Celeron básicos, es posible que la imagen de Docker no inicie.

Instalación con Docker Compose

Paso 1: Generar secretos y crear .env

Zipline requiere un CORE_SECRET y una contraseña de base de datos. Ejecuta esto en tu terminal:

Paso 2: Crear docker-compose.yml

cat > docker-compose.yml << 'EOF' services: postgresql: image: postgres:16 restart: unless-stopped env_file: - .env environment: - POSTGRES_USER=zipline - POSTGRES_DB=zipline volumes: - pgdata:/var/lib/postgresql/data healthcheck: test: ['CMD', 'pg_isready', '-U', 'zipline'] interval: 10s timeout: 5s retries: 5 zipline: image: ghcr.io/diced/zipline ports: - "3000:3000" env_file: - .env environment: - DATABASE_URL=postgres://zipline:${POST…WORD}@postgresql:5432/zipline depends_on: postgresql: condition: service_healthy volumes: - ./uploads:/zipline/uploads - ./public:/zipline/public - ./themes:/zipline/themes restart: unless-stopped volumes: pgdata: EOF

Paso 3: Iniciar el servidor

docker compose up -d

Acceder

http://localhost:3000 - Dashboard de Zipline

Primeros pasos

1. Configuración Inicial

Entra en la web y crea tu cuenta de administrador.
Configura el DATASOURCE_LOCAL_DIRECTORY si quieres cambiar dónde se guardan los archivos físicamente.

2. Integrar con ShareX

En Zipline, ve a la sección de API/Configuración y obtén tu clave de API.
En ShareX $\rightarrow$ Destinos $\rightarrow$ Custom uploader settings.
Configura la URL de subida de Zipline y añade la API Key en los headers.

3. Crear tu primer enlace corto

Ve a la sección de acortador en el dashboard.
Introduce la URL de destino y elige un alias personalizado.
¡Listo! Ya tienes un link corto propio.

4. Configurar OAuth2

Crea una aplicación en el portal de desarrolladores de Discord o Google.
Copia el Client ID y Secret en la configuración de Zipline.
Ahora tus usuarios podrán entrar con un solo clic.

Casos de uso

Backend de Capturas: Sube tus screenshots de ShareX instantáneamente sin usar servicios externos.
Acortador Privado: Gestiona tus propios enlaces cortos para redes sociales o mensajes sin tracking.
Repositorio de Assets: Guarda imágenes y vídeos para tus proyectos web con acceso rápido vía URL.
Compartición Segura: Envía archivos confidenciales con contraseñas y fecha de caducidad.
Notificaciones Automáticas: Configura webhooks para que tu servidor de Discord avise cada vez que alguien suba un archivo.

HTTPS con Caddy (producción)

Caddyfile

zipline.tudominio.com { reverse_proxy localhost:3000 }

Acceso remoto seguro

https://zipline.tudominio.com con SSL automático y cifrado de extremo a extremo.

Gestión y mantenimiento

Ver logs en tiempo real

docker compose logs -f zipline

Backup de la base de datos

docker compose exec postgresql pg_dump -U zipline zipline > zipline_db_backup.sql

Actualizar la versión

docker compose pull docker compose up -d

Monitorear consumo

docker stats zipline postgresql

Comparativa con alternativas

vs Imgur

Zipline gana: Eres el dueño de los archivos, no hay censura, tienes acortador propio y privacidad total. Imgur gana: Comunidad integrada y facilidad de uso sin servidor.

vs Dropbox / Google Drive

Zipline gana: Especializado en subidas rápidas y enlaces cortos, mucho más ligero. Dropbox gana: Herramientas de oficina y sincronización masiva de carpetas.

vs Pastebin

Zipline gana: Permite archivos binarios (imágenes, vídeos) además de texto, con control total del hosting.

Mejor para: Usuarios de ShareX y administradores de comunidades que necesitan un servidor de archivos rápido, privado y con esteroides.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Cómo instalar Zipline en Docker - Servidor de subida de archivos y acortador profesional