meoacgx
36faff31e1
本次文档调整： - 将「Docker 一键部署」改为 3 步结构（准备项目、选择镜像版本、启动），降低阅读负担。 - 删除重复的「Docker 镜像（只看命令）」docker run 段，避免与 compose 方案混淆。 - 保留稳定版/开发版切换方式（TP_IMAGE）并补充常用 compose 命令（日志、更新、重启、停止）。 - 保持「Docker 一键更新（面板内）」说明独立，部署与更新职责分离更清晰。
Telegram Panel
基于 WTelegramClient 的 Telegram 多账户管理面板（.NET 8 / Blazor Server）。
📚 文档站 | 🏪 API 账号购买 | 🖼️ 截图 | 💬 TG 频道 | 👥 站长交流群
v1.30 重要更新
本次版本主要更新：
- ✨ 废号判定补全：
AUTH_KEY_DUPLICATED（Session 冲突）与SESSION_REVOKED（Session 已撤销）计入废号（影响“只看废号”筛选与清理逻辑） - ✨ 一键清理筛选废号：账号页在勾选“只看废号”后提供“清理废号（筛选）”，按当前筛选结果直接批量清理
- ⚡ 自动同步调度优化：记录上次自动同步时间，避免重启即跑一轮导致限流
- ⚡ 批量任务配置落地：支持保存默认间隔/最大并发/重试开关，并默认更保守（降低风控风险）
- 🐛 日志降噪与限流降速：减少刷屏日志与高频请求
- 📚 新增文档站：更易维护与检索（https://moeacgx.github.io/Telegram-Panel/）
功能概览
- 📥 多账号批量导入/登录：压缩包导入；手机号验证码登录；2FA 密码
- 👥 批量运营能力：批量加群/订阅/退群、批量邀请成员/机器人、批量设置管理员、导出链接等
- 📱 一键踢出其他设备：保留面板当前会话，清理其它在线设备
- 🧹 废号检测与一键清理：封禁/受限/冻结/未登录/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）
第一步：准备项目
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
Docker 一键更新（面板内）
面板已支持在 Docker 部署场景下一键更新（系统设置 -> 应用更新（Docker））：
- 点击“检查更新”，读取 GitHub 最新 Release。
- 点击“一键更新并重启”，自动下载对应架构的 Linux 更新包到
/data/app-current。 - 程序触发重启后，容器会优先从
/data/app-current启动新版本（无需手动docker compose pull）。
说明：
- 当前仅支持 Docker 容器内执行一键更新。
- 更新资产依赖
release.yml工作流产物；若 Release 没有linux-x64/linux-arm64zip 资产，则一键更新会提示不可用。
截图
更多截图见：screenshot/
 |
 |
 |