跳到正文
文档/部署与配置

磁盘、资源与并发 ​

磁盘占用 ​

除实际文件外,还需预留下载暂存、待上传文件、分片合并、预览/转码、BT 副本、数据库、镜像和备份空间。远端存储不代表服务器无需磁盘。

bash
df -h
df -i
docker system df

同时检查容量和 inode,不直接删任务目录或用 prune --volumes 腾空间。

默认保护值 ​

配置默认说明
TG_MIN_FREE_DISK_GB8 GiBTelegram 下载保留空间
TG_DISK_WATERMARK_RECHECK_MS30 秒空间不足后的复查间隔
TG_DISK_WATERMARK_MAX_WAIT_MS0默认无空间等待总超时
MAX_UPLOAD_CHUNK_MB32 MiB单分片上限
MAX_CHUNK_UPLOAD_GB20 GiB单分片会话总量上限
CHUNK_GLOBAL_BUDGET_GB40 GiB全局分片预算,不小于单会话上限
CHUNK_DISK_RESERVE_GB8 GiB分片保留空间
CHUNK_SESSION_TTL_MS24 小时分片会话有效期

已有部署可能覆盖默认值。浏览器以服务端实时能力为准;反代请求体限制和应用上传预算是两层设置。

下载并发 ​

入口:设置 → 维护 → 高级任务设置。

设置默认与范围Bot 命令
单文件分片并发默认 4;4/6/8/10/12,10/12 需确认/download_workers
同时下载文件数默认 2;1–10,实际上限 min(10, max(2, 启用账号数 × 2))/file_concurrency

Telegram 文档使用 1 MiB 单次请求,一个文件不跨账号分片。提高并发会增加内存和在途数据,不保证提速。

下载槽与上传阶段分开;等待上传不占下载槽,但仍占暂存空间。默认值下先观察磁盘、内存、网络和目标速度,一次只改一项。

FloodWait 只能等待,“继续”不能解除。单次等待达到 1 小时会减半降载,成功读取后逐步恢复。

备份空间 ​

协调备份预检需要目标至少能容纳 未压缩 /data + 数据库大小 + 512 MiB。建议备份到另一块盘并加密异地保存。远端对象、下载器配置和外部 BT 目录另行备份。