# Telegram Panel 基于 **WTelegramClient** 的 Telegram 多账户管理面板(.NET 8 / Blazor Server)。
📚 文档站 | 🏪 API 账号购买 | 🖼️ 截图 | 💬 TG 频道 | 👥 站长交流群
## 功能概览 - 📥 多账号批量导入/登录:支持 Telethon/TData 压缩包导入导出;手机号验证码登录;2FA 密码 - 👥 批量运营能力:批量加群/订阅/退群/启动BOT、批量在私密群组自动发送消息养号/批量邀请成员/机器人、批量设置管理员、导出链接等 - 📱 一键踢出其他设备:保留面板当前会话,清理其它在线设备 - 🧹 废号检测与一键清理:封禁/受限/冻结/未登录/Session 失效等状态批量处理 - 🔐 2FA 管理:单个/批量修改二级密码;绑定/换绑找回邮箱(支持对接 Cloud Mail 自动收码确认) - 🧩 模块化扩展:任务 / API / UI 可安装扩展(见 `docs/developer/modules.md`) ## TODO(规划) - [ ] 一键退群/退订、订阅(频道/群组) - [ ] 一键清空联系人 - [ ] 批量手机号验证码重新登录(用于刷新会话 session) - [ ] 手机号注册:未注册号支持完整注册流程(姓名/可选邮箱/邮箱验证码等) - [ ] 通用接码 API:抽象接口 + 主程序只依赖抽象;厂商通过“适配模块”对接(无需改动主程序代码) - [ ] 支持更换手机号 - [ ] 多代理:支持账号分类绑定代理 - [ ] 多 API:支持账号分类绑定 ApiId/ApiHash - [ ] 定时创建频道、定时公开频道 - [ ] 定时刷粉丝:对接刷粉 API(通用适配结构),通过适配模块对接多家刷粉平台 - [ ] 群聊定时发言养号 ## 快速开始 ### Docker 一键部署(推荐) 环境要求:Docker(Windows 推荐 Docker Desktop + WSL2;Linux 直接装 Docker Engine) #### 第一步:准备项目 ```bash git clone https://github.com/moeacgx/Telegram-Panel cd Telegram-Panel cp .env.example .env ``` #### 第二步:选择镜像版本 默认是稳定版(无需改动): ```bash TP_IMAGE=ghcr.io/moeacgx/telegram-panel:latest ``` 如果你要开发版,改 `.env` 为: ```bash TP_IMAGE=ghcr.io/moeacgx/telegram-panel:dev-latest ``` #### 第三步:启动 ```bash docker compose pull docker compose up -d ``` 访问:`http://localhost:5000` #### 默认后台账号(首次登录) 用户名:`admin` 密码:`admin123` 登录后到「修改密码」页面改掉即可。 #### 常用命令 ```bash # 查看日志 docker compose logs -f # 更新到当前 .env 指定的镜像版本 docker compose pull docker compose up -d # 重启 / 停止 docker compose restart docker compose down ``` ### 本地开发运行(可选) > 适合需要改代码或本地调试的场景(需先安装 .NET 8 SDK)。 ```bash 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
[](https://star-history.com/#moeacgx/Telegram-Panel&Date)