private-directory-server
Servidor local-first para navegación de archivos con autenticación, previsualizaciones y streaming. Basado en Node.js, puerto 8000, sin dependencias externas. Ideal para acceso seguro a carpetas locales desde navegador.
Ficha actualizada 24 sept 2026, 2:49 · upstream 24 sept 2026, 2:38 · release sin release detectada
Qué es private-directory-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Private Directory Server es un servidor web de código abierto diseñado para navegar archivos locales con seguridad integrada por defecto. Utiliza Node.js como único runtime y soporta autenticación mediante tokens, búsqueda recursiva, previsualizaciones multimedia y streaming de archivos grandes con soporte de rango HTTP.
El proyecto prioriza la seguridad: binding a localhost por defecto, acceso read-only, exclusión de archivos ocultos y prevención de escape mediante symlinks. Incluye autenticación Bearer opcional para acceso en red privada, con limitación de intentos fallidos (5 intentos en 15 minutos). Soporta despliegue nativo o Docker.
La arquitectura es simple: un solo proceso Node.js sin microservicios complejos. Los archivos se sirven directamente del sistema de archivos local sin copias intermedias. Incluye API REST para gestión de sesiones, listado de directorios, búsqueda y descargas.
- Navegación segura de archivos locales desde cualquier navegador web
- Acceso remoto a carpetas compartidas en red Wi-Fi con token de acceso
- Previsualización de documentos (PDF, imágenes, audio, video) sin descargar
- Streaming de archivos grandes con soporte de reanudación de descargas
- Seguridad por defecto: binding localhost, read-only y sin escape de symlinks
- Solo Node.js como dependencia runtime, sin frameworks adicionales
- Previsualizaciones responsive para móviles con búsqueda recursiva
- Streaming HTTP real con soporte byte-range para archivos grandes
- Sin telemetría ni analytics, solo MIT license libre
- No incluye TLS nativo; requiere proxy HTTPS externo para producción
- Requiere Node.js 20 o superior (documenta 22+)
- Búsqueda limitada a máximo 200 resultados por consulta
- Subidas deshabilitadas por defecto, requieren configuración explícita
- La aplicación de escritorio Windows requiere .NET Framework para el launcher
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Configurar DIRECTORY_ROOT antes de iniciar. Para red privada: establecer ACCESS_TOKEN con al menos 16 caracteres y HOST=0.0.0.0. Mantener volumen read-only en Docker por defecto. Usar proxy HTTPS si se expone externamente. Puerto 8000 o ephemeral con PORT=0.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.