Acceso
- Abre tu navegador:
https://<SERVER-IP> - Acepta la advertencia de certificado del navegador, ya que la instalación usa un certificado TLS autofirmado.
- Se requiere autenticación (ventana emergente de Basic Auth)
- Método de autenticación: HTTP Basic Auth
- Las credenciales de acceso se guardan de forma segura en:
/root/.cloudzy-creds
Añadir archivos
- Coloca los archivos y carpetas que quieras compartir en:
/root/directory-lister/files - Directory Lister lee este directorio directamente, así que los archivos nuevos aparecen automáticamente sin reiniciar la aplicación.
Archivos y directorios importantes
- Ruta de instalación:
/root/directory-lister - Archivos listados:
/root/directory-lister/files - Archivo de Docker Compose:
/root/directory-lister/docker-compose.yml - Archivo de entorno:
/root/directory-lister/.env - Credenciales:
/root/directory-lister/.credentials - Configuración de Nginx:
/etc/nginx/sites-available/directory-lister - Archivo de Basic Auth:
/etc/nginx/.htpasswd-directory-lister - Certificado TLS:
/etc/nginx/ssl/directory-lister.crt - Clave privada TLS:
/etc/nginx/ssl/directory-lister.key
Gestión de servicios
Ver los contenedores en ejecución:
docker compose -f /root/directory-lister/docker-compose.yml ps
Reiniciar Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml restart
Ver los registros de Directory Lister:
cd /root/directory-lister && docker compose logs -f
Detener Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml stop
Iniciar Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml start
Recrear Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml up -d
Comprobar el estado de Nginx:
systemctl status nginx
Reiniciar Nginx:
systemctl restart nginx
Recargar Nginx:
systemctl reload nginx
Valida la configuración de Nginx:
nginx -t
Habilitar HTTPS con un dominio
1. Apunta tu dominio a la IP del servidor.
2. Edita /etc/nginx/sites-available/directory-lister y reemplaza ambas server_name _; directivas por tu dominio (por ejemplo, server_name yourdomain.com;).
3. Instala Certbot:
apt install -y certbot python3-certbot-nginx
4. Obtén un certificado de Let's Encrypt:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Edita /etc/nginx/sites-available/directory-lister y actualiza las ssl_certificate y ssl_certificate_key directivas para que usen tu certificado de Let's Encrypt.
Before:
ssl_certificate /etc/nginx/ssl/directory-lister.crt;
ssl_certificate_key /etc/nginx/ssl/directory-lister.key;
After:
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. Recargue Nginx para aplicar los cambios:
systemctl reload nginx
7. Accede a Directory Lister en https://yourdomain.com.
Desactivar HTTP Basic Auth en Nginx (opcional)
Para que Directory Lister sea accesible públicamente sin autenticación, sigue los pasos siguientes para desactivar HTTP Basic Auth.
Edita el archivo del sitio de Nginx: /etc/nginx/sites-available/directory-lister
Elimina o comenta estas líneas:
auth_basic "Directory Lister";
auth_basic_user_file /etc/nginx/.htpasswd-directory-lister;
Recargar Nginx:
systemctl restart nginx
Notas
- Directory Lister se ejecuta en Docker detrás de NGINX.
- El acceso público está protegido mediante HTTP Basic Authentication.
- Los archivos listados se guardan en
/root/directory-lister/files. - El contenedor de la aplicación solo tiene acceso de lectura al directorio de archivos.
