telegram-search

环境要求

• 已安装 Docker 与 Docker Compose
• 可访问外网下载镜像与配置文件
• 本机 3333 端口未被占用

安装与启动步骤

1. 1创建项目目录

   新建一个空目录，用来存放 Telegram Search 的配置和数据，然后进入该目录。

   mkdir telegram-search
   cd telegram-search

   复制

2. 2下载配置文件

   下载官方 Compose 文件、环境变量示例与初始化 SQL，并把示例保存为 .env。

   curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/docker-compose.yml -o docker-compose.yml
   curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/.env.example -o .env
   curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/init.sql -o init.sql

   复制

3. 3按需改环境变量

   打开 .env 根据自己的需要修改环境变量，不改则沿用默认配置即可。

4. 4启动全部服务

   用 Docker Compose 后台启动应用以及数据库、MinIO 等依赖服务。

   docker compose -f docker-compose.yml up -d

   复制

5. 5单镜像快速运行

   不想用 Compose 时可直接运行官方镜像，未配置 MinIO 时媒体存到本地 data/media。

   docker run -d --name telegram-search -p 3333:3333 ghcr.io/groupultra/telegram-search:latest

   复制

6. 6打开页面使用

   在浏览器访问本机 3333 端口，即可开始导出并检索 Telegram 聊天记录。

关键配置

如何确认成功

浏览器打开 http://localhost:3333 能正常显示页面，即表示服务已启动成功。

常见问题

注意事项

• 本软件仅供导出和检索个人聊天记录使用，切勿用于任何违法用途。
• 项目未发行任何虚拟货币，请警惕相关诈骗风险。
• 配置了 MinIO 时媒体会备份到对象存储，不配置则落到本地 data/media。