Telegram Panel

基于 WTelegramClient 的 Telegram 多账户管理面板（.NET 8 / Blazor Server）。

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

功能概览

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

近期新增功能

• 🧠 任务中心增强：持续任务支持暂停、编辑、重新运行；任务列表区分执行中与历史任务；支持“仅清理历史任务”与“历史任务保留上限”自动清理
• 💬 持续活跃任务升级：新增账号持续活跃（群组/频道）能力，支持多分类账号、随机文案、秒级发送间隔、持续运行配置
• 🔄 同步体验优化：手动“立即同步”改为后台任务执行，可在任务中心跟踪进度；同步链路补充超时保护与状态持久化
• 👤 账号列表增强：新增注册时间（估算，非百分百正确）展示，并可直接从账号操作中查看该账号已加入的频道和群组
• 📺 频道管理升级：频道列表改为面向“已加入频道”视角，不再只显示系统创建频道；支持按账号、角色、分类筛选，支持查看频道内的本系统账号
• 👥 群组管理补齐：新增群组创建页、群组分类、批量操作与列表能力补齐；群组列表同样支持按账号、角色、分类筛选，并支持查看群组内的本系统账号
• 🔗 多账号关系可视化：同一频道/群组可绑定多个系统账号，频道/群组列表与详情页都可查看当前关联的系统账号、角色与状态
• 🚪 真实退出/解散能力：频道与群组支持单个/批量退出；支持解散频道/群组，且解散前需后台密码确认
• 🧹 数据准确性修正：修复频道列表混入群组的问题，并优化账号、频道、群组关系同步后的本地展示逻辑
• ♻️ 同步残留自动清理：同步完成后自动清理失效关联、创建者残留和孤儿频道/群组记录，避免数据库持续臃肿
• ⚡ 数据层优化：补充频道/群组查询与关系索引，提升几百账号、上千频道/群组场景下的筛选与加载性能

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

访问：http://localhost:5000

Docker 一键更新（面板内）

面板已支持在 Docker 部署场景下一键更新（左上角版本号 -> 版本信息弹窗）：

1. 点击“检查更新”，读取 GitHub 最新 Release。
2. 点击“一键更新并重启”，自动下载对应架构的 Linux 更新包到 /data/app-current。
3. 程序触发重启后，容器会优先从 /data/app-current 启动新版本（无需手动 docker compose pull）。

说明：

• 当前仅支持 Docker 容器内执行一键更新。
• 更新资产依赖 release.yml 工作流产物；若 Release 没有 linux-x64/linux-arm64 zip 资产，则一键更新会提示不可用。

截图

更多截图见：screenshot/

⭐ Star History