简介

CloudDrive2 是一款强大的网盘挂载工具,可以将各类网盘挂载为本地硬盘使用。本教程将介绍如何在极空间 Z4Pro NAS 上通过 Docker 安装 CloudDrive2,并实现 115 网盘的挂载。

准备工作

  1. 一台已经设置好的极空间 Z4Pro NAS

  2. NAS 已经安装 Docker 环境

  3. SSH 客户端工具(如 XTerminal)

安装步骤

1. 开启 SSH 访问

首先需要在极空间 NAS 上开启 SSH 访问:

  1. 打开极空间管理界面

  2. 进入【系统设置】-【远程协助/SSH】

  3. 开启 SSH 服务并设置端口(记住设置的端口号)

2. 通过 SSH 连接到极空间

使用 SSH 工具(如 XTerminal)连接到极空间:

  • 主机:极空间 NAS 的 IP 地址

  • 端口:之前设置的 SSH 端口

  • 用户名和密码:管理员账号和密码

当 SSH 界面显示"ZOS"时,表示连接成功。

3. 获取 ROOT 权限

在命令行界面进行 ROOT 提权:

sudo -i

按照提示输入管理员密码。

4. 拉取 CloudDrive2 镜像

在安装之前,先拉取最新版本的 CloudDrive2 Docker 镜像:

docker pull cloudnas/clouddrive2:latest

5. 安装 CloudDrive2

您可以选择使用 docker-cli 命令或 docker-compose 来部署 CloudDrive2。

方法一:使用 docker-cli 部署

docker run -d \
    --name clouddrive \
    --restart unless-stopped \
    --env CLOUDDRIVE_HOME=/Config \
    -v <path to accept cloud mounts>:/CloudNAS:shared \
    -v <path to app data>:/Config \
    --network host \
    --pid host \
    --privileged \
    --device /dev/fuse:/dev/fuse \
    cloudnas/clouddrive2

注意:需要将 <path to accept cloud mounts>​ 和 <path to app data>​ 替换为您实际的路径。

方法二:使用 docker-compose 部署

创建一个名为 docker-compose.yml​ 的文件,内容如下:

version: "2.1"
services:
  cloudnas:
    image: cloudnas/clouddrive2
    container_name: clouddrive2
    environment:
      - TZ=Asia/Shanghai
      - CLOUDDRIVE_HOME=/Config
    volumes:
      - <path to accept cloud mounts>:/CloudNAS:shared
      - <path to app data>:/Config
    devices:
      - /dev/fuse:/dev/fuse
    restart: unless-stopped
    pid: "host"
    privileged: true
    network_mode: "host"

然后在该文件所在目录下执行:

docker-compose up -d

注意:同样需要将 <path to accept cloud mounts>​ 和 <path to app data>​ 替换为实际路径。

路径配置说明

查找适合的路径

在命令行界面使用 ls​ 和 cd​ 命令探索文件目录,以找到合适的存储位置:

  • ​ls​:列出当前目录下的文件及文件夹

  • ​cd 文件夹名​:进入该文件夹

  • ​cd ..​:返回上级目录

  • ​cd /​:返回根目录

极空间的目录结构

极空间的目录结构通常如下:

  • 以 /data_n​ 为前缀的是固态硬盘,后面跟数字编号

  • 以 /data_s​ 为前缀的是机械硬盘,后面跟数字编号

  • ​/tmp/zfsv3​ 可以理解为各硬盘的映射集合

例如,一个合适的配置路径可能为:

  • 挂载目录:/data_n001/data/udata/real/您的账号/docker/clouddrive2/data​

  • 配置存储目录:/data_n001/data/udata/real/您的账号/docker/clouddrive2/config​

实际配置示例

以下是一个完整的实例配置,包括停止旧容器和使用详细参数重新安装的命令:

# 停止并删除现有的clouddrive2容器
docker stop clouddrive2 && docker rm clouddrive2

# 使用详细参数重新创建容器
docker run -d \
  --name clouddrive2 \
  --restart unless-stopped \
  -p 19798:19798 \
  -v /data_n002/xiaoya:/CloudNAS:shared \
  -v /etc/localtime:/etc/localtime:ro \
  -v /root/.clouddrive:/Config \
  --privileged \
  --device /dev/fuse \
  --cap-add SYS_ADMIN \
  --security-opt apparmor:unconfined \
  --tmpfs /tmp \
  --tmpfs /run \
  --tmpfs /mnt \
  cloudnas/clouddrive2

这个配置示例中:

  • 明确映射了19798端口

  • 将网盘挂载到/data_n002/xiaoya​目录

  • 配置文件存储在/root/.clouddrive​

  • 添加了本地时间同步

  • 包含额外的安全和临时文件系统设置

启用 Docker 服务的 MountFlags

为确保挂载正常工作,需要启用 Docker 服务的 MountFlags:

mkdir -p /etc/systemd/system/docker.service.d/
cat <<EOF > /etc/systemd/system/docker.service.d/clear_mount_propagation_flags.conf
[Service]
MountFlags=shared
EOF
systemctl restart docker.service

使用 CloudDrive2

  1. 安装完成后,通过浏览器访问:http://极空间IP:19798​ 登录 CloudDrive2 界面

  2. 在界面中添加并配置您的网盘账号

  3. 点击小电脑图标挂载网盘

  4. 挂载成功后,您可以在极空间对应账号的"个人空间"中看到挂载的网盘文件

注意事项

  1. 如果 115 网盘中文件过多,CloudDrive2 可能会提示 Request 过多,导致挂载失败

  2. 确保 Docker 是以 systemd service 方式运行的,可以通过 systemctl status docker​ 命令查看

  3. 对于极空间用户,挂载成功后的文件可在"个人空间"中查看

故障排除

如果遇到挂载问题,可以尝试以下方法:

  1. 检查 Docker 状态:systemctl status docker​

  2. 检查 CloudDrive2 容器日志:docker logs clouddrive​

  3. 确保已正确启用 Docker 服务的 MountFlags

  4. 确保所用路径存在且有正确的读写权限


本教程参考了博客园文章《极空间使用 clouddrive2 docker 挂载 115(SSH 版)》,结合实际情况进行了整理和补充。