多账号调度
TG Vault 可同时管理多个 Telegram 个人账号,为频道下载和订阅按来源权限、冷却与占用选择账号。调度以文件为单位,不是把一个文件拆给多个账号,也不保证增加账号就提速。
添加与启用
- 在 设置 → Telegram → Telegram Bot 连接 配置 API ID/Hash 等凭据,详见连接与授权。
- 找到 Telegram 用户账号 → 添加账号,选择二维码或手机号登录。扫码入口是 Telegram 设置 → 设备 → 连接桌面设备;手机号须含国家或地区区号,再输入验证码,必要时输入两步验证密码。
- 新绑定账号自动启用。依次添加其他账号,核对账号名与状态;已停用的账号点击 重新启用,就绪后才参与调度。
- 用实际账号确认能读取目标原帖和历史,再提交小范围频道下载或订阅。Bot 认证不能代替来源权限;私有来源通常须自行加入。
停用保留登录凭证;删除账号会删除 TG Vault 保存的凭证,不删除已下载文件。Session 按密码保护,泄露后应在 Telegram 撤销活动会话。
账号怎样分配
普通文件下载采用“权限感知的加权最少连接”:
- 先排除停用、断线、登录失效、冷却未结束、来源明确拒绝或占用已满的账号。
- 已确认可读的账号优先于权限未知的账号;同一权限级别先选空闲账号,再比较
(当前占用 + 1) / 权重,分数低者优先,同负载轮换。 - 合适账号只是忙或冷却时,新请求等待;没有合格账号则报错。
权限按“账号、来源、用途”分别记录,下载、扫描和元信息读取不共用一条结论;记录超过 15 分钟会作为未知重新判断。实体信息缺失不等于权限拒绝,也不会借用其他账号的访问凭据。
权重目前只能查看。 新增账号默认权重为 1;当前 Web 没有编辑控件,也没有公开的权重修改接口,不需要手工改数据库。权重不代表带宽配额或固定分配比例。
文件、扫描与并发
每次文件读取尝试只用一个账号,分片仍属于该账号。短暂网络中断可在同一读取中从已写入位置恢复;可重试网络错误耗尽后可能换账号重新读取文件,这不是跨账号续传或分片加速。FloodWait 不靠换账号重放整文件解除。
扫描优先沿用已分配账号,不可用时再选其他账号,并重新验证来源与检查点可见性。同一账号的扫描串行且限速;扫描与下载分别计占用,但共享账号冷却。因此扫描账号不一定是后来每个文件的下载账号。
设置 → 维护 → 高级任务设置 中,“同时下载文件数”默认 2,可设 1–10,实际最高为 min(10, max(2, 已启用账号数 × 2))。添加账号只提高可设置上限,不自动提高当前并发,也不增加服务器带宽或存储上传额度;单文件分片并发是另一项设置。
查看状态与恢复
账号卡片显示状态、下载中数量、调度权重和所属 DC。下载中不包含扫描;DC 是登录会话的主数据中心,不是用户位置或文件所在 DC。“可用”也不代表已验证所有来源。
FloodWait 按 Telegram 要求等待,冷却对该账号共享;长时间受限且无在途下载时,卡片显示预计恢复新请求时间。普通限流不立即减半下载负载,单次等待达到一小时才降载,后续成功读取逐步恢复。不要反复启停或增加并发规避等待。
个人账号使用独立 worker,后台定期检查并恢复可恢复连接;清理失败的连接会被隔离,不盲目创建替代连接。Bot 断线只恢复 Bot,不重连个人账号。Bot 负责收件、命令与通知,个人账号负责获准的来源读取;登录个人账号不会让它读取 Bot 私聊。
有限排错
| 现象 | 处理 |
|---|---|
| 登录已失效 | 点击 重新登录,使用原 Telegram 账号;完成后核对实际连接状态 |
| 可用但读不到来源 | 用该账号打开原帖与历史,核对私有来源成员身份、内容限制和消息是否存在 |
| 新请求等待或暂时受限 | 查看占用和恢复时间;冷却结束前等待,不靠“继续”解除 |
| 持续异常、无法恢复 | 查看卡片错误及后端账号/worker 日志,排查网络、资源和清理隔离;不要先重启整个后端中断其他下载 |
