源码简介
这套源码是一个 Telegram 红包机器人系统项目，核心用 Node.js + Express + SQLite 开发。 机器人基于 node-telegram-bot-api 实现，用户私聊即可使用发红包、领红包、查询余额、转账、收款、充值提现和交易账单等功能。 钱包支持 USDT、TRX、CNY 三种余额，充值通过 TRC20 地址手动入账，提现由管理员在后台审核。 包内还带一套 Web 管理后台（钱包系统管理后台），可管理用户、审核提现、配置收款地址、广播消息与查看统计。 源码结构清晰、依赖简单，适合想学习 Telegram 机器人钱包与红包业务实现的开发者做本地部署和二次开发参考。
适用场景
- 学习 Telegram Bot 的回调菜单、内联模式与消息交互实现
- 搭建红包、转账、收款类的 USDT 钱包机器人做功能验证
- 研究托管式钱包的余额管理、充值提现审核与后台运营逻辑
技术栈与运行环境
- 后端：Node.js（>=14）+ Express 4.18 + SQLite3（本地文件数据库）
- 机器人：node-telegram-bot-api 0.61、node-cron、multer、cors、bcryptjs、uuid
- 前端：原生 HTML/JS 管理后台（public/ 目录，无构建步骤，可直接静态托管）
- 运行环境：Node.js 14+、可访问 Telegram API 的网络、一个 Telegram Bot Token
- 其他：bcryptjs 用于管理员密码校验，SQLite 文件库位于 database/redpack.db
功能亮点
- 红包收发：用户可用 /redpack 命令或内联模式发红包，金额随机分配（微信式拼手气），24 小时过期，每人限领一次，对应 RedpackManager 的 createRedpack / claimRedpack。
- 转账与收款：支持用户间转账（带确认流程，禁止转给自己），内联模式可发起向他人收款，对应 handleTransfer 与内联收款逻辑。
- 多币种钱包：用户表含 usdt / trx / cny 三类余额，充值展示 TRC20 收款地址，提现支持 usdt_trc20、trx、cny 三种方式，提交后为 pending 状态，对应 withdraw 系列回调。
- 提现审核后台：管理员在 Web 后台查看待审提现，可 approve / reject，拒绝自动退回余额并生成退款记录，对应 server.js 的 /api/withdrawals 接口。
- 用户与权限管理：支持加款、扣款、清零用户余额，管理员分 full / basic 权限并支持增删改，对应 /api/users 与 /api/admins。
- 广播与统计：可向全部用户广播图文消息（带按钮），并查看系统统计数据，对应 /api/broadcast 与 /api/stats。
安装与部署提示
- 准备环境：安装 Node.js 14+，进入 源码 目录执行 npm install 安装依赖。
- 配置机器人：编辑 config.json 填入自己的 Telegram bot_token（到 @BotFather 申请），修改 admin 默认账号密码与 payment.trc20_address 收款地址。
- 初始化数据库：执行 npm run init-db 生成 database/redpack.db，首次启动会自动建表。
- 启动服务：执行 npm start（默认端口 5777），浏览器访问 http://localhost:5777 进入 Web 管理后台；机器人会在 Telegram 上自动响应私聊命令。 注意：config.json 中 bot_token、管理员账号密码均为明文示例，部署前务必替换；TRC20 地址也需改成自有地址，避免资金流向他人。
截图与演示说明
- 机器人私聊主菜单：充值、提币、发红包、转账、个人中心、帮助等按钮
- 红包交互消息：/redpack 发红包、领取红包结果卡片（恭喜领取 X USDT）
- 余额与交易：/balance 余额展示、/myredpacks 我发出的红包、交易记录与账单页
- 转账流程：选择收款人、金额输入、确认转账消息卡片
- Web 后台登录页：管理员账号密码登录（index.html 登录界面）
- Web 后台菜单：仪表盘、用户管理、红包管理、提现管理（带待审角标）、广播消息、系统配置、统计
- 用户管理页：加款 / 扣款 / 清零、查看用户交易记录
- 提现管理页：待审提现列表、通过 / 拒绝操作
常见问题
运行前需要准备什么？
需要 Node.js 14+ 环境、一个在 @BotFather 申请到的 Telegram Bot Token，以及能正常访问 Telegram 的网络。数据库用 SQLite 文件，无需单独部署数据库服务。充值提现依赖自有 TRC20 收款地址，正式运营前请自行评估资金与合规风险。
这套源码适合二次开发吗？
适合。后端用 Express 分层，机器人逻辑集中在 bot/TelegramBot.js，钱包与红包核心在 models/RedpackManager.js 与 models/Database.js，Web 后台是原生 HTML/JS 无构建步骤，改起来直观。但机器人 Token、管理员密码、TRC20 地址都写在明文配置里，二次开发时建议改为环境变量或加密存储。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！ 补充说明：源码中 Telegram bot_token、管理员账号密码（admin/admin123456、manager/manager123）以及默认 TRC20 收款地址均以明文写在 config.json 中，属于示例配置，部署前必须全部替换为自有凭据，防止机器人权限与资金被他人利用。该机器人属于托管式（custodial）加密货币钱包，涉及用户资金收付，上线前请完成安全评估并遵守所在地关于虚拟货币与资金业务的法律法规。
下载说明
源码仅供学习研究、本地测试部署与二次开发参考，商用前请自行确认授权、版权与合规要求。涉及 USDT / TRX 充值提现、用户资金托管的功能，请严格遵守相关平台规则与当地法律法规，勿用于欺诈或违规资金业务。
评论(0)