Skip to content

TGBotPress 项目展示动画

TGBotPress ​

项目介绍 ​

TGBotPress 是面向 Telegram Bot 的模块化管理基座,以「基座 + 模块插件 + 插件市场」为发展方向。基座提供管理后台、数据库、机器人管理和插件生命周期等公共能力,开发者可以围绕业务模块组织代码,减少重复开发。

项目采用 Apache License 2.0 开源,适合需要管理多个机器人业务或开发 Telegram Bot 模块的团队和开发者。

项目特点 ​

  • 模块化管理:将群组、商城、监控等业务按模块组织和管理。
  • 机器人管理基座:围绕机器人配置、消息处理和后台管理提供公共能力。
  • 插件开发接口:提供插件 SDK、manifest 类型及内置模块示例。
  • 插件市场入口:支持向 ETS 的 TGBotPress 分类提交插件展示信息。
  • 容器化部署:提供 Docker 镜像和 Compose 部署方式。

项目仍在迭代

当前已提供 SDK 类型、内置模块、生命周期管理和市场信息提交入口。任意第三方插件的通用安装、动态路由和安全隔离尚未完成;提交市场信息或成功打包不代表插件可以自动安装运行。具体状态请参阅 插件开发文档。

界面预览 ​

TGBotPress 管理员登录页面
管理员登录
TGBotPress 管理后台仪表盘
管理后台
TGBotPress 插件管理页面
插件管理
TGBotPress 插件开发页面
插件开发

点击截图可查看原图。界面与插件能力以实际使用的版本为准。

功能说明 ​

模块功能方向
群组管理群组、用户、群管策略和充值记录
闪兑钱包兑换钱包、订单与交易
能量管理能量平台、套餐、订单和相关任务
会员管理会员平台、套餐、订单和发放
监控管理机器人与钱包监控
归集管理归集钱包与任务,依赖闪兑模块
商城管理商城机器人、商品、卡密与订单
克隆 / 代理代理开户、商户和收益

各模块的包化程度不同,部分业务仍由基座提供;了解更多请查看功能说明。具体功能以所用版本和插件目录为准。

技术栈 ​

项目使用 TanStack Start、React 和 TypeScript 构建应用,使用 PostgreSQL 存储数据,并通过 Docker 和 GitHub Actions 交付。

快速开始 ​

可以使用项目提供的 Docker 镜像和 PostgreSQL 启动基座,也可以克隆源码进行开发。部署前请准备数据库密码、初始管理员密码和应用密钥,并根据访问地址配置 PLATFORM_ORIGIN。

查看快速开始 · 查看源码开发说明

配置指南 ​

部署时需要配置数据库连接、应用密钥和后台访问地址。Telegram、支付及其他业务功能可能需要额外服务和配置;启动基座并不代表这些业务已完成接入。

初始管理员密码仅在空数据库首次初始化时使用,之后修改环境变量不会重置已有密码。请妥善备份数据库和应用密钥。

查看配置指南 · 插件开发文档 · GitHub 项目仓库

Released under the MIT License.