diceandink/telegram-vault

**实时情报记录** 通过 WebSockets 进行实时消息流传输，支持动态搜索、上下文提取和高性能过滤。 **分析仪表板** 通过交互式可视化提供具有指导意义的情报，包括 KPI、消息速率图表、活跃用户和目标分析。 ## 核心功能 - **高性能流传输：** 通过 Telethon 进行非阻塞异步消息解析。 - **WebSocket 推送：** 即时向已连接的客户端推送新日志和删除消息警报。 - **数据持久化：** 基于 SQLAlchemy 异步引擎构建，原生支持 PostgreSQL。 - **清晰的架构：** 模块化路由、强大的速率限制、安全的身份验证以及 hCaptcha 集成。 ## 安装与设置 **1. 前置条件** - Python 3.9+（推荐 3.12） - PostgreSQL Server - Telegram API ID 和 API Hash（从 [my.telegram.org](https://my.telegram.org) 获取） **2. 克隆与安装** *Windows:* ``` python -m venv venv venv\Scripts\activate pip install -r requirements.txt ``` *Linux / macOS:* ``` python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ``` **3. 配置环境** 将 `.env.example` 复制为 `.env` 并配置您的部署凭据： ``` API_ID=your_api_id API_HASH=your_api_hash DATABASE_URL=postgresql+asyncpg://user:password@localhost/telegramlogs PHONE_NUMBER=+1234567890 DASHBOARD_PASSWORD=your_secure_password ``` **4. 准备数据库** ``` CREATE DATABASE telegramlogs; ``` **5. 启动系统** *Windows:* 使用提供的批处理脚本进行简化的启动操作： ``` start.bat ``` *Linux / macOS:* 您可以使用 `tmux`、`screen` 或在后台运行它们： ``` source venv/bin/activate uvicorn app:app --host 0.0.0.0 --port 8000 & python3 bot.py & ``` ## 项目结构 ``` ├── app.py # FastAPI Application (Main Entry) ├── bot.py # Telethon Userbot Listener ├── config.py # Environment Variables loader ├── database.py # SQLAlchemy ORM Models ├── start.bat # Multi-process Launcher ├── routes/ # Core Backend Logic │ ├── auth.py # Authentication & Rate Limiting │ ├── dashboard.py # Analytics Engine │ ├── messages.py # Log Search & API │ └── websocket.py # Real-Time WebSocket Broadcaster ├── middleware/ # Custom Middlewares (e.g. Security Headers) ├── templates/ # Jinja2 HTML Views └── static/ # Assets (CSS, JS, Logo, Screenshots) ```

标签：AV绕过, ESC4, FastAPI, OSINT, Telegram, 代码示例, 后端开发, 安全研发, 数据分析, 测试用例, 网络情报, 逆向工具