Тома (Диски)

Узнайте, как привязать (сопоставить) папки из вашей операционной системы к RoqueOS Server, чтобы они отображались как настоящие диски в файловом менеджере веб-десктопа.

---

Как это работает?

RoqueOS Server работает внутри изолированного Docker-контейнера. В целях безопасности он не имеет автоматического доступа к файлам на вашем компьютере или хост-сервере.

Чтобы файловый менеджер мог просматривать, редактировать и организовывать ваши папки загрузок, документов или медиафайлов, вам нужно «смонтировать» (mount) эти тома в Docker — точно так же, как вы подключаете USB-накопитель.

---

Как настроить

Измените файл docker-compose.yml, добавив строки в раздел volumes:.

Синтаксис:

Путь-на-Вашем-Компьютере : /app/disks/ИмяДиска

ВАЖНОЕ ПРАВИЛО

Путь справа (внутри RoqueOS) всегда должен начинаться с /app/disks/, чтобы файловый менеджер обнаружил папку и отобразил её как диск.

Практические примеры

📁 Документы

# Linux/macOS
volumes:
  - /home/user/Documents:/app/disks/Documents

# Windows
volumes:
  - C:\Users\user\Documents:/app/disks/Documents

🎬 Медиа / Фильмы

# Linux/macOS
volumes:
  - /mnt/external-hd/PlexMedia:/app/disks/Media

# Windows
volumes:
  - D:\PlexMedia:/app/disks/Media

⬇️ Загрузки

# Linux/macOS
volumes:
  - /home/user/Downloads:/app/disks/Downloads

# Windows
volumes:
  - C:\Users\user\Downloads:/app/disks/Downloads

---

Полный пример docker-compose.yml

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=Europe/Moscow

---

После настройки

Перезапуск сервера

Каждый раз, когда вы изменяете docker-compose.yml, добавляя или удаляя том, вам необходимо пересоздать контейнер:

docker compose down && docker compose up -d

Проверка дисков во фронтенде

После перезапуска сервера откройте Файловый менеджер в RoqueOS. Вы увидите новые виртуальные диски в левой панели с тем самым именем, которое вы выбрали в /app/disks/ИМЯ.

---

Частые проблемы

Ошибка "Access Denied" (Доступ запрещен) при редактировании файлов

Если вы получаете ошибку прав доступа при попытке создать или удалить файлы внутри подключенного диска, это означает, что у Docker-контейнера нет прав на запись в локальную папку. В терминале хост-сервера:

# Права на чтение и запись для владельца
chmod -R 755 /путь/к/вашей/локальной/папке

# Если нужен полный доступ (будьте осторожны)
chmod -R 777 /путь/к/вашей/локальной/папке

Диск не появляется в файловом менеджере

Проверьте следующее:

1. Начинается ли путь внутри контейнера с /app/disks/
2. Был ли перезапущен контейнер после изменения файла compose
3. Существует ли путь на хосте и есть ли к нему права на чтение