Telegram 备份：CLI 工具

用命令行工具备份Telegram聊天记录

synchromessotron 工具可将Telegram频道、群组和私聊中的消息、媒体文件及元数据导出至本地存储。所有请求均通过官方Telegram API库以用户身份发起，确保仅访问可见内容。支持Markdown格式便于阅读，也提供JSON格式方便程序解析，媒体文件以原始格式保存。

安装与配置

从GitHub下载发布版本：github.com/vsirotin/synchromessotron/releases。

• 下载您偏好的语言文档（支持俄语）。
• 选择适用于您操作系统的可执行文件：Windows使用telegram-cli.exe，Linux/macOS对应二进制文件。
• 将所有文件放置在同一目录下。
• 启动备份流程，运行命令：

telegram-cli backup

纯命令行界面。如需图形化版本，请关注仓库更新。

安全性与限制

• 数据存储：API ID、API Hash和会话信息本地保存在可执行文件同目录的配置文件中，仅限物理设备访问。删除该文件即可重置。
• 数据传输：所有数据仅通过类似TDLib的调用流向Telegram服务器，不经过任何第三方接口。
• 反滥用限制：严格遵守Telegram的频率限制，模拟真实用户行为，账号被封风险极低。
• 格式支持：文本采用Markdown格式，JSON保留完整结构（含实体、表情反应、回复链），媒体原样保存，无转换。

相比官方桌面客户端导出功能，它支持增量同步、按日期或ID筛选，并可实现脚本自动化。

导出配置

backup 命令默认捕获所有可用内容。支持以下附加选项：

• --chat-id <ID>：指定特定聊天或频道。
• --from-date <YYYY-MM-DD>：从指定日期开始导出。
• --limit <N>：最多导出N条消息。
• --media-only：仅导出媒体文件。

示例：选择性导出部分数据

telegram-cli backup --chat-id @mychannel --from-date 2024-01-01 --limit 5000

JSON输出包含 message_id、date、from_id、reply_to、media（图片/视频/文档）以及带实体（加粗、链接、代码）的文本内容。

与其他工具对比

| 功能 | synchromessotron | 官方导出 | tg-archive |

|--------|------------------|-----------------|------------|

| 图形界面 | 否（仅CLI） | 是 | 否 |

| 增量同步 | 是 | 否 | 部分支持 |

| JSON + Markdown | 是 | HTML/JSON | JSON |

| 频率限制 | 强制执行 | 有限制 | 可能被突破 |

| 媒体导出 | 完整 | 是 | 是 |

特别适合本地数据分析、数据迁移和离线归档。开源项目，采用MIT许可证。

核心优势

• 本地会话存储降低数据泄露风险。
• 严格遵守API速率限制，避免账号被封。
• 双格式输出（Markdown/JSON）兼顾人类可读性与机器处理效率。
• 支持脚本自动化，可设置定时备份。
• 无需额外权限即可访问私密群组和频道。

— Editorial Team