卷（磁盘）

了解如何将操作系统中的文件夹映射到 RoqueOS 服务器，使它们在 Web 桌面的文件管理器中显示为真实的物理磁盘。

---

它是如何工作的？

RoqueOS 服务器在一个隔离的 Docker 容器中运行。出于安全原因，它不能自动访问您的计算机或主机服务器上的文件。

为了让文件管理器能够查看、编辑和整理您的下载、文档或媒体文件夹，您需要在 Docker 中“挂载”这些卷 —— 就像插入 USB 驱动器一样。

---

如何配置

通过在 volumes: 部分添加行来修改 docker-compose.yml 文件。

语法：

您的计算机上的路径 : /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=Asia/Shanghai

---

配置之后

重启服务器

每次更改 docker-compose.yml 以添加或删除卷时，您都需要重新创建容器：

docker compose down && docker compose up -d

在前端验证磁盘

服务器重启后，在 RoqueOS 中打开 文件管理器。您将看到新的虚拟磁盘驱动器出现在左侧窗格中，名称正好是您在 /app/disks/NAME 中选择的名称。

---

常见问题

编辑文件时出现“访问被拒绝”(Access Denied)错误

如果您在尝试在映射的磁盘内创建或删除文件时收到权限错误，说明 Docker 容器没有向本地文件夹写入的权限。在主机服务器的终端中运行：

# 给予所有者的读取和写入权限
chmod -R 755 /您的/本地/文件夹/路径

# 如果需要完全访问权限（请小心操作）
chmod -R 777 /您的/本地/文件夹/路径

磁盘未显示在文件管理器中

请检查以下几点：

1. 容器内的路径是否以 /app/disks/ 开头
2. 在修改 compose 文件后，容器是否已重启
3. 主机上的路径是否存在且具有读取权限