2026.10.21

Telegram Archive:把 Telegram 历史记录保存在自己的服务器上

Telegram Archive 面向希望长期保存 Telegram 消息与媒体的个人、家庭实验室和小型团队,提供增量备份与本地网页查看器。但它不支持秘密聊天,且查看器没有离线模式,部署前需要认真规划凭据、存储与访问控制。

项目用途

Telegram Archive 是一个面向自托管场景的 Telegram 归档工具。它可以把一个或多个 Telegram 账号的数据备份到你管理的机器上,支持 Docker 或 Python 包方式运行,消息与媒体保存到本地磁盘,数据库可选择 SQLite 或 PostgreSQL。项目采用 GPL-3.0-or-later 许可证,并提供 amd64 与 arm64 镜像。

它的核心价值不只是导出一份文件。项目会持续运行增量备份和定期完整检查,保存消息、媒体、编辑记录与删除记录;查看器还能展示较早版本,并提供“发生了什么变化”的信息流。网页界面用于读取归档,不会直接访问 Telegram,因此适合把备份端和阅读端分开考虑。

Telegram-Archive 项目截图 1

图片来源:Telegram-Archive。项目公开截图,界面可能随版本变化。

适合哪些人

它适合希望掌握数据存放位置的个人用户、家庭实验室使用者、研究或合规留档人员,以及需要集中管理多个 Telegram 账号的人。若你需要在手机或浏览器中搜索旧对话、浏览共享媒体,或追踪编辑和删除记录,内置查看器会比手工处理导出文件更方便。

不过,面向普通家庭成员或外部协作者共享时,应先理解权限模型。项目支持为指定聊天设置其他登录用户或分享链接,但这些能力会扩大归档的访问面,不能替代反向代理、身份认证和网络隔离等运维措施。

已知功能

项目可保存格式化消息、回复、转发、反应、置顶消息、投票、服务消息、论坛主题、文件夹、归档聊天和头像历史。照片、视频、语音、贴纸、文档及链接预览等媒体可保存,并对重复文件进行复用;超过设定大小的文件可以跳过。语音消息还可交给你配置的转写服务器,形成可搜索文本。

查看器支持跨聊天搜索、共享媒体浏览、主题切换、实时更新和浏览器通知。项目也支持导入 Telegram Desktop 导出文件,以及在一个归档中管理多个账号。官方说明查看器仅支持英文,没有离线模式。

采用前的限制与部署考虑

首先,项目不会保存秘密聊天,也不能恢复首次备份之前已经删除的消息。因此它更适合作为持续运行的归档系统,而不是事后抢救工具。备份端需要 Telegram 的 API 凭据和账号登录流程;这些凭据、会话文件、数据库及媒体目录都应纳入主机权限控制和备份计划。

其次,媒体会显著增加存储需求。项目默认会跳过超过 100 MB 的文件,具体策略可配置;正式部署前应估算聊天数量、媒体保留范围、数据库增长和异地备份空间。若使用 PostgreSQL,还要额外管理数据库服务;使用 SQLite 则应关注文件备份的一致性。

隐私边界也需要审查。归档默认保存在自己的磁盘,但启用语音转写、事件 webhook 或完整 Web Push 通知后,部分音频、消息文本或通知内容会发送到你配置的外部服务。查看器若暴露到公网,应结合官方的安全暴露文档配置访问控制,而不是直接把端口开放给互联网。

截至提供的官方 v9.3.6 release,项目包含一次证书信任相关的安全更新,Docker 部署需要使用更新后的镜像。升级前仍应阅读变更记录,并先备份归档。

资料来源

资料核对日期:2026-10-21