部署前准备
准备好一台自己控制的 Linux 主机、可用的 SSH 终端和浏览器、Telegram Bot 配置，以及一个可写的云存储目标。使用一键脚本或独立 Compose 部署。
推荐环境与硬门槛#
| 项目 | 基础建议 | 说明 |
|---|---|---|
| VPS | 2 核 / 4GB 内存 / 50GB SSD | 批量使用可考虑 4 核 / 8GB / 80～100GB |
| 系统 | Debian／Ubuntu、原生 64 位 AMD64／ARM64 用户态 | v1.4.0 统一支持两架构；不等于兼容所有 NAS |
| 登录权限 | 以 root 运行脚本 | 使用自己的 SSH 终端登录主机 |
| 本地设备 | 可用的终端和浏览器 | Windows、macOS、Linux 均可 |
| 网络 | VPS 可达 Telegram、镜像仓库及目的端 | 按实际文件量准备流量 |
| CloudDrive2 | 受管容器需要 /dev/fuse | OpenList Edition 产品配置不要求 FUSE |
公网 VPS 的受管 CloudDrive2/OpenList 还需要一个指向当前 VPS 的独立域名，并允许公网 TCP 80/443 入站。没有可用 IPv6 时不要配置 AAAA；Cloudflare 首次签发证书时使用“仅 DNS”。可信内网使用独立 LAN 入口、私有 IPv4 和 HTTP，不对公网开放。
原生 AMD64 / ARM64#
新源码将 x86_64／amd64 统一为 linux/amd64，aarch64／arm64 统一为 linux/arm64，核对 64 位 Python、dpkg 用户态、本机 rootful Docker 及实际镜像；不安装 QEMU、不接受远端 daemon 或强制平台覆盖。两 Edition 和公网／内网／外部 WebDAV 共用规则，不增加 ARM 专用入口。
v1.4.1 稳定包与匹配线上 helper 已发布核验，两个原生 runner 的 Bot、网关 HTTP／FUSE、扩展依赖、LAN 和外部 DAV 隔离检查均通过。2026-10-21，用户另行提供 Ubuntu26.04.1／原生ARM64／公网NAT 的 CloudDrive2 首装、Bot健康、本机HTTPS与WebDAV验收日志；不将它或CI扩大为OpenList、其他系统、手机外网、升级回退及长期续期已通过。见本次实机记录与双架构说明。
Oracle Ampere A1 的 Ubuntu 24.04／26.04、Debian ARM64 需确认 uname -m 为 aarch64／arm64、getconf LONG_BIT 为 64、dpkg --print-architecture 为 arm64。检查 Docker／Compose 与 /dev/fuse；CloudDrive2 仍需 FUSE 和原权限，OpenList 不要求 FUSE。脚本不会调整 Oracle 安全组或防火墙，真实挂载、HTTPS、转存和回退仍需独立验收。
脚本资源评估要求 CloudDrive2 至少约 1800MB 内存，OpenList 至少约 900MB；此外还要满足任务预算、保留线、Docker 数据盘和 inode 检查。50GB 是推荐磁盘容量，不是唯一硬门槛。首次安装可选推荐预算，最终以实时探测和执行前复检为准。
VPS 信息清单#
准备服务器 IP 或域名、SSH 端口、用户名，以及密码或 SSH 私钥。私钥设有口令时同时准备口令。非 root 用户还需确认 sudo 可用。
首次 SSH 连接应能通过服务商控制台核对主机指纹。不要只因“这是自己的 IP”就忽略指纹变化。
Telegram 信息清单#
| 字段 | 获取或确认方式 |
|---|---|
| Bot Token | 从 Telegram 的 @BotFather 创建或管理自己的 Bot |
| API ID | 在 my.telegram.org 创建应用后获取 |
| API Hash | 与 API ID 配套的应用凭据 |
| Allowed User | 你本人的 Telegram 数字 ID，不是 @用户名 |
详见 Telegram 配置。
云存储与 WebDAV#
云存储的登录、授权和挂载在你自己的 CloudDrive2 或 OpenList 后台完成。准备独立 WebDAV 用户，不要把云盘登录密码当成 WebDAV 密码。
建议先选一个专门的测试文件夹，确认能列目录、上传并删除小文件，再作为正式目标。CloudDrive2 还需要验证改名能力。