rednote-downloader
rednote-downloader es una herramienta auto-alojada para descargar contenido multimedia de RedNote, X/Twitter y Douyin en un solo contenedor. Funciona en Docker/Unraid, ofrece interfaz web, proxy de descarga y notificaciones a Telegram.
Ficha actualizada 24 sept 2026, 17:12 · upstream 24 sept 2026, 16:57 · release v0.2.25
Qué es rednote-downloader
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
rednote-downloader es una solución auto-alojada diseñada para extraer y guardar medios de plataformas como RedNote (Xiaohongshu), X/Twitter y Douyin. Funciona nativamente en entornos Docker o Unraid, proporcionando una interfaz web intuitiva para resolver enlaces y descargar archivos directamente al servidor o mediante proxy del navegador.
Técnicamente, la aplicación combina Node.js y FastAPI para gestionar las rutas de resolución y descarga. Desde la versión 0.2.23, el contenedor incluye por defecto un servicio REST de descarga para Douyin (jiji262), lo que elimina la necesidad de desplegar una instancia externa adicional para videos individuales. La arquitectura permite configurar múltiples plataformas en una sola instancia mediante variables de entorno y montajes de volumen.
La herramienta prioriza fuentes de video limpias, aunque no realiza transcodificación ni eliminación avanzada de marcas de agua mediante FFmpeg o OpenCV. Es crucial gestionar las cookies correctamente (XHS_COOKIE, DOUYIN_COOKIE) ya que no se escriben en la imagen base para mantener la seguridad y compatibilidad entre sesiones. La API REST expone endpoints para salud, configuración y diagnóstico, facilitando la integración con flujos de trabajo externos.
- Descargar videos individuales de Douyin priorizando fuentes sin marca de agua desde enlaces o textos compartidos.
- Extraer imágenes y archivos multimedia de publicaciones de X/Twitter para archivo local sin depender de servicios externos.
- Recopilar contenido multimedia de Xiaohongshu (RedNote) mediante enlaces directos o texto compartido en la interfaz web.
- Notificar al usuario cuando una descarga se completa mediante un bot de Telegram configurado con token y chat ID.
- Servir como proxy para previsualizar medios antes de guardarlos permanentemente en el directorio local del contenedor.
- Incluye downloader interno de Douyin (jiji262) por defecto, simplificando la arquitectura al evitar despliegues externos.
- Soporta múltiples plataformas (RedNote, X, Douyin) desde una sola instancia con configuración modular.
- Interfaz Web completa para resolución y descarga directa sin necesidad de usar línea de comandos.
- Arquitectura optimizada para Docker Compose y Unraid con soporte nativo para gestión de volúmenes.
- API REST robusta para integración con scripts externos o automatizaciones personalizadas.
- Gestión segura de cookies mediante variables de entorno, evitando persistencia en la imagen base.
- No realiza transcodificación ni edición de video (FFmpeg/OpenCV) para optimizar archivos descargados.
- La eliminación de marca de agua depende de la fuente original; no garantiza videos limpios si el servidor solo ofrece fuentes con marca.
- Requiere cookies válidas (XHS_COOKIE, DOUYIN_COOKIE) para acceder a contenido restringido o privado en las plataformas.
- El downloader interno de Douyin puede deshabilitarse, pero requiere configuración externa compleja si se desea usar uno propio.
- No soporta descargas masivas de perfiles completos; está diseñado para videos individuales o enlaces específicos.
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.
Utiliza docker compose para gestión fácil. Monta /data correctamente y configura PUID/PGID. No escribir cookies en la imagen base. Para Douyin, verificar si se desea usar el downloader interno (DOUYIN_INTERNAL_DOWNLOADER_ENABLED=true) o externo. Asegurar CORS_ALLOWED_ORIGINS si se accede desde navegador remoto.
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.