meoacgx
b58e5f32ac
本次版本主要更新： - 新增 Docker 自动构建工作流：在推送到 dev/main 与发布 tag 时，自动构建 linux/amd64 与 linux/arm64 镜像并推送到 GHCR。 - 新增自动发布工作流：推送 v* tag 后自动创建 GitHub Release，并基于提交自动生成更新日志。 - 新增 release notes 分类规则：按功能、修复、性能、文档等维度整理 changelog，发布说明更清晰可读。 - 补充 README 发布文档：增加镜像命名、标签策略、自动发布触发方式与 changelog 说明，降低后续维护成本。
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 一键部署（推荐）
🐳 面向小白：git clone → docker compose up → 浏览器打开 → 登录改密码 → 配置 ApiId/ApiHash。
环境要求
Docker（Windows 推荐 Docker Desktop + WSL2；Linux 直接装 Docker Engine）
启动
git clone https://github.com/moeacgx/Telegram-Panel
cd Telegram-Panel
docker compose up -d --build
启动后访问：http://localhost:5000
默认后台账号（首次登录）
用户名：admin
密码：admin123
登录后到「修改密码」页面改掉即可。
更完整的安装、更新、导入与生产部署建议：见 https://moeacgx.github.io/Telegram-Panel/ 。
CI 自动构建镜像（GitHub Actions）
已内置工作流：.github/workflows/docker.yml
触发规则：
- 推送到
main/dev：自动构建并推送镜像 - 推送 tag（如
v1.2.3）：自动构建并推送版本镜像 - PR 到
main/dev：只构建验证，不推送
镜像仓库（GHCR）：
ghcr.io/<你的GitHub用户名或组织>/telegram-panel
标签规则：
main分支：latest、main、sha-xxxxxxxdev分支：dev、dev-latest、sha-xxxxxxxv*tag：例如v1.2.3
拉取示例：
# 稳定版
docker pull ghcr.io/<owner>/telegram-panel:latest
# 开发版
docker pull ghcr.io/<owner>/telegram-panel:dev-latest
# 指定版本
docker pull ghcr.io/<owner>/telegram-panel:v1.2.3
自动发布与 Changelog
已内置工作流：.github/workflows/release.yml
触发规则：
- 推送
v*tag（如v1.2.3）后，自动创建 GitHub Release - Release 内容自动生成 changelog（基于提交/PR），并读取
.github/release.yml分类规则
发布示例：
git checkout main
git pull --ff-only origin main
git tag v1.2.3
git push origin v1.2.3
截图
更多截图见：screenshot/
 |
 |
 |