ボリューム（ディスク）
オペレーティングシステムからRoqueOSサーバーへフォルダをマッピングし、ウェブデスクトップのファイルマネージャー内で実際のディスクとして表示させる方法を学びます。
どのように機能するのか？
RoqueOSサーバーは隔離されたDockerコンテナ内で実行されます。セキュリティ上の理由から、コンピューターやホストサーバー上のファイルには自動的にアクセスできません。
ファイルマネージャーでダウンロード、ドキュメント、またはメディアフォルダを表示、編集、整理するには、これらのボリュームをDockerに「マウント」する必要があります — まるでUSBドライブを接続するのと同じです。
設定方法
docker-compose.yml ファイルを変更し、volumes: セクションに行を追加します。
構文:
あなたのコンピューター上のパス : /app/disks/ディスク名重要なルール
右側のパス（RoqueOS内）は、ファイルマネージャーがフォルダを検出してディスクとして表示するために、常に /app/disks/ で始まる必要があります。
実践的な例
yaml
# Linux/macOS
volumes:
- /home/user/Documents:/app/disks/Documents
# Windows
volumes:
- C:\Users\user\Documents:/app/disks/Documentsyaml
# Linux/macOS
volumes:
- /mnt/external-hd/PlexMedia:/app/disks/Media
# Windows
volumes:
- D:\PlexMedia:/app/disks/Mediayaml
# Linux/macOS
volumes:
- /home/user/Downloads:/app/disks/Downloads
# Windows
volumes:
- C:\Users\user\Downloads:/app/disks/Downloads完全な docker-compose.yml の例
yaml
version: '3.8'
services:
roqueos-server:
image: roqueribeiro1988/roqueos-server:latest
container_name: roqueos-server
restart: unless-stopped
ports:
- '27021:27021'
volumes:
- ./data:/app/data
- /var/run/docker.sock:/var/run/docker.sock
# カスタムディスク:
- /mnt/external-hd/Movies:/app/disks/Movies
- /home/user/Downloads:/app/disks/Downloads
- /home/user/Projects:/app/disks/Projects
environment:
- TZ=Asia/Tokyo設定後
サーバーの再起動
ボリュームを追加または削除して docker-compose.yml を変更するたびに、コンテナを再作成する必要があります:
bash
docker compose down && docker compose up -dフロントエンドでのディスクの確認
サーバーが再起動したら、RoqueOSでファイルマネージャーを開きます。左側のペインに、/app/disks/NAME で選択した正確な名前の新しい仮想ディスクドライブが表示されます。
よくある問題
ファイル編集時の「アクセス拒否」エラー
マッピングされたディスク内でファイルを作成または削除しようとしたときに権限エラーが発生した場合、Dockerコンテナにローカルフォルダへの書き込み権限がありません。ホストサーバーのターミナルで以下を実行します:
bash
# 所有者に対する読み取りおよび書き込み権限
chmod -R 755 /あなたの/ローカル/フォルダへの/パス
# フルアクセスが必要な場合（注意してください）
chmod -R 777 /あなたの/ローカル/フォルダへの/パスファイルマネージャーにディスクが表示されない
以下を確認してください:
- コンテナ内のパスが
/app/disks/で始まっているか - Composeファイルを変更した後、コンテナが再起動されたか
- ホストのパスが存在し、読み取り権限があるか