🚀 TG-Pilot

Telegram 多账号自动化批量签到任务管理面板

英文 / English · 更新日志 / CHANGELOG · 架构说明 / Architecture · 轻量化 ADR · 反馈问题

---

TG-Pilot 是一款专为高效与稳定性打造的 Telegram 多账号自动化批量签到任务管理面板，你可以轻松管理多个 Telegram 账号，配置自动化签到任务.

✨ 核心特性

• 🎮 多账号矩阵管理：支持单面板统一管理无限个 Telegram 会话账号，随时查看状态。
• ⚙️ 全能动作序列：原生支持「发送文本 / 点击按钮 / 发送特定骰子表情 / 」。
• 📱 隐匿设备伪装和代理配置：自带官方设备指纹伪装（如 MacBook / iPhone），支持为TG账号添加socks5代理，减少账号风控。
• 📈 矩阵批量化任务：支持一键分发任务配置，执行、快捷配置复制。支持多账号一键同步拉齐任务序列。
• 🧠 原生 AI 驱动：配置你的api 和模型，支持AI 智能识图 ， AI 计算解密。
• 🛡️ 运维审计中台 (v3.7-v3.8.2)：设置面板可集中查看调度器任务、账号状态分布、签到运行摘要，并支持更及时的主界面与运维概览同步。
• 🆕 版本更新提醒 (v3.8.2)：主界面可检查上游新版本并显示更新提示，默认跟踪 jikssha/tg-pilot，支持稍后提醒与本次会话关闭。
• 🧪 一键备份同步迁移 (v3.7-v3.8.2)：支持一键导出账号和任务配置全量 ZIP 凭证；当前主线已不再内置旧版本迁移兼容入口，统一面向新版本部署。
• 📦 TG bot通知功能：提供每日任务执行汇报--tg通知，可随时查看任务状态。

---

我们提供了两种主流的 Docker 部署方式。请确保你的环境已安装 Docker。

方法一：Docker Compose (推荐)

1. Fork本项目

确保你的服务器已安装 Docker 和 Docker Compose。

# 创建并进入项目目录
mkdir -p tg-pilot/data && cd tg-pilot

2. 生成配置文件

直接在终端执行以下命令生成标准配置文件：

cat << 'EOF' > docker-compose.yml
services:
  app:
    image: ghcr.io/jikssha/tg-pilot:latest
    container_name: tg-pilot
    restart: unless-stopped
    ports:
      - "9987:9987"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - APP_SECRET_KEY=your_secret_key # ⚠️ 强烈建议修改为复杂的随机字符串
      - TG_SESSION_MODE=string         # 推荐: 纯内存模式，减轻磁盘读写开销
      - TG_SESSION_NO_UPDATES=1        # 推荐: 拒收不相关的群组消息流，大幅降低内存占用
EOF

3. 一键启动

启动完成后，打开浏览器访问：http://服务器IP:9987

方法二：Docker Run

运行以下命令（请根据需要修改 APP_SECRET_KEY）：

docker run -d \
  --name tg-pilot \
  -p 9987:9987 \
  -v $(pwd)/data:/data \
  -e TZ=Asia/Shanghai \
  -e APP_SECRET_KEY=your_secret_key_here \
  -e TG_SESSION_MODE=string \
  -e TG_SESSION_NO_UPDATES=1 \
  --restart unless-stopped \
  ghcr.io/jikssha/tg-pilot:latest

🎉 默认初始凭据：

• 默认账号：admin
• 默认密码：admin123 (请在登录后或通过环境变量及时修改)

---

🔄 如何更新？

cd tg-pilot
docker compose pull
docker compose up -d

🛠️ 进阶配置与环境变量

为了满足不同场景的极致需求，TG-Pilot 开放了丰富的环境变量设置。你可以在 docker-compose.yml 的 environment 节点下进行补充：

变量名	描述	默认值 / 建议
APP_SECRET_KEY	面板 JWT 签名密钥	必填 (务必修改)
ADMIN_PASSWORD	管理员初始密码	admin123
APP_DATA_DIR	核心数据与会话存储路径	面板自动配置 或 /data
TG_SESSION_MODE	TG 会话储存驱动 (file 或 string)	推荐 string，将大幅降低磁盘使用
TG_SESSION_NO_UPDATES	是否拒收群组新消息通信	推荐设为 1，将极大降低内存占用
TG_GLOBAL_CONCURRENCY	任务全局并发请求数限制	默认 1
APP_TOTP_VALID_WINDOW	2FA 双重验证的时间容错窗口	-

(详细反代说明：如果你使用 Nginx，建议将端口映射改为 - "127.0.0.1:9987:9987"，阻断外部直连，提升安全性。)

📜 更新日志

详细的版本演进记录请参阅：CHANGELOG.md

📂 项目架构

项目采用前后端分离的主流现代技术栈：

• Frontend: Next.js 14, React, Tailwind CSS, Phosphor Icons
• Backend: FastAPI, Uvicorn, SQLite
• Core Engine: Pyrogram / Kurigram (Telegram 协议), APScheduler, OpenAI SDK

当前产品主线与兼容策略如下：

• 产品入口：frontend + backend
• 执行内核与 CLI 兼容层：tg_signer

更多约束与阶段门禁请参阅：

• 架构说明
• 轻量化 ADR
• 阶段门禁

🛡️ 数据与安全申明

默认情况下，所有的 Telegram 账号信息、登录会话 (.session)、定时任务以及私密配置均储存在你挂载的 ./data 本地目录中。TG-Pilot 不会向任何未授权的第三方外部服务器回传敏感数据。

---

由 jikssha 精心打造

提交 Issue · Pull Requests