· FlingDrop Team · Desarrolladores · 4 min read
Cómo compartir archivos desde la línea de comandos — Guía CLI para desarrolladores
La herramienta CLI de FlingDrop te permite subir archivos y obtener enlaces temporales compartibles directamente desde tu terminal en Windows, macOS o Linux. Esta guía cubre la instalación, configuración, uso básico y ejemplos de scripts.
La interfaz de línea de comandos (CLI) de FlingDrop te permite subir archivos y obtener enlaces de descarga temporales directamente desde tu terminal — sin abrir un navegador ni usar una interfaz gráfica. Está disponible para Windows, macOS y Linux, lo que la convierte en la herramienta adecuada para desarrolladores, administradores de sistemas e ingenieros de DevOps que trabajan en la terminal.
Instalación
macOS
# Descarga el binario para macOS
curl -L https://app.flingdrop.com/cli/download/macos -o flingdrop
chmod +x flingdrop
sudo mv flingdrop /usr/local/bin/O instala a través de Homebrew (si el tap está configurado):
brew install flingdropLinux
curl -L https://app.flingdrop.com/cli/download/linux -o flingdrop
chmod +x flingdrop
sudo mv flingdrop /usr/local/bin/Windows
Descarga flingdrop.exe desde flingdrop.com/download o a través de PowerShell:
Invoke-WebRequest -Uri "https://app.flingdrop.com/cli/download/windows" -OutFile "flingdrop.exe"Añade el directorio que contiene flingdrop.exe a tu PATH para acceso global.
Configuración
Antes de tu primera subida, configura tu clave API:
flingdrop config set api-key TU_CLAVE_API_AQUITu clave API está disponible en tu panel de control de FlingDrop o te la enviaron por correo electrónico al registrarte. La clave se almacena en ~/.config/flingdrop/config.json (Linux/macOS) o %APPDATA%\flingdrop\config.json (Windows).
Verifica tu configuración:
flingdrop config showUso básico
Subir un archivo
flingdrop upload informe.pdfSalida:
Subiendo informe.pdf... listo
Enlace de descarga: https://app.flingdrop.com/d/f_abc123xyz
Vence: 2026-04-01 (30 días)
Enlace copiado al portapapeles.Subir con vencimiento personalizado
flingdrop upload contrato.pdf --expires 14Subir y obtener solo la URL (para scripts)
flingdrop upload exportacion-datos.csv --quiet
# Muestra solo la URL, sin texto de progresoListar tus archivos subidos
flingdrop listEliminar un archivo
flingdrop delete f_abc123xyzEjemplos de scripts
Bash: Subida de copia de seguridad nocturna
#!/bin/bash
ARCHIVO_BACKUP="/var/backups/db-$(date +%Y%m%d).sql.gz"
pg_dump mibd | gzip > "$ARCHIVO_BACKUP"
ENLACE=$(flingdrop upload "$ARCHIVO_BACKUP" --expires 7 --quiet)
echo "Copia de seguridad subida: $ENLACE"
# Envía el enlace por correo electrónico, Slack o notificación de PagerDuty
curl -X POST https://hooks.slack.com/services/TU/WEBHOOK \
-H 'Content-type: application/json' \
-d "{\"text\": \"Copia de seguridad nocturna lista: $ENLACE\"}"Python: Subida desde un script
import subprocess
def subir_a_flingdrop(ruta_archivo, dias_vencimiento=7):
resultado = subprocess.run(
['flingdrop', 'upload', ruta_archivo, '--expires', str(dias_vencimiento), '--quiet'],
capture_output=True, text=True
)
return resultado.stdout.strip()
download_url = subir_a_flingdrop('/tmp/informe.pdf', dias_vencimiento=14)
print(f"Informe disponible en: {download_url}")CI/CD: Compartir artefactos de compilación
En un flujo de trabajo de GitHub Actions, sube artefactos de compilación y publica el enlace en un comentario de PR:
- name: Subir artefacto de compilación
run: |
ENLACE=$(flingdrop upload dist/app.zip --expires 3 --quiet)
echo "Artefacto de compilación: $ENLACE" >> $GITHUB_STEP_SUMMARY
env:
FLINGDROP_API_KEY: ${{ secrets.FLINGDROP_API_KEY }}Nota: Configura FLINGDROP_API_KEY como variable de entorno para anular el archivo de configuración en entornos CI.
Configuración mediante variables de entorno
Para entornos CI/CD y contenedorizados donde escribir en un archivo de configuración no es práctico:
export FLINGDROP_API_KEY=tu_clave_api_aqui
flingdrop upload archivo.zipLa variable de entorno tiene prioridad sobre el archivo de configuración.
Límites por plan
| Plan | Tamaño máximo de archivo | Pool mensual |
|---|---|---|
| Business ($29/mes) | 10 GB | 500 GB/mes |
La CLI respeta los mismos límites que la interfaz web y la API. Intentar subir un archivo más grande que el permitido por tu plan devuelve un error con un mensaje claro.
Resolución de problemas
command not found: flingdrop: Asegúrate de que el binario esté en un directorio incluido en tu $PATH. Ejecuta echo $PATH para verificarlo.
Authentication failed: Vuelve a ejecutar flingdrop config set api-key TU_CLAVE. Verifica la clave en tu panel de control de FlingDrop.
File size exceeds plan limit: Actualiza tu plan en el panel de control de FlingDrop para aumentar el límite por archivo.
La subida se bloquea en archivos grandes: FlingDrop usa subidas multiparte para archivos de más de 100 MB. Si tu conexión de red es inestable, la CLI reintentará automáticamente hasta 3 veces antes de fallar.
Resumen
La CLI de FlingDrop ofrece una interfaz rápida y scriptable para compartir archivos temporales que se integra de forma natural en los flujos de trabajo de desarrolladores — desde el uso ad hoc en la terminal hasta pipelines de CI/CD y scripts programados. Instala una vez, configura tu clave API, y flingdrop upload se convierte en la forma más rápida de compartir un archivo desde cualquier sesión de terminal.
Guías relacionadas: