lywsvip/Telegram-Panel

Fork 0

mirror of https://github.com/moeacgx/Telegram-Panel.git synced 2026-05-06 22:12:35 +08:00

Files

root 558fe9e7a3 docs: add bilingual README with English default

2026-03-19 11:09:25 +08:00

7.0 KiB

Raw Permalink Blame History

Telegram Panel

English | 中文

基于 WTelegramClient 的 Telegram 多账户管理面板，使用 .NET 8 与 Blazor Server 构建。

📚 文档站 | 🏪 API 账号购买 | 🖼️ 截图 | 💬 TG 频道 | 👥 站长交流群

项目简介

Telegram Panel 用于在单个 Web 面板中统一管理和运营多个 Telegram 账号，重点覆盖账号生命周期管理、批量运营、频道/群组管理、自动化任务以及模块扩展能力。

功能概览

📥 多账号导入 / 登录：支持 Telethon / TData 压缩包导入导出、手机号验证码登录、2FA 密码处理
👥 批量运营能力：支持批量加群 / 订阅 / 退群 / 启动 BOT，在私密群组自动发送消息养号，批量邀请成员 / 机器人、批量设置管理员、导出链接等
📱 一键踢出其他设备：保留面板当前会话，清理其它在线设备
🧹 废号检测与一键清理：对封禁、受限、冻结、未登录、Session 失效等状态进行批量处理
🔐 2FA 管理：支持单个 / 批量修改二级密码，绑定 / 换绑找回邮箱（支持对接 Cloud Mail 自动收码确认）
👤 账号可见性增强：可在账号列表一键查看已加入的频道和群组，并展示注册时间（基于 777000 系统通知的估算值，非百分百准确）
🧩 模块化扩展：任务 / API / UI 可安装扩展模块（见 docs/developer/modules.md）

近期新增功能

🧠 AI 验证接入：持续活跃任务支持识别验证消息后自动点击按钮或文本作答
⚙️ AI 设置增强：支持 OpenAI 兼容端点、API Key、默认 / 预设模型以及一键连通测试
🔁 AI 稳定性增强：支持配置失败重试次数，AI 决策 / 作答 / 连通测试统一复用
📚 数据字典能力：支持文本字典、图片字典与模板变量
🕒 定时任务能力：新增定时频道 / 群组相关任务（创建、公开等）
🧠 任务中心增强：持续任务支持暂停、编辑、重新运行；任务列表区分执行中与历史任务；支持自动清理
💬 持续活跃任务升级：支持多分类账号、随机文案、秒级发送间隔、持续运行配置
🔄 同步体验优化：手动“立即同步”改为后台任务执行，可在任务中心跟踪进度
👤 账号列表增强：新增注册时间（估算）展示，并可查看账号已加入的频道 / 群组
📺 频道管理升级：频道列表改为“已加入频道”视角，支持多条件筛选与关联账号展示
👥 群组管理补齐：新增群组创建、分类、批量操作与列表能力
🔗 多账号关系可视化：频道 / 群组可绑定多个系统账号，列表与详情可查看关联状态
🚪 真实退出 / 解散能力：频道与群组支持单个 / 批量退出与解散
🧹 数据准确性修正：修复频道列表混入群组的问题，优化关系同步后的展示
♻️ 同步残留清理：同步完成后自动清理失效关联与孤儿记录
⚡ 数据层优化：补充查询与关系索引，提升大量账号 / 频道 / 群组场景下的筛选性能

TODO（规划）

一键退群 / 退订 / 订阅（频道 / 群组）
批量自动签到
一键清空联系人
批量手机号验证码重新登录（用于刷新会话 Session）
手机号注册：未注册号码支持完整注册流程（姓名 / 可选邮箱 / 邮箱验证码等）
通用接码 API：抽象接口 + 主程序只依赖抽象；厂商通过“适配模块”对接（无需改动主程序代码）
支持更换手机号
多代理：支持账号分类绑定代理
多 API：支持账号分类绑定 ApiId / ApiHash
定时创建频道、定时公开频道
定时刷粉丝：对接刷粉 API（通用适配结构），通过适配模块对接多家刷粉平台
群聊定时发言养号

快速开始

Docker 一键部署（推荐）

环境要求：Docker（Windows 推荐 Docker Desktop + WSL2；Linux 直接安装 Docker Engine）

第一步：准备项目

git clone https://github.com/moeacgx/Telegram-Panel
cd Telegram-Panel
cp .env.example .env

第二步：选择镜像版本

默认使用稳定版，无需改动：

TP_IMAGE=ghcr.io/moeacgx/telegram-panel:latest

如果需要开发版，可将 .env 改为：

TP_IMAGE=ghcr.io/moeacgx/telegram-panel:dev-latest

第三步：启动服务

docker compose pull
docker compose up -d

访问：http://localhost:5000

默认后台账号（首次登录）

用户名：admin
密码：admin123

登录后建议尽快前往“修改密码”页面修改默认密码。

常用命令

# 查看日志
docker compose logs -f

# 更新到当前 .env 指定的镜像版本
docker compose pull
docker compose up -d

# 重启 / 停止
docker compose restart
docker compose down

本地开发运行（可选）

适合需要改代码或本地调试的场景（需先安装 .NET 8 SDK）。

dotnet run --project src/TelegramPanel.Web