Acesso
- Abra o seu browser:
https://<SERVER-IP> - Aceite o aviso de certificado do navegador, pois a instalação usa um certificado TLS autoassinado.
- É necessária autenticação (pop-up de Basic Auth)
- Método de autenticação: HTTP Basic Auth
- As credenciais de login são armazenadas com segurança em:
/root/.cloudzy-creds
Adicionar arquivos
- Coloque os arquivos e pastas que deseja compartilhar em:
/root/directory-lister/files - O Directory Lister lê esse diretório diretamente, então arquivos recém-adicionados aparecem automaticamente sem reiniciar a aplicação.
Ficheiros e diretórios importantes
- Caminho de instalação:
/root/directory-lister - Arquivos listados:
/root/directory-lister/files - Arquivo Docker Compose:
/root/directory-lister/docker-compose.yml - Arquivo de ambiente:
/root/directory-lister/.env - Credenciais:
/root/directory-lister/.credentials - Configuração do Nginx:
/etc/nginx/sites-available/directory-lister - Arquivo de Basic Auth:
/etc/nginx/.htpasswd-directory-lister - Certificado TLS:
/etc/nginx/ssl/directory-lister.crt - Chave privada TLS:
/etc/nginx/ssl/directory-lister.key
Gestão de serviços
Ver os contêineres em execução:
docker compose -f /root/directory-lister/docker-compose.yml ps
Reiniciar o Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml restart
Ver os logs do Directory Lister:
cd /root/directory-lister && docker compose logs -f
Parar o Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml stop
Iniciar o Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml start
Recriar o Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml up -d
Verificar o status do Nginx:
systemctl status nginx
Reiniciar o Nginx:
systemctl restart nginx
Recarregar o Nginx:
systemctl reload nginx
Valide a configuração do Nginx:
nginx -t
Ativar o HTTPS com um domínio
1. Aponte o seu domínio para o IP do servidor.
2. Editar /etc/nginx/sites-available/directory-lister e substitua ambas server_name _; diretivas pelo seu domínio (por exemplo, server_name yourdomain.com;).
3. Instalar o Certbot:
apt install -y certbot python3-certbot-nginx
4. Obtenha um certificado Let's Encrypt:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Edite /etc/nginx/sites-available/directory-lister e atualize as ssl_certificate e ssl_certificate_key diretivas para usar o seu certificado 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. Recarregue o Nginx para aplicar as alterações:
systemctl reload nginx
7. Acesse o Directory Lister em https://yourdomain.com.
Desativar o HTTP Basic Auth no Nginx (opcional)
Para tornar o Directory Lister acessível publicamente sem autenticação, siga os passos abaixo para desativar o HTTP Basic Auth.
Edite o arquivo de site do Nginx: /etc/nginx/sites-available/directory-lister
Remova ou comente estas linhas:
auth_basic "Directory Lister";
auth_basic_user_file /etc/nginx/.htpasswd-directory-lister;
Recarregar o Nginx:
systemctl restart nginx
Notas
- O Directory Lister roda em Docker atrás do NGINX.
- O acesso público é protegido por HTTP Basic Authentication.
- Os arquivos listados ficam em
/root/directory-lister/files. - O contêiner da aplicação tem apenas acesso de leitura ao diretório de arquivos.
