Доступ
- Відкрийте браузер:
https://<SERVER-IP> - Прийміть попередження браузера про сертифікат, оскільки встановлення використовує самопідписаний сертифікат TLS.
- Потрібна автентифікація (спливне вікно Basic Auth)
- Метод автентифікації: HTTP Basic Auth
- Облікові дані для входу безпечно зберігаються в:
/root/.cloudzy-creds
Додавання файлів
- Розмістіть файли та теки, якими хочете поділитися, у:
/root/directory-lister/files - Directory Lister читає цей каталог напряму, тому нові файли з'являються автоматично без перезапуску застосунку.
Важливі файли та директорії
- Шлях встановлення:
/root/directory-lister - Відображені файли:
/root/directory-lister/files - Файл Docker Compose:
/root/directory-lister/docker-compose.yml - Файл середовища:
/root/directory-lister/.env - Облікові дані:
/root/directory-lister/.credentials - Конфігурація Nginx:
/etc/nginx/sites-available/directory-lister - Файл Basic Auth:
/etc/nginx/.htpasswd-directory-lister - Сертифікат TLS:
/etc/nginx/ssl/directory-lister.crt - Приватний ключ TLS:
/etc/nginx/ssl/directory-lister.key
Керування сервісом
Перегляд запущених контейнерів:
docker compose -f /root/directory-lister/docker-compose.yml ps
Перезапустити Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml restart
Перегляд логів Directory Lister:
cd /root/directory-lister && docker compose logs -f
Зупинити Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml stop
Запустити Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml start
Перестворити Directory Lister:
docker compose -f /root/directory-lister/docker-compose.yml up -d
Перевірити стан Nginx:
systemctl status nginx
Перезапустити Nginx:
systemctl restart nginx
Перезавантажити Nginx:
systemctl reload nginx
Перевірте конфігурацію Nginx:
nginx -t
Увімкнення HTTPS з доменом
1. Спрямуйте свій домен на IP-адресу сервера.
2. Редагування /etc/nginx/sites-available/directory-lister та замініть обидві server_name _; директиви своїм доменом (наприклад, server_name yourdomain.com;).
3. Встановіть Certbot:
apt install -y certbot python3-certbot-nginx
4. Отримайте сертифікат Let's Encrypt:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Відредагуйте /etc/nginx/sites-available/directory-lister та оновіть ssl_certificate та ssl_certificate_key директиви, щоб використовувати ваш сертифікат 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. Перезавантажте Nginx для застосування змін:
systemctl reload nginx
7. Відкрийте Directory Lister за адресою https://yourdomain.com.
Вимкнення HTTP Basic Auth в Nginx (необов'язково)
Щоб зробити Directory Lister загальнодоступним без автентифікації, виконайте наведені нижче кроки та вимкніть HTTP Basic Auth.
Відредагуйте файл сайту Nginx: /etc/nginx/sites-available/directory-lister
Видаліть або закоментуйте ці рядки:
auth_basic "Directory Lister";
auth_basic_user_file /etc/nginx/.htpasswd-directory-lister;
Перезавантажити Nginx:
systemctl restart nginx
Примітки
- Directory Lister працює в Docker за NGINX.
- Публічний доступ захищено за допомогою HTTP Basic Authentication.
- Відображені файли зберігаються в
/root/directory-lister/files. - Контейнер застосунку має лише доступ на читання до каталогу файлів.
