Dostęp
- Otwórz przeglądarkę:
https://<SERVER-IP> - Zaakceptuj ostrzeżenie przeglądarki o certyfikacie, ponieważ instalacja używa samopodpisanego certyfikatu TLS.
- Wymagane jest uwierzytelnienie (okienko Basic Auth)
- Metoda uwierzytelniania: HTTP Basic Auth
- Dane logowania są bezpiecznie zapisane w:
/root/.cloudzy-creds
Dodawanie plików
- Umieść pliki i foldery, które chcesz udostępnić, w:
/root/directory-lister/files - Directory Lister czyta ten katalog bezpośrednio, więc nowo dodane pliki pojawiają się automatycznie bez restartu aplikacji.
Ważne pliki i katalogi
- Ścieżka instalacji:
/root/directory-lister - Wyświetlane pliki:
/root/directory-lister/files - Plik Docker Compose:
/root/directory-lister/docker-compose.yml - Plik środowiskowy:
/root/directory-lister/.env - Dane logowania:
/root/directory-lister/.credentials - Konfiguracja Nginx:
/etc/nginx/sites-available/directory-lister - Plik Basic Auth:
/etc/nginx/.htpasswd-directory-lister - Certyfikat TLS:
/etc/nginx/ssl/directory-lister.crt - Klucz prywatny TLS:
/etc/nginx/ssl/directory-lister.key
Zarządzanie usługami
Wyświetl działające kontenery:
docker compose -f /root/directory-lister/docker-compose.yml ps
Uruchom ponownie Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml restart
Wyświetl logi Directory Lister:
cd /root/directory-lister && docker compose logs -f
Zatrzymaj Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml stop
Uruchom Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml start
Utwórz ponownie Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml up -d
Sprawdź stan Nginx:
systemctl status nginx
Uruchom ponownie Nginx:
systemctl restart nginx
Przeładuj Nginx:
systemctl reload nginx
Zweryfikuj konfigurację Nginx:
nginx -t
Włączanie HTTPS z domeną
1. Skieruj swoją domenę na IP serwera.
2. Edycja /etc/nginx/sites-available/directory-lister i zastąp oba server_name _; dyrektywy swoją domeną (np. server_name yourdomain.com;).
3. Zainstaluj Certbot:
apt install -y certbot python3-certbot-nginx
4. Uzyskaj certyfikat Let's Encrypt:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Edytuj /etc/nginx/sites-available/directory-lister i zaktualizuj ssl_certificate oraz ssl_certificate_key dyrektywy, aby używały Twojego certyfikatu 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. Przeładuj Nginx, aby zastosować zmiany:
systemctl reload nginx
7. Otwórz Directory Lister pod adresem https://yourdomain.com.
Wyłączenie HTTP Basic Auth w Nginx (opcjonalnie)
Aby udostępnić Directory Lister publicznie bez uwierzytelniania, wykonaj poniższe kroki i wyłącz HTTP Basic Auth.
Edytuj plik witryny Nginx: /etc/nginx/sites-available/directory-lister
Usuń lub zakomentuj te wiersze:
auth_basic "Directory Lister";
auth_basic_user_file /etc/nginx/.htpasswd-directory-lister;
Przeładuj Nginx:
systemctl restart nginx
Uwagi
- Directory Lister działa w Dockerze za NGINX.
- Dostęp publiczny jest chroniony za pomocą HTTP Basic Authentication.
- Wyświetlane pliki są przechowywane w
/root/directory-lister/files. - Kontener aplikacji ma tylko uprawnienia odczytu do katalogu plików.
