アクセス
- ブラウザを開く:
https://<SERVER-IP> - このインストールは自己署名 TLS 証明書を使用するため、ブラウザーの証明書警告を承認してください。
- 認証が必要です (Basic 認証のポップアップ)
- 認証方式: HTTP Basic 認証
- ログイン情報は次の場所に安全に保存されます:
/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 認証ファイル：
/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.
Nginx で HTTP Basic 認証を無効にする (任意)
認証なしで Directory Lister を一般公開するには、以下の手順で HTTP Basic 認証を無効にします。
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 は NGINX の背後で Docker 上で動作します。
- 一般公開のアクセスは HTTP Basic 認証で保護されています。
- 一覧表示されるファイルの保存場所は
/root/directory-lister/files. - アプリケーションコンテナーはファイルディレクトリに対して読み取り権限のみを持ちます。
