从零开始部署

按下面的顺序完成第一次安装。先部署基础环境，再挂载云存储，最后做真实写入验收；不要把其中一个阶段的成功当成整个流程已经完成。

第一步：下载并检查文件#

进入 下载与校验，选择对应 Edition 的 EXE，同时下载同一 Release 中的 SHA256SUMS.txt。在 Windows PowerShell 计算 EXE 的 SHA-256，与清单中的相应条目逐字符比较。

不要把别的版本的校验值用于当前文件，也不要为了运行程序关闭安全软件。

第二步：连接自己的 VPS#

打开部署器，填写服务器地址、SSH 端口、用户名和登录方式。点击 “测试 SSH”；第一次连接时，通过服务商控制台核对显示的主机指纹，再确认连接。

SSH 成功后读取资源。连接失败先处理 SSH 问题，不要反复点击部署。

第三步：配置 Telegram#

填写 Bot Token、API ID、API Hash 和本人数字 ID。四项用途不同，不能互相替代。

确保没有旧 Bot 实例使用同一个 Token 运行。TG2Cloud 只处理允许用户的一对一私聊。

第四步：设置网关与任务预算#

CloudDrive2 同机受管安装保持默认内网 WebDAV 地址，预先选定专用用户名和密码。OpenList 根据“配置 WebDAV”页记录本次生成的用户凭据。

点击 “检测 VPS 并推荐”，按需求主动选择均衡值或流式优先值。确认安装目录、本地任务预算和磁盘最少保留，再继续。

第五步：部署基础环境#

点击 “一键部署基础环境”，观察日志，等部署器明确报告成功。构建或拉取镜像期间，不要重复点击部署、网络修复或验收。

此阶段检查 Bot、网关和网络健康。尤其 OpenList 首次安装时，尚未挂载云盘或创建 WebDAV 用户，并不自动意味着基础部署失败。

第六步：打开管理页，挂载自己的存储#

在管理页内完成登录、存储授权、目标目录和 WebDAV 用户设置。这些地址依赖当前 SSH 隧道，不是独立的公网网址。

CloudDrive2 创建与部署器完全一致的 WebDAV 用户，取消只读并确认读写、改名、删除权限。OpenList 创建专用普通用户，确认列表、读取、写入和删除权限。

第七步：WebDAV 真实验收#

回到部署器，点击 “WebDAV 验收”。只有出现下面的标记才说明整体验收通过：

TG2CLOUD_DESTINATION=OK

CloudDrive2 验收包含临时写入、改名及复验；OpenList 当前采用最终路径直接写入，不依赖 MOVE。失败时看第一处失败阶段，不要只看最后一行错误。

第八步：发送第一个测试文件#

与自己的 Bot 私聊，先发一个有权保存的 5～20MB 小文件。记下任务编号，用 /queue、/task 编号 和 /status 观察处理。

Bot 完成后，在所用云存储的官方客户端确认文件位置、大小与可打开性。随后再测试普通落盘文件、流式文件及测试任务取消。

首次部署完成清单#

1. SSH 主机身份已核对，资源检查已通过。
2. Bot 仅允许本人数字 ID 使用。
3. 网关已经挂载存储，专用 WebDAV 用户具备实际写入权限。
4. 出现 TG2CLOUD_DESTINATION=OK。
5. 小文件完整传输，目的端文件位置和内容符合预期。
6. 明白“Bot 完成”与云盘官方最终状态的区别。

日常用法见 Bot 命令速查，故障按 FAQ 分类处理。