CloudSite
CloudSite es un portal auto-alojado basado en AList para navegación, búsqueda, previsualización y compartición segura de recursos de almacenamiento en la nube.
Ficha actualizada 22 sept 2026, 16:05 · upstream 22 sept 2026, 13:18 · release v1.0.0
Qué es CloudSite
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
CloudSite es una plataforma auto-alojada diseñada para transformar directorios de AList en sitios web limpios y organizados, permitiendo a los usuarios navegar, buscar y previsualizar recursos multimedia y documentos. El sistema utiliza una arquitectura separada donde el servicio web (Next.js) maneja la interfaz de usuario y el API backend (FastAPI) gestiona la lógica de negocio, incluyendo autenticación, gestión de colecciones, sincronización de índices y control de compartición segura.
La plataforma soporta previsualización de imágenes, videos compatibles con navegador, PDFs, texto, Markdown y documentos Office comunes. Permite crear enlaces de descarga directa con códigos de acceso opcionales y límites de tiempo, protegiendo las credenciales de AList mediante cifrado del lado del servidor. El despliegue se realiza mediante Docker Compose en contenedores oficiales de 1.0.0, exponiendo el servicio web en el puerto 3000 y manteniendo el API en una red interna (puerto 8000).
Los datos persistentes se almacenan en ./data, con state.db para identidad, usuarios, credenciales cifradas, configuraciones, colecciones y compartición, e index.db para el índice de recursos y estado de sincronización. La documentación incluye guías completas para instalación, arquitectura, administración, recuperación ante desastres y despliegue offline. Se recomienda backup manual antes de actualizaciones y evitar ejecutar docker compose down -v en producción.
- Portal centralizado para acceder a recursos de almacenamiento en la nube (AList) con navegación profunda y búsqueda eficiente
- Compartición segura de archivos mediante enlaces expirables con códigos de acceso numéricos y límites de descarga
- Previsualización in-situ de imágenes, videos, PDFs y documentos sin descargar los archivos originales
- Organización de colecciones curadas de software, medios y documentos con rutas configurables
- Despliegue simplificado en servidores headless o VPS usando Docker Compose sin instalar Node.js ni Python
- Arquitectura desacoplada: el servicio web delega la entrega de archivos a AList mediante HTTP 302, evitando carga de cuerpos de archivos
- Cifrado del lado del servidor para credenciales de AList usando CLOUDSITE_MASTER_KEY y CLOUDSITE_SECRET_KEY
- Soporte nativo para arquitecturas linux/amd64 y linux/arm64 con imágenes Docker oficiales
- Gestión completa de usuarios, colecciones, sincronización y diagnóstico desde consola administrativa
- Independencia del servidor: no requiere Node.js ni Python instalados en el host, solo Docker Engine y plugin Compose
- Dependencia crítica de AList para la entrega real de archivos; rendimiento y compatibilidad de codecs dependen del proveedor de almacenamiento subyacente
- Necesidad de backup manual de state.db e index.db antes de cada actualización; no incluye sistema automático de backup en el repositorio
- Restrición a arquitecturas x86_64 y arm64; sin soporte explícito para otras plataformas o sistemas operativos
- Configuración inicial obligatoria con CLOUDSITE_SETUP_TOKEN que debe eliminarse tras la configuración para evitar fugas de credenciales
- No incluye Dockerfile ni Dockerfile oficial, requiriendo uso exclusivo de imágenes precompiladas del release v1.0.0
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.
Requisitos: Docker Engine y plugin Compose. Clonar repositorio, copiar .env.example a .env, configurar CLOUDSITE_SECRET_KEY con valor aleatorio largo y CLOUDSITE_SETUP_TOKEN para flujo inicial de configuración AList. Ejecutar docker compose up -d --wait con imágenes fijas 1.0.0. Tras completar configuración inicial, eliminar CLOUDSITE_SETUP_TOKEN de .env y reiniciar servicios. Mantener CLOUDSITE_SECRET_KEY y CLOUDSITE_MASTER_KEY estables tras guardar credenciales para evitar fallo en descifrado. Backup obligatorio de ./data antes de cada upgrade. Verificar salud con curl -fsS http://127.0.0.1:3000/api/health. Integración HTTPS opcional con Traefik mediante docker-compose.traefik.yml.
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.