常见问题 FAQ

按问题所属阶段排查，避免用一个“修复”按钮处理所有错误。

项目与使用#

只能转存到 115 吗？#

不是。目标取决于你在 CloudDrive2 或 OpenList 中挂载并授权的存储。115 是主要测试场景之一；其他存储是否可用，应做真实 WebDAV 和文件测试。

可以自动监听频道吗？#

当前不可以。你手动选择文件并转发给自己的私人 Bot，VPS 自动处理之后的步骤。它不自动爬取频道，也不批量读取频道历史。

必须开 Telegram Premium 吗？#

项目准备清单没有把 Premium 列为必需项。但可获取文件、平台限制和实际速率仍受环境影响。不能因此承诺任何会员权益或固定速度。

2GB 文件一定几分钟上传完吗？#

不能保证。看 Telegram 下载、VPS 网络、WebDAV、网关和云存储的实际瓶颈。速度说明 给出了带单位的理论计算，不是实测成绩。

安装与登录#

Windows 提示未知发布者怎么办？#

v1.0.2 未提供商业代码签名。核对正式 Release、文件名和 SHA-256，不要直接关闭全局安全防护。下载与校验。

VPS 重装后 Host key 不匹配？#

先在服务商控制台核对新指纹，确认身份后使用部署器“更新并重新连接”。不要删除所有服务器记录。SSH 排查。

找不到 OpenList 首次管理员密码？#

已有实例部署后，首次初始化密码不再适用，应使用原管理员凭据；不要把新的本地表单值当成服务端已重置的密码。OpenList 教程。

CloudDrive2 提示没有 FUSE？#

同机受管 CloudDrive2 需要 /dev/fuse。请确认 VPS 虚拟化和服务商支持，而不是反复更改 WebDAV 密码。

管理页与 WebDAV#

本机管理页打不开？#

检查 SSH 隧道、本机端口占用和 VPS 服务状态。CloudDrive2 固定 19798，OpenList 固定 5244。电脑的本地 URL 必须配合隧道使用。

401 与 429 有什么不同？#

401 优先检查运行配置中的 WebDAV 用户名、密码；429 属于限流，避免连续重试加重压力。两者不能用同一种方案处理。WebDAV 排查。

修改部署器密码后还是 401？#

表单变更不等于 VPS 配置变更。重复部署默认保留原 .env，单纯 restart 也不应用新配置。按 修改配置 明确应用后再验收。

“修复 CloudDrive2 网络”能解决上传失败吗？#

只针对适用的容器网络问题，不能修复错误密码、只读权限、未挂载云盘或配额不足。

MOVE 返回成功就通过了吗？#

不能这样判断。v1.0.2 对 OpenList 改为直接写入预留最终路径；CloudDrive2 仍使用临时文件改名后复验。必须看最终验收结果。

任务与数据#

Bot 一直排队？#

先看 /status 是否暂停、目的端是否可达、任务额度和磁盘安全线，再用 /doctor 诊断。传输排查。

为什么暂停后还有传输？#

/pause 只暂停新任务调度，不打断活动任务。暂停状态跨重启保存，恢复用 /resume。

Bot 完成是否代表云盘官方完成？#

不代表。Bot 校验 WebDAV 接收与文件大小，不接入云盘官方完成接口；重要文件需在官方客户端检查内容。

流式模式是不是完全不占磁盘？#

不是。它不留完整本地副本，但网关缓存、日志、Docker 和备份仍占用磁盘。

升级与迁移#

manage.sh update 会下载 GitHub 最新源码吗？#

不会。它主要用已安装 payload 重建；安装新版应使用新版部署器，详见 升级。

TG115 能一键升级 TG2Cloud 吗？#

v1.0.2 不提供原地自动迁移，也没有正式自动 Restore/Uninstall。迁移说明。

CloudDrive2 和 OpenList 可以共用一个 Bot Token 吗？#

不要让两版或新旧实例长期同时使用同一个 Token，否则可能争抢 updates。没有分布式锁替你自动防止这种冲突。