
TGBotPress
项目介绍
TGBotPress 是面向 Telegram Bot 的模块化管理基座,以「基座 + 模块插件 + 插件市场」为发展方向。基座提供管理后台、数据库、机器人管理和插件生命周期等公共能力,开发者可以围绕业务模块组织代码,减少重复开发。
项目采用 Apache License 2.0 开源,适合需要管理多个机器人业务或开发 Telegram Bot 模块的团队和开发者。
项目特点
- 模块化管理:将群组、商城、监控等业务按模块组织和管理。
- 机器人管理基座:围绕机器人配置、消息处理和后台管理提供公共能力。
- 插件开发接口:提供插件 SDK、manifest 类型及内置模块示例。
- 插件市场入口:支持向 ETS 的 TGBotPress 分类提交插件展示信息。
- 容器化部署:提供 Docker 镜像和 Compose 部署方式。
项目仍在迭代
当前已提供 SDK 类型、内置模块、生命周期管理和市场信息提交入口。任意第三方插件的通用安装、动态路由和安全隔离尚未完成;提交市场信息或成功打包不代表插件可以自动安装运行。具体状态请参阅 插件开发文档。
界面预览
点击截图可查看原图。界面与插件能力以实际使用的版本为准。
功能说明
| 模块 | 功能方向 |
|---|---|
| 群组管理 | 群组、用户、群管策略和充值记录 |
| 闪兑钱包 | 兑换钱包、订单与交易 |
| 能量管理 | 能量平台、套餐、订单和相关任务 |
| 会员管理 | 会员平台、套餐、订单和发放 |
| 监控管理 | 机器人与钱包监控 |
| 归集管理 | 归集钱包与任务,依赖闪兑模块 |
| 商城管理 | 商城机器人、商品、卡密与订单 |
| 克隆 / 代理 | 代理开户、商户和收益 |
各模块的包化程度不同,部分业务仍由基座提供;了解更多请查看功能说明。具体功能以所用版本和插件目录为准。
技术栈
项目使用 TanStack Start、React 和 TypeScript 构建应用,使用 PostgreSQL 存储数据,并通过 Docker 和 GitHub Actions 交付。
快速开始
可以使用项目提供的 Docker 镜像和 PostgreSQL 启动基座,也可以克隆源码进行开发。部署前请准备数据库密码、初始管理员密码和应用密钥,并根据访问地址配置 PLATFORM_ORIGIN。
配置指南
部署时需要配置数据库连接、应用密钥和后台访问地址。Telegram、支付及其他业务功能可能需要额外服务和配置;启动基座并不代表这些业务已完成接入。
初始管理员密码仅在空数据库首次初始化时使用,之后修改环境变量不会重置已有密码。请妥善备份数据库和应用密钥。
查看配置指南 · 插件开发文档 · GitHub 项目仓库



