Also available in English: read in English.
Todo empezó con un viaje y un montón de fotos.
Volví de un viaje con amigos con un montón de fotos que todo el mundo quería. Las opciones de siempre fallaban de la misma forma aburrida. Los adjuntos de correo rebotan. Los servicios gratuitos de transferencia te limitan el tamaño y borran el enlace pasado un tiempo, justo antes de que alguien se decida por fin a descargarlo.
Lo que yo quería era casi ridículamente sencillo: un enlace que funcione, durante el tiempo que yo decida, para ficheros tan grandes como haga falta, en un servidor que es mío. Así que lo construí. Eso es Tossbox: un servicio pequeño y autoalojado donde subes un fichero desde un panel protegido con contraseña y te devuelve un enlace de descarga directo y público. Sin más límite de tamaño que el que tú pongas, sin más caducidad que la que tú quieras, y sin cuenta para la persona del otro lado.

Funciona en un único contenedor Docker, guarda todo en una carpeta y no tiene dependencias nativas, así que la misma imagen sirve para amd64, arm64 y armv7: una Raspberry Pi, un Mac con Apple Silicon o un servidor Linux normal.
Qué hace
- Panel de administración con login: subir, listar, copiar el enlace y eliminar.
- Enlaces directos (
/d/<uuid>): públicos, sin login para quien descarga, y conservan el nombre original del fichero. - Historial de descargas por fichero: fecha e IP de las últimas 200 descargas, además de un contador.
- Carpeta vigilada: deja un fichero en
data/watch/y se publica solo, una vez que su tamaño ha dejado de cambiar, de modo que nunca se registra una copia a medias. - Bot de Telegram (opcional): un aviso por cada descarga y comandos para consultar el estado, listar, borrar o subir ficheros desde el chat.
- HTTPS automático con Let’s Encrypt, mediante una variante incluida que pone Caddy delante de la aplicación.
- Protección razonable del login: límite de intentos por IP, regeneración de la sesión, comparaciones en tiempo constante y escrituras de la base de datos que no pueden dejar un fichero a medias.
Pruébalo
Con Docker instalado:
docker run -d \
--name fileshare \
-p 3000:3000 \
-v ./data:/app/data \
-e ADMIN_USER=admin \
-e ADMIN_PASSWORD=cambia_esto \
-e SESSION_SECRET=una_cadena_aleatoria_larga \
-e BASE_URL=http://localhost:3000 \
mgoreiro/fileshare:latest
Abre http://localhost:3000, entra y sube algo. El repositorio incluye un docker-compose.yml y otro con Caddy y HTTPS automático por si quieres exponerlo a Internet. Una nota sobre los nombres: el proyecto se llamaba FileShare, y el repositorio, la imagen de Docker y el contenedor siguen llamándose así, de modo que las instalaciones existentes siguen funcionando.
A hombros de gigantes
Tossbox es una capa fina sobre un gran trabajo de código abierto: Node.js y Express para el servidor, Caddy y Let’s Encrypt para el HTTPS, y quienes mantienen las muchas bibliotecas pequeñas en las que se apoya. Gracias.
Un compañero para la variante HTTPS
Si usas la variante con Caddy, hay una herramienta de terminal aparte que escribí para cuidar de ese Caddy: caddy-tui. Es opcional y Tossbox no la necesita.
El código está en GitHub con licencia MIT, y la imagen en Docker Hub. Se agradecen incidencias, ideas y pull requests.
Recuerda que cualquiera que tenga un enlace puede descargar el fichero, y que la carpeta vigilada se salta el login por diseño: protégela igual que proteges el panel.