Docker绑定挂载Rclone目录在Nextcloud容器内不显示问题

• 操作目标：通过Rclone将云存储桶挂载到宿主机/home/user/rclone目录，供Docker部署的Nextcloud实例访问，最初方案为将该目录绑定挂载到容器内/var/www/html/data路径，添加shared挂载选项预期实现宿主机与容器的文件修改双向同步。
• 基础状态：宿主机侧已将/home/user/rclone目录权限设置为777，在宿主机执行ls可正常查看目录内所有文件，Rclone服务运行状态正常。
• 故障表现：重启Docker容器后，在容器内执行ls查看对应挂载路径无法显示任何文件。
• 初步排查：最初怀疑命名卷nextcloud挂载到/var/www/html路径时，覆盖了下层/var/www/html/data的绑定挂载，因此更换挂载目标为容器内/mnt路径重新测试，执行ls依然无法显示任何文件。

注：MySQL服务配置与本次问题无关，以下为/var/www/html/data挂载版本的完整配置：

version: '2'

volumes:
  nextcloud:
  db:

services:
  db:
    image: mariadb
    restart: always
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
    volumes:
      - db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=xxx
      - MYSQL_PASSWORD=xxx
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
    network_mode: npm_default
    container_name: db

  app:
    image: nextcloud:latest
    restart: always
    links:
      - db
    volumes:
      - nextcloud:/var/www/html
      - /home/user/rclone:/var/www/html/data:shared
    environment:
      - MYSQL_PASSWORD=xxx
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_HOST=db
      - NEXTCLOUD_TRUSTED_DOMAINS=xxx
    network_mode: npm_default
    container_name: nextcloud

整体数据访问链路为：rclone 云存储 --> 宿主机 --> Docker --> Nextcloud 外部存储

• Rclone基于FUSE实现用户态文件系统挂载，默认挂载参数禁止挂载点所有者之外的用户访问，即便目录权限手动设为777，Docker daemon及容器内进程也无权读取FUSE挂载点内的内容。
• Docker绑定挂载的解析时机为容器启动瞬间，如果容器启动时/home/user/rclone路径还未完成Rclone挂载（比如Rclone开机自启顺序晚于Docker服务），容器会直接挂载该路径下的底层空目录，后续Rclone挂载完成后容器内也无法感知上层挂载内容；shared挂载选项仅对目录内后续产生的新挂载事件做传播，无法解决初始挂载点为空的问题。
• 直接将外部存储挂载到Nextcloud的/var/www/html/data路径不符合Nextcloud目录设计规范，该目录用于存储Nextcloud自身的用户数据、元数据文件，直接挂载外部存储会覆盖原有目录结构，额外引发服务异常。

1. 调整Rclone挂载权限：修改Rclone挂载命令，追加--allow-other参数，允许所有系统用户（包括Docker服务进程）访问FUSE挂载点内容；同时编辑宿主机/etc/fuse.conf文件，去掉user_allow_other配置行前的注释符，开启普通用户挂载FUSE时的其他用户访问权限。
2. 调整服务启动顺序：确保宿主机上Rclone存储桶挂载完成后，再启动Nextcloud容器。如果是开机自启场景，给Nextcloud的启动配置添加对Rclone挂载服务的依赖，避免容器启动时挂载点为空。
3. 修正容器挂载路径：不要将Rclone目录挂载到/var/www/html/data，修改docker-compose的volumes配置段，将Rclone目录挂载到容器内独立路径，示例配置如下：

   volumes:
     - nextcloud:/var/www/html
     - /home/user/rclone:/mnt/rclone_storage:shared,rbind
   

4. 配置Nextcloud外部存储：重启容器后登录Nextcloud后台，在「外部存储」配置项中添加本地存储类型，路径填写容器内的/mnt/rclone_storage，配置对应访问用户组权限后即可正常读写文件。

内容的提问来源于stack exchange，提问作者user14417149