账号导入教程

📋 功能介绍

账号导入功能支持批量导入 Telegram 账号数据，系统会自动识别账号格式、提取账号信息并进行分类管理。

支持的账号格式

Session 格式：支持 Telethon/Pyrogram 生成的 .session 文件
TData 格式：支持 Telegram Desktop 的 tdata 文件夹
混合格式：同一个账号可以同时包含 Session 和 TData

支持的压缩格式

系统支持多种压缩格式：.zip、.rar、.7z、.tar、.tar.gz

📦 文件结构

系统支持两种文件组织结构，您可以选择任意一种：

方式一：传统结构（推荐）

data.zip
├── 12254516925/           # 手机号作为文件夹名
│   ├── 12254516925.session
│   ├── twoFA.txt          # 2FA密码文件（可选）
│   ├── 12254516925.json   # 账号信息文件（可选）
│   └── tdata/             # tdata文件夹（可选）
├── 13800138000/
│   ├── 13800138000.session
│   └── twoFA.txt
└── 15912345678/
    └── 15912345678.session

方式二：扁平结构

data.zip
├── 12254516925.session
├── 12254516925.json       # 账号信息文件（可选）
├── 13800138000.session
├── 13800138000.json
└── 15912345678.session

⚠️ 文件命名规则：

Session 文件名必须是 手机号.session
JSON 文件命名格式为 手机号.json
TData 文件夹必须命名为 tdata
2FA 密码文件命名为 twoFA.txt 或 2fa.txt

🚀 操作步骤

准备账号文件
按照上述文件结构要求，将账号文件打包成压缩包。确保文件命名规范，避免导入失败。
进入账号管理页面
点击系统左侧菜单的"账号管理"或"API 数据"进入账号管理页面。
点击导入按钮
找到页面右上角的"导入账号"或"上传文件"按钮并点击。
选择压缩包文件
点击"选择文件"按钮，从本地选择准备好的账号压缩包。
提示：单次建议不超过 1000 个账号
配置导入选项
• 国家/地区：选择账号所属国家（如：中国、美国、印度等）
• 分类标签：为账号添加分类标签，便于后续筛选管理（可选）
开始上传
点击"开始上传"或"确认导入"按钮，系统开始处理账号数据。
处理时间取决于账号数量，请耐心等待
查看导入结果
导入完成后，系统会显示成功导入的账号数量和失败信息。
在账号列表中可以看到新导入的账号及其详细信息。

📊 账号信息说明

系统会自动提取并显示以下账号信息：

字段	说明	来源
Token	系统生成的唯一标识符	自动生成
手机号	Telegram 账号的手机号码	从文件名或 Session 中提取
用户名	Telegram 用户名（@username）	从账号信息中读取
姓名	First Name + Last Name	从账号资料中提取
状态	正常/未检测/已失效	初始为"未检测"
分类	账号分类标签	导入时手动设置
国家	账号所属国家/地区	导入时手动选择
上传者	导入该账号的用户	当前登录用户

🖼️ 页面示例

导入成功后，账号会集中展示在列表中，并且可以直接在界面右上角执行常用批量操作。

账号列表展示导入后的全部账号，包含手机号、用户名、分类、状态等关键信息，便于后续筛活或批量任务。

通过列表右上角的操作菜单可以批量导出、批量删除、按标签过滤，快速完成账号整理与维护。

⚠️ 常见问题

Q1: 导入失败，提示"无效的文件格式"？

解决方法：

检查压缩包格式是否支持（zip、rar、7z、tar、tar.gz）
确保压缩包内的文件结构正确
Session 文件名必须是 手机号.session 格式
压缩包不能为空或损坏

Q2: 部分账号导入成功，部分失败？

可能原因：

失败账号的 Session 文件可能已损坏
文件命名不规范（如缺少 .session 后缀）
TData 文件夹内容不完整
手机号格式不正确

建议：检查失败账号的文件完整性，修正后重新导入

Q3: 导入后账号状态显示"未检测"？

说明：
这是正常现象。导入时系统不会立即验证账号状态，需要使用 "账号筛活" 功能进行检测。这样可以加快导入速度，您可以在导入完成后统一进行筛活检测。

Q4: 可以导入多少个账号？

说明：
理论上没有数量限制，但为保证处理速度和系统稳定性：

建议单次导入不超过 1000 个账号
大量账号建议分批导入
确保服务器有足够的存储空间

Q5: 如何批量添加分类标签？

方法：
导入后，您可以在账号列表中：

勾选多个账号
使用"批量操作"功能
选择"修改分类"设置统一标签

💡 最佳实践

备份原始文件：导入前务必备份原始账号文件，避免数据丢失
规范命名：严格按照命名规则准备文件，提高导入成功率
合理分类：使用有意义的分类标签（如：营销号、测试号、VIP号），方便后续管理
立即筛活：导入后立即进行账号筛活，及时发现失效账号
定期整理：定期清理失效账号，保持账号库整洁
分批导入：大量账号分批导入，避免一次性导入导致系统压力过大
记录信息：记录每批账号的来源、用途等信息，便于追溯

🔗 下一步操作

账号导入完成后，建议您：

✅ 账号筛活 - 检测账号可用性，筛选出正常账号
🧹 账号清理 - 清理账号对话和联系人，保持账号清洁
🔒 隐藏手机号 - 设置隐私保护，隐藏手机号码
🔑 TGAPI 生成 - 为账号生成 TGAPI 数据

📥 账号导入