Skip to main content

TelDrive: Almacenamiento sobre Telegram


Introducción

TelDrive es un servicio autoalojado que permite utilizar la infraestructura de Telegram como backend de almacenamiento, actuando como una capa intermedia entre la API de Telegram y herramientas externas. No es una nube tradicional ni pretende reemplazar soluciones como S3, Nextcloud o Backblaze, sino ofrecer una alternativa ligera para almacenamiento secundario u off‑site aprovechando la alta disponibilidad de Telegram.


Enfoque general / arquitectura

TelDrive funciona como un backend que:

  • Usa la API de usuario de Telegram (no Bot API) para subir y descargar archivos.
  • Almacena los datos reales en un canal privado de Telegram.
  • Mantiene metadatos, sesiones y estado interno en una base de datos PostgreSQL.
  • Expone una interfaz web y un backend compatible con integraciones externas (por ejemplo rclone).

El almacenamiento no reside en el servidor donde se ejecuta TelDrive, sino en la infraestructura de Telegram. El servidor actúa únicamente como coordinador, cifrador y punto de acceso.


Requisitos previos

  • Cuenta de Telegram válida.
  • Credenciales de Telegram API (app_id y app_hash).
  • Canal privado dedicado que actuará como backend de almacenamiento.
  • Base de datos PostgreSQL.
  • Entorno Docker para el despliegue.

Desarrollo

Qué se hizo y por qué

Se optó por TelDrive como almacenamiento secundario para copias cifradas y automatizadas de ciertos directorios, evitando:

  • Costes recurrentes de almacenamiento en la nube.
  • Dependencia de proveedores con límites agresivos o políticas cambiantes.
  • Complejidad innecesaria para datos que no requieren acceso inmediato.

El uso se limita deliberadamente a volúmenes moderados y copias selectivas, evitando generar grandes cantidades de datos o cargas continuas que puedan tensionar la API de Telegram.

Las subidas se realizan mediante integración con rclone y scripts de automatización, manteniendo TelDrive como backend transparente. Esta integración se documentará en un artículo aparte mas adelante, en este caso, las subidas se realizarán mediante la interfaz web, similar a Google Drive.

Configuración utilizada (solo enlaces)


Validación

El funcionamiento se considera correcto cuando:

  • La interfaz web permite autenticarse únicamente con los usuarios definidos.
  • Las subidas y descargas se completan sin errores en los logs.
  • El canal de Telegram configurado recibe los archivos cifrados.
  • La base de datos mantiene estado y sesiones de forma persistente tras reinicios.
  • Las copias automatizadas vía rclone finalizan correctamente en ejecuciones repetidas.

Hasta el momento, el uso continuado con volúmenes contenidos no ha generado errores ni comportamientos anómalos.


Decisiones importantes o problemas detectados

  • No es un backup primario: TelDrive se utiliza únicamente como copia secundaria u off‑site.
  • Dependencia total de Telegram: cambios en la API, límites o políticas pueden afectar al servicio.
  • Límites por archivo: Telegram impone restricciones de tamaño por fichero. En la práctica, TelDrive permite trabajar con archivos de mayor tamaño al encargarse de fragmentarlos internamente en chunks. En uso real se han subido archivos de hasta ~20 GB sin incidencias, siempre que el volumen total y la frecuencia de subida se mantengan dentro de márgenes razonables.

Resumen breve

TelDrive permite reutilizar Telegram como backend de almacenamiento cifrado y distribuido. Yo lo utilizo como solución secundaria para copias automatizadas de bajo volumen, priorizando coste cero y disponibilidad frente a rendimiento o garantías formales.


Notas personales

  • Uso actual limitado y deliberado para evitar abuso de la API.
  • Integración con RClone documentada por separado.
  • Adecuado para datos no críticos o copias adicionales, no como única fuente de respaldo.

Referencias