添加 Telegram 账号

在 TG Downloader 中通过桌面端数据、手机号验证码或二维码添加 Telegram 账号，并正确设置命名空间。

TG-Downloader 不会自己登录 Telegram，下载动作必须使用你已经登录的 Telegram 账号。先进入 账号管理 → 手动添加。

添加面板

命名空间

三种添加方式都要求先填写 命名空间，也就是账号在软件内部的代号。只能使用字母、数字和下划线，不能重复，例如 main_account 或 dl_account_1。

命名空间用于隔离下载任务、监控和缓存，不影响 Telegram 本身。创建后不建议改名。

方式一：桌面端数据登录

电脑上已经登录 Telegram Desktop 时，这是最省事的方法。

  1. 输入命名空间。
  2. 数据路径通常会自动填入 Telegram Desktop 数据目录，也可以手动选择。
  3. 如果 Telegram Desktop 设置了本地锁码，填入本地锁码；没有则留空。
  4. 点 登录。

常见数据位置：

系统默认位置
macOS~/Library/Application Support/Telegram Desktop
Windows%APPDATA%\Telegram Desktop

更详细的 tdata 说明见 导入桌面端账号。

方式二：手机号登录

手机号登录

  1. 输入命名空间和带国家码的完整手机号。
  2. 点 发送验证码。
  3. 输入 Telegram 收到的验证码并点 登录。
  4. 开启两步验证时，再输入 2FA 密码。

方式三：二维码登录

二维码登录

  1. 输入命名空间并点 生成二维码。
  2. 在手机 Telegram 中打开 设置 → 设备 → 关联桌面设备。
  3. 扫描二维码完成登录。

二维码会过期。超时可重新生成，不想继续则点 取消。

大量下载会增加账号被限速的风险，建议使用专门的下载账号，并避免刚登录就进行高频任务。