装好，然后连上第一个云盘

1. 到下载页拿对应架构的安装包（x64 或 Arm64）。
2. 打开安装包，按屏幕上的提示完成安装。
3. 安装完成后，桌面上会出现 CloudDrive2 快捷方式。双击它，或者直接在浏览器里打开 http://localhost:19798。

Windows 7 已停止支持——系统自带的 TLS 和运行库满足不了当前版本的要求。旧设备可以改用 Linux 或 Docker 版本。

1. 确认内核支持 FUSE。看一下 /dev/fuse 这个设备是否存在即可；内核不支持 FUSE 就无法把云盘挂载到本地目录。
2. 如果打算用非 root 用户运行 CloudDrive2，请按所用发行版的手册安装 fuse3，装好后确认 fusermount3 命令可以运行，并编辑 /etc/fuse.conf，把 user_allow_other 这一行前面的注释符 # 删掉。
3. 到下载页拿对应 CPU 架构的压缩包。
4. 打开终端，进入压缩包所在的目录。
5. 展开压缩包：

   tar zxvf clouddrive-2-linux-$ARCH-$VERSION.tgz

6. 进入展开后的目录并运行：

   ./clouddrive

7. 可以把 clouddrive 加入开机自启动，或者注册成系统服务。具体做法请参考所用发行版的文档。

1. Arch Linux 及其衍生版可以通过 AUR 包 或第三方源安装：

   yay -Syu clouddrive

2. 用 systemd 启动 clouddrive 并设为自启：

   # root 权限
   systemctl enable --now clouddrive.service
   
   # 用户权限
   systemctl --user enable --now clouddrive.service

3. 查看 clouddrive 的运行状态：

   # root 权限
   systemctl status clouddrive.service
   
   # 用户权限
   systemctl --user status clouddrive.service

4. 用默认浏览器打开管理界面：

   # 推荐
   xdg-open http://localhost:19798
   
   # IPv4
   xdg-open http://127.0.0.1:19798
   
   # IPv6
   xdg-open http://[::]:19798

5. 如果浏览器打开很慢或者卡顿，改用浏览器的无痕模式访问。
6. 登录后挂载本地磁盘时需要填 UID 和 GID：

   # 当前用户
   id -u
   id -g
   
   # 其他用户
   id -u username
   id -g username

7. AUR 包预设的本地磁盘挂载位置：/media/clouddrive。
8. AUR 包预设的 WebDAV 挂载位置：/media/clouddrive-dav，这个功能依赖 davfs2 包。
9. 把 WebDAV 的用户名和密码写进 /etc/davfs2/secrets，例如：

   cat << EOF | sudo tee -a /etc/davfs2/secrets
   # personal webdav, application password
   /media/clouddrive-dav user@email.com  mypassword
   EOF

10. 用 systemd 启动 clouddrive-dav 并设为自启（root 权限）：

    systemctl enable --now clouddrive-dav.service

11. 查看 clouddrive-dav 的运行状态（root 权限）：

    systemctl status clouddrive-dav.service

用 Homebrew 安装（推荐）

1. 先确认系统里装好了 Homebrew。
2. 运行前必须安装 macFUSE，并在「系统设置」里放行它的内核扩展——Apple 芯片的 Mac 还要先进一次恢复模式，完整步骤见给 macFUSE 放行。也可以用 Homebrew 装：

   brew install --cask macfuse

3. 安装 CloudDrive2：

   brew tap cloud-fs/clouddrive2
   brew install clouddrive2

4. 启动 CloudDrive2：

   brew services start clouddrive2

   启动成功后会自动创建后台服务，下次登录系统时自动运行。
5. 用浏览器打开 http://localhost:19798 进入管理界面。
6. 停止 CloudDrive2：

   brew services stop clouddrive2

7. 卸载 CloudDrive2：

   brew services stop clouddrive2
   brew uninstall clouddrive2

8. 升级 CloudDrive2：

   brew services stop clouddrive2
   brew update
   brew upgrade clouddrive2
   brew services start clouddrive2

手动安装

1. 运行前必须安装 macFUSE，并按给 macFUSE 放行里的步骤授权。
2. 到下载页拿对应 CPU 架构的压缩包。
3. 打开终端，进入压缩包所在的目录。
4. 展开压缩包：

   tar zxvf clouddrive-2-macos-$ARCH-$VERSION.tgz

5. 进入展开后的目录并运行：

   ./clouddrive

6. 可以把 clouddrive 加入开机自启动，或者注册成系统服务，具体做法参考系统文档。

这一节讲的是后台服务。Mac 上还有带播放器的 CloudDrive2 应用，App Store 版与官网直接下载版的差异见 macOS 版。

1. 到下载页的「核心服务」一节拿后缀为 .apk 的安装包，安装后打开即可。它自带 Web 管理界面。
2. 没有 root 的系统无法把云盘挂载到本地文件系统。 其余功能不受影响，多云盘备份、WebDAV 服务等照常可用；没有 root 时还可以走系统的存储访问框架（SAF），支持 SAF 的第三方应用就能直接读写 CloudDrive2 里的文件。

带播放器的 CloudDrive2 应用是另一个安装包，从 Google Play 或下载页的「应用」一节获取。

在 NAS 或服务器上用容器跑，镜像是 cloudnas/clouddrive2。宿主机的挂载传播要是共享的，不少系统默认就开着，怎么查、必要时怎么开，连同可直接复制的启动配置，都见 Docker 部署指南。

群晖与威联通的第三方套件在下载页。

群晖用户请留意：File Station 无法在挂载盘里新建或删除文件，这是群晖侧的已知问题，绕开办法见常见问题。

「我的文件」把所有已连接的云盘并排放在一起，上传、下载、重命名、移动、删除、新建文件夹都是跨云盘的操作，不只是在单个云盘里。列表、网格和瀑布流三种视图，排序、搜索、多选都有。

挂载成本地磁盘之后，这些文件在资源管理器、访达或任何软件里都能像本地文件一样操作。

像在同一个云盘里那样，把文件从一个云盘拖到另一个。先从源云盘取哈希：目标云盘用的是同一套哈希算法、并且命中了，就是真·秒传——服务端直接建一条指向已有数据的记录，数据根本不搬；算法不同或者没命中，就在两朵云之间边下边传，不经过本地磁盘，速度受你的带宽限制。

操作在「我的文件」里：勾中要复制的文件或文件夹，点「移动/复制到...」，在目录树里选好目标，点「复制」。任务在后台运行，无需保持界面打开；进度到「任务」页看，「复制任务」和「上传任务」两个标签下都找得到。

跨云盘快速复制是核心会员功能。慢的那一种情况不是出了问题，是目标云盘那边没有可以命中的现成数据。

在「云存储」页点「添加云存储」，在「本地存储」里选「本地文件夹」，就能把机器上的一个目录加进来当复制的源或目标。只要有一端是本地文件夹，免费账号也能复制——把云盘上的东西拿下来，或者把本地的东西传上去，都不需要会员。

目标是本地文件夹时，任务会出现在「上传任务」里。方向没搞反：CloudDrive2 把复制统一成读源端、写目标端的一条流水线，写的那一半一律叫上传。

跨云盘复制的完整说明

1. 进「备份」页，点「添加备份」，按向导选源目录和一个或多个目标目录。本地文件夹和云盘目录都可以当源，也都可以当目标。
2. 设置文件过滤规则（按扩展名或文件名，可以分别对文件和文件夹生效）和完成规则（例如上传完成后删除源文件）。
3. 备份靠文件系统的实时监控工作：源目录里的改动一发生就同步过去。此外还可以配完整扫描的计划，定期对一遍。

备份全量扫描很吃资源。「备份资源限制」里可以设最大并发扫描数（默认 1）和上传队列的上下限，避免扫大目录时堆出一大堆上传任务。

在任意云盘目录上右键选「创建加密文件夹」，设一个密码。之后往里面放的文件，文件名和内容都在本地加密后再上传——云端存的是密文，服务商看不到原文。解锁之后，读写和普通文件夹没有区别。

不用的时候点「锁定」，下次访问要重新输密码。创建时可以勾「保存密码」，重启后不必再输。

加密文件系统的完整说明

CloudDrive2 会把所有已连接的云盘再以一个 WebDAV 服务对外提供，任何支持 WebDAV 的软件都能连上来。

• 服务器地址：http://<ip>:19798/dav
• 用户名：登录 CloudDrive2 的邮箱；也可以只填邮箱的用户名部分，即 @ 之前的那一段。
• 密码：登录 CloudDrive2 的密码。

核心会员还可以在「WebDAV」页建独立的 WebDAV 用户，各自限定能看到哪个目录、能不能写，不必把主账号密码交出去。

WebDAV 的完整说明

第三方应用可以用 API 令牌访问 CloudDrive2，不必知道你的账号密码。进「API 令牌」页点「创建令牌」，可以限定它能访问的根目录、有效期，以及每一项操作的权限——文件读取、写入、修改、系统操作、云存储操作、账号操作，每一大项下面还能逐条勾。

Emby / Jellyfin 伴侣插件

在支持的云盘目录里点「离线下载」，把磁力链接或 .torrent 文件交给云盘那边去下，下完直接落在云盘里，本地不占带宽也不占空间。.torrent 可以直接拖进来，会被解析成磁力链接后添加。

115 网盘还有一个离线下载管理窗口，可以复制链接、删除任务、重新开始，或者按状态批量清理。

根因是反向代理把 PushMessage 这条 gRPC-Web 长连接给缓冲了，响应头一直不下发，前端就一直等；仪表盘上的任务数也跟着不刷新。在 nginx 里为 CloudDrive2 的转发关掉缓冲、放大读超时即可：

location / {
    proxy_pass http://127.0.0.1:19798;   # 改成你的 CD2 HTTP 端口
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    # 关键：流式 gRPC-Web 必须关闭缓冲
    proxy_buffering off;
    proxy_request_buffering off;
    chunked_transfer_encoding on;
    proxy_set_header Connection "";

    # PushMessage 是长连接，读超时要放大
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
}

这是没有安装 macFUSE。挂载功能依赖它提供 libfuse.2.dylib。到 macfuse.github.io 下载安装，再按给 macFUSE 放行里的步骤在系统设置里允许它的内核扩展——Apple 芯片的 Mac 还要进一次恢复模式。

用你自己的 Google OAuth 凭据就不会被拦：到 Google Cloud Console 新建一个项目，启用 Google Drive API，配置 OAuth 同意屏幕并把自己加为测试用户，然后创建 OAuth 客户端 ID，拿到 client_id 与 client_secret；在 CloudDrive2 里添加 Google Drive 时填进去即可。这样授权走的是你自己的应用。

旧的「115」私有接口已经下线，扫码会成功但连不上。请改用 115open：先移除当前的 115，再添加 115open，然后把它重命名回原来的名字——挂载路径就不会变，已配置的挂载点和备份都不用改。

如果是连不上、报网络错误，那多半是到 115 或天翼登录接口的网络不通，先查 DNS 和代理再重试。

多数时候这是 115 那边的临时限制，不是 CloudDrive2 出了问题。短时间访问太频繁会触发 115 的风控，一般半小时左右自动恢复；下载被卡在几 MB/s 通常是 115 对账号的临时限速，24 小时内恢复。晚间高峰慢、白天正常，也是 115 的策略，改什么设置都没用。

能做的预防：保持默认设置就好，不必调大并发；同一个 115 账号尽量只在一台机器的 CloudDrive2 上用，多台机器同时访问同一账号更容易触发风控。

123 云盘调整过接口地址，老版本的 CloudDrive2 连的还是旧地址。升级到最新版，再重新添加 123 云盘即可。

那是浏览器里还留着第一个账号在网盘官网的登录状态。用无痕（隐私）窗口打开 CloudDrive2 再添加，或者先去网盘官网退出登录，就能登第二个账号了。两个百度网盘、两个 115 都是这么加。

阿里云盘等服务商会对 API 调用限流，超了就返回 too many requests。CloudDrive2 会自动等待并重试直到成功，这类日志不需要处理。它也不会打断挂载盘上的写入：写入先落到本地临时文件，上传在后台异步进行。

按这个顺序排查，多数问题在第一步就能查出来。

1. 服务在不在跑。按 Win+R 打开 services.msc，找 CloudDrive2 Service（服务名 CloudDrive2）。状态应该是「正在运行」，启动类型应该是「自动」。停着就右键启动它；启动类型被改成「手动」或「禁用」的，右键 →「属性」改回「自动」，否则下次开机它不会自己起来。命令行同样能看：

   sc query CloudDrive2

2. 服务在跑，但别的机器连不上。那是 Windows 防火墙没放行端口——核心服务 19798，开了 HTTPS 再加 19799。本机用 http://localhost:19798 能开、别的机器打不开，基本就是这一条。
3. 服务起不来，或者刚起来就停。多半是被杀毒软件拦了。把 CloudDrive2 的安装目录和 WinFSP 一起加进白名单再试。

这是误报。安装包经过代码签名，被检出的 is-XXXX.tmp 只是 Inno Setup 安装器解包时的临时文件，被启发式引擎误判。可以把安装目录和安装包加进杀软白名单，并向厂商提交误报反馈。

装完之后也可能被拦：服务起不来、挂载盘出不来，或者应用被直接关掉。签名齐全也挡不住启发式引擎，把 CloudDrive2 的安装目录和 WinFSP 一并加进白名单即可。

错误里带 dns error、connect error 的，问题都出在运行 CloudDrive2 的那台机器的网络上：查它的 DNS 和代理设置，Docker 部署再查容器网络能不能出外网。管理页面往往是在别的设备上打开的，浏览器能上网不代表跑 CloudDrive2 的机器能上网——测试要在跑服务的那台机器或容器里做，比如 curl 一下报错信息里的那个地址。

这是 Docker 的挂载传播（mount propagation）问题：CloudDrive2 的 FUSE 挂载发生在容器启动之后，默认的传播模式让 Emby 容器看不到后来出现的挂载。给 Emby / Jellyfin 容器的目录映射加上 :rslave 即可，例如 -v /mnt:/mnt:rslave，重建容器后生效。

直链是两个 CloudDrive 之间的机制：远程的 CloudDrive 客户端向服务端请求直接下载地址，数据才不经过服务器。用浏览器打开网页界面访问文件不走直链，流量仍然经过运行 CloudDrive2 的机器。

先查端口：手机与平板应用内置服务的端口是 29798，不是核心服务的 19798。在播放器里填 WebDAV 地址时，用 http://<设备 IP>:29798 再试。

群晖自带的 File Station 不支持在 FUSE 挂载的文件系统上做写操作，这是群晖侧的已知问题，不少用户都碰到过。表现是挂载点进得去、文件看得到也放得了，但新建文件夹、重命名、删除、移动和上传全部失败。

挂载本身没问题：同一个挂载点，用 SSH 或者别的文件管理器读写都正常。

绕开的办法有两个：在 File Station 里改用 CloudDrive2 的 WebDAV 服务连接，不走 FUSE 挂载路径；或者在群晖上换用第三方的文件管理器。同时也建议向群晖反馈这个问题——反馈的人多了才有希望修。

挂载点目录必须是空的。这个错误常见于重启之后：某个也在用这个路径的程序——Emby、下载工具、备份脚本都有可能——比 CloudDrive2 服务先启动，在目录真正被挂载之前往里写了东西，CloudDrive2 就拒绝在非空目录上挂载。

处理：先停掉往里写的程序，把挂载点目录里遗留的文件清走——它们在本地磁盘上，不在云盘里，清之前先看看有没有要保留的——然后重新挂载。要彻底避免，就让依赖这个路径的程序晚于 CloudDrive2 启动：把它的服务设成依赖 CloudDrive2 服务，或者给它加一个延迟启动。

Windows 7 已停止支持，其系统自带的 TLS 和运行库无法满足当前版本对安全连接和依赖的要求。建议在 Windows 10 / 11 上使用；如果必须在旧设备上跑，可以考虑改用 Linux 或 Docker 版本。