mirror of
https://github.com/yanguo888/fakabot.git
synced 2026-06-20 12:30:40 +00:00
谷歌个百度
712 lines
15 KiB
Markdown
712 lines
15 KiB
Markdown
# 🤖 Fakabot - 专业的 Telegram 自动发卡机器人
|
||
|
||
[]()
|
||
[]()
|
||
[](https://t.me/sonhshu)
|
||
[]()
|
||
|
||
<div align="center">
|
||
|
||
### 🚀 全自动发卡系统 | 支持多种支付方式 | 订单自动处理 | Redis 高性能缓存
|
||
|
||
💳 支付宝 · 微信 · USDT | 🐳 Docker 一键部署 | ⚡ 性能提升 100 倍
|
||
|
||
**适用场景**：知识付费 · 虚拟商品 · 在线课程 · 软件授权 · 会员订阅
|
||
|
||
🎬 [在线演示](https://t.me/fakawan_bot) · 📱 [联系客服](https://t.me/sonhshu) · 📖 [完整文档](#-快速开始)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## ⚠️ 重要说明
|
||
|
||
本项目需要**授权码**才能运行。代码已内置授权验证系统，无法绕过。
|
||
|
||
- ✅ 授权码采用签名验证，无法伪造
|
||
- ✅ 到期前 7 天自动提醒
|
||
- ✅ 到期后自动停止运行
|
||
- ✅ 支持远程续费，无需重新部署
|
||
|
||
---
|
||
|
||
## ✨ 核心功能
|
||
|
||
### 💳 支付系统
|
||
|
||
支持 **4 种主流支付方式**，满足不同用户需求：
|
||
|
||
| 支付方式 | 特点 | 到账速度 |
|
||
|---------|------|---------|
|
||
| **支付宝** | 当面付、扫码支付 | 实时 |
|
||
| **微信支付** | Native 支付、扫码 | 实时 |
|
||
| **USDT (TOKEN188)** | TRC20/ERC20、链上验证 | 1-3 分钟 |
|
||
| **USDT (柠檬支付)** | 多链支持、低手续费 | 秒级 |
|
||
|
||
**特性**：
|
||
- ✅ 自动到账确认 · ✅ 支付回调处理 · ✅ 订单状态同步 · ✅ 支付超时处理
|
||
|
||
### 🎯 自动发货系统
|
||
|
||
支付成功后**自动发货**，无需人工干预：
|
||
|
||
**支持的发货方式**：
|
||
|
||
<table>
|
||
<tr>
|
||
<td>📱 <b>Telegram 群组邀请链接</b><br>（机器人自动生成一次性邀请链接，无需人工操作）</td>
|
||
<td>🔑 <b>卡密/激活码</b><br>（从库存自动提取）</td>
|
||
</tr>
|
||
<tr>
|
||
<td>📥 <b>下载链接</b><br>（自动发送）</td>
|
||
<td>📝 <b>自定义文本内容</b><br>（灵活配置）</td>
|
||
</tr>
|
||
</table>
|
||
|
||
**智能功能**：
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%">
|
||
|
||
- ✅ **自动生成一次性邀请链接**<br>（Telegram 群组，用后即失效）
|
||
- ✅ **库存自动扣减**<br>（卡密自动提取）
|
||
- ✅ **库存不足提醒**<br>（低于阈值自动通知）
|
||
|
||
</td>
|
||
<td width="50%">
|
||
|
||
- ✅ **防重复发货**<br>（订单去重机制）
|
||
- ✅ **发货失败重试**<br>（自动重试3次）
|
||
- ✅ **发货记录追踪**<br>（完整日志）
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
### ⚡ 性能优化
|
||
|
||
采用 **Redis 缓存**，性能提升 10-100 倍：
|
||
|
||
**优化项**：
|
||
- 🚀 商品列表缓存（减少 90% 数据库查询） · 🚀 用户数据缓存（响应速度提升 10 倍）
|
||
- 🚀 订单状态缓存（实时更新） · 🚀 支付状态缓存（秒级响应）
|
||
|
||
**其他优化**：
|
||
- ⚡ 频率限制（防止滥用） · ⚡ 自动降级（高负载保护） · ⚡ 连接池（提升并发） · ⚡ 异步处理（非阻塞）
|
||
|
||
### 📊 订单管理
|
||
|
||
完整的订单管理系统：
|
||
|
||
**功能列表**：
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%">
|
||
|
||
- 📋 订单列表（今日/历史/全部）
|
||
- 🔍 订单搜索（订单号/用户/商品）
|
||
- 📝 订单详情（完整信息）
|
||
|
||
</td>
|
||
<td width="50%">
|
||
|
||
- 🔄 订单状态（待支付/已支付/已完成/已退款）
|
||
- 💰 订单统计（金额/数量/趋势）
|
||
- 📊 数据导出（Excel/CSV）
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
### 👥 用户管理
|
||
|
||
强大的用户管理功能：
|
||
|
||
**用户信息**：
|
||
- 👤 用户列表 · 📊 用户统计 · 💰 消费记录 · 📈 用户画像
|
||
|
||
**用户操作**：
|
||
- 🚫 黑名单管理 · 👑 VIP 会员 · 💬 用户标签 · 📢 消息推送
|
||
|
||
### 🛍️ 商品管理
|
||
|
||
灵活的商品管理系统：
|
||
|
||
**商品设置**：
|
||
- ➕ 添加商品 · ✏️ 编辑商品 · 🗑️ 删除商品 · 📦 批量操作
|
||
|
||
**库存管理**：
|
||
- 📥 批量导入卡密 · 📊 库存统计 · ⚠️ 库存预警 · 🔄 自动补货提醒
|
||
|
||
**商品分类**：
|
||
- 📁 分类管理 · 🏷️ 标签系统 · 🔝 排序设置 · 👁️ 显示/隐藏
|
||
|
||
### 🎨 管理后台
|
||
|
||
专业的管理后台界面：
|
||
|
||
**数据统计**：
|
||
- 📊 今日数据（订单/收入/用户） · 📈 本月数据（趋势图表）
|
||
- 💰 总收入统计 · 👥 用户增长曲线
|
||
|
||
**快速操作**：
|
||
- ⚡ 一键发货 · 💸 一键退款 · 📢 批量通知 · 🔄 数据刷新
|
||
|
||
**系统设置**：
|
||
- ⚙️ 基础配置 · 💳 支付配置 · 📧 通知配置 · 🎨 界面定制
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 方式一：Docker 一键部署（推荐）⭐
|
||
|
||
**最简单的部署方式，5 分钟搞定！**
|
||
|
||
```bash
|
||
# 1. 克隆项目
|
||
git clone https://github.com/GUGEGEBAIDU/fakabot.git
|
||
cd fakabot
|
||
|
||
# 2. 复制配置文件
|
||
cp config.json.example config.json
|
||
|
||
# 3. 编辑配置（填写 Bot Token、管理员 ID 等）
|
||
vim config.json
|
||
|
||
# 4. 保存授权码
|
||
echo "你的授权码" > license.key
|
||
|
||
# 5. 一键启动
|
||
docker-compose up -d
|
||
|
||
# 6. 查看日志
|
||
docker-compose logs -f
|
||
```
|
||
|
||
**就这么简单！** ✅
|
||
|
||
**Docker Compose 配置**：
|
||
|
||
项目已包含 `docker-compose.yml`，自动配置：
|
||
- ✅ Fakabot 主程序
|
||
- ✅ Redis 缓存服务
|
||
- ✅ 数据持久化
|
||
- ✅ 自动重启
|
||
- ✅ 网络隔离
|
||
|
||
**常用 Docker 命令**：
|
||
|
||
```bash
|
||
# 启动服务
|
||
docker-compose up -d
|
||
|
||
# 停止服务
|
||
docker-compose stop
|
||
|
||
# 重启服务
|
||
docker-compose restart
|
||
|
||
# 查看日志
|
||
docker-compose logs -f
|
||
|
||
# 查看状态
|
||
docker-compose ps
|
||
|
||
# 更新代码
|
||
git pull && docker-compose up -d --build
|
||
|
||
# 备份数据
|
||
tar -czf backup.tar.gz data/ config.json license.key
|
||
```
|
||
|
||
---
|
||
|
||
### 方式二：传统部署
|
||
|
||
#### 环境要求
|
||
|
||
- **操作系统**: Linux (Ubuntu 20.04+) / macOS
|
||
- **Python**: 3.11+
|
||
- **内存**: 最低 1GB，推荐 2GB+
|
||
- **硬盘**: 最低 10GB
|
||
- **网络**: 需要访问 Telegram API
|
||
|
||
#### 部署步骤
|
||
|
||
**第 1 步：购买授权码**
|
||
|
||
联系客服：[@sonhshu](https://t.me/sonhshu)
|
||
|
||
**第 2 步：准备服务器**
|
||
|
||
推荐服务商：
|
||
- 阿里云轻量应用服务器（¥24/月）
|
||
- 腾讯云轻量应用服务器（¥25/月）
|
||
- Vultr（$5/月）
|
||
- DigitalOcean（$6/月）
|
||
|
||
配置建议：1核2GB，20GB 硬盘
|
||
|
||
**第 3 步：克隆项目**
|
||
|
||
```bash
|
||
# SSH 登录服务器
|
||
ssh root@你的服务器IP
|
||
|
||
# 克隆项目
|
||
git clone https://github.com/GUGEGEBAIDU/fakabot.git
|
||
cd fakabot
|
||
```
|
||
|
||
**第 4 步：安装依赖**
|
||
|
||
```bash
|
||
# 更新系统
|
||
apt update && apt upgrade -y
|
||
|
||
# 安装 Python 3.11
|
||
apt install python3.11 python3.11-pip -y
|
||
|
||
# 安装项目依赖
|
||
pip3 install -r requirements.txt
|
||
|
||
# 安装 Redis（可选，用于缓存）
|
||
apt install redis-server -y
|
||
systemctl start redis
|
||
systemctl enable redis
|
||
```
|
||
|
||
**第 5 步：配置机器人**
|
||
|
||
1. **创建 Telegram Bot**
|
||
- 找 [@BotFather](https://t.me/BotFather)
|
||
- 发送 `/newbot`
|
||
- 获取 Bot Token
|
||
|
||
2. **获取管理员 ID**
|
||
- 找 [@userinfobot](https://t.me/userinfobot)
|
||
- 获取你的 Telegram ID
|
||
|
||
3. **配置支付接口**
|
||
- 支付宝/微信：申请商户号
|
||
- USDT：注册 TOKEN188 或柠檬支付
|
||
|
||
4. **编辑配置文件**
|
||
|
||
```bash
|
||
cp config.json.example config.json
|
||
vim config.json
|
||
```
|
||
|
||
配置示例：
|
||
|
||
```json
|
||
{
|
||
"BOT_TOKEN": "你的Bot Token",
|
||
"ADMIN_ID": 你的Telegram ID,
|
||
"DOMAIN": "https://你的域名.com",
|
||
|
||
"PAYMENTS": {
|
||
"alipay": {
|
||
"enabled": true,
|
||
"app_id": "你的支付宝AppID",
|
||
"private_key": "你的私钥",
|
||
"public_key": "支付宝公钥"
|
||
},
|
||
"wxpay": {
|
||
"enabled": true,
|
||
"mch_id": "你的商户号",
|
||
"api_key": "你的API密钥"
|
||
},
|
||
"usdt_token188": {
|
||
"enabled": true,
|
||
"api_key": "你的API Key",
|
||
"merchant_id": "你的商户号"
|
||
}
|
||
},
|
||
|
||
"REDIS": {
|
||
"enabled": true,
|
||
"host": "localhost",
|
||
"port": 6379
|
||
}
|
||
}
|
||
```
|
||
|
||
**第 6 步：保存授权码**
|
||
|
||
```bash
|
||
echo "你的授权码" > license.key
|
||
```
|
||
|
||
**第 7 步：启动机器人**
|
||
|
||
方式 A：直接运行（测试用）
|
||
|
||
```bash
|
||
python3 bot.py
|
||
```
|
||
|
||
方式 B：后台运行（推荐）
|
||
|
||
```bash
|
||
nohup python3 bot.py > bot.log 2>&1 &
|
||
tail -f bot.log
|
||
```
|
||
|
||
方式 C：使用 systemd（最推荐）
|
||
|
||
```bash
|
||
# 创建服务文件
|
||
vim /etc/systemd/system/fakabot.service
|
||
```
|
||
|
||
服务文件内容：
|
||
|
||
```ini
|
||
[Unit]
|
||
Description=Fakabot Telegram Bot
|
||
After=network.target
|
||
|
||
[Service]
|
||
Type=simple
|
||
User=root
|
||
WorkingDirectory=/root/fakabot
|
||
ExecStart=/usr/bin/python3 /root/fakabot/bot.py
|
||
Restart=always
|
||
RestartSec=10
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
启动服务：
|
||
|
||
```bash
|
||
systemctl daemon-reload
|
||
systemctl start fakabot
|
||
systemctl enable fakabot
|
||
systemctl status fakabot
|
||
```
|
||
|
||
**第 8 步：验证运行**
|
||
|
||
在 Telegram 搜索你的机器人，发送 `/start`
|
||
|
||
授权验证成功提示：
|
||
```
|
||
✅ 授权验证通过
|
||
📝 客户ID: C001
|
||
📅 到期时间: 2025-11-18
|
||
⏰ 剩余天数: 30 天
|
||
```
|
||
|
||
---
|
||
|
||
## 📖 使用教程
|
||
|
||
### 管理员操作
|
||
|
||
#### 1. 添加商品
|
||
|
||
```
|
||
发送给机器人：
|
||
/admin → 商品管理 → 添加商品
|
||
|
||
填写信息：
|
||
- 商品名称：VIP会员
|
||
- 商品价格：99
|
||
- 商品描述：VIP会员，享受专属权益
|
||
- 发货内容：
|
||
方式1：@your_group（群组用户名，机器人自动生成一次性邀请链接）
|
||
方式2：https://t.me/+xxx（固定邀请链接）
|
||
方式3：卡密内容（从库存提取）
|
||
```
|
||
|
||
**群组邀请链接说明**：
|
||
- 🔐 **自动生成**：机器人自动调用 Telegram API 生成邀请链接
|
||
- ⏱️ **一次性使用**：每个订单生成独立链接，用后即失效
|
||
- 🚫 **防止滥用**：链接只能使用1次，无法分享给他人
|
||
- ✅ **无需人工**：全程自动化，无需管理员干预
|
||
|
||
#### 2. 管理库存
|
||
|
||
```
|
||
/admin → 商品管理 → 库存管理
|
||
|
||
批量导入卡密：
|
||
发送文本文件，每行一个卡密
|
||
```
|
||
|
||
#### 3. 查看订单
|
||
|
||
```
|
||
/admin → 订单管理
|
||
|
||
可以查看：
|
||
- 今日订单
|
||
- 历史订单
|
||
- 待处理订单
|
||
- 订单详情
|
||
```
|
||
|
||
#### 4. 数据统计
|
||
|
||
```
|
||
/admin → 数据统计
|
||
|
||
查看：
|
||
- 今日收入
|
||
- 本月收入
|
||
- 订单数量
|
||
- 用户数量
|
||
```
|
||
|
||
### 用户购买流程
|
||
|
||
#### 1. 用户发送 `/start`
|
||
|
||
机器人显示：
|
||
```
|
||
👋 欢迎使用自动发卡机器人！
|
||
|
||
📦 商品列表：
|
||
1. VIP会员 - 99 USDT
|
||
2. 高级课程 - 199 USDT
|
||
|
||
点击商品查看详情
|
||
```
|
||
|
||
#### 2. 选择商品
|
||
|
||
用户点击商品 → 显示详情 → 点击购买
|
||
|
||
#### 3. 选择支付方式
|
||
|
||
```
|
||
💳 请选择支付方式：
|
||
- 支付宝
|
||
- 微信支付
|
||
- USDT
|
||
```
|
||
|
||
#### 4. 完成支付
|
||
|
||
- 扫码支付
|
||
- 支付成功后自动发货
|
||
- 收到商品内容
|
||
|
||
#### 5. 查询订单
|
||
|
||
```
|
||
发送：/orders
|
||
|
||
查看历史订单和购买记录
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 高级配置
|
||
|
||
### 配置域名和 SSL
|
||
|
||
```bash
|
||
# 购买域名
|
||
# 阿里云：https://wanwang.aliyun.com
|
||
# 腾讯云：https://dnspod.cloud.tencent.com
|
||
|
||
# 配置 DNS
|
||
# 添加 A 记录：@ → 你的服务器IP
|
||
|
||
# 安装 Certbot
|
||
apt install certbot -y
|
||
|
||
# 申请证书
|
||
certbot certonly --standalone -d 你的域名.com
|
||
|
||
# 证书路径
|
||
# /etc/letsencrypt/live/你的域名.com/fullchain.pem
|
||
# /etc/letsencrypt/live/你的域名.com/privkey.pem
|
||
```
|
||
|
||
### 配置 Nginx 反向代理
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name 你的域名.com;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:58001;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 配置 Redis 缓存
|
||
|
||
```bash
|
||
# 安装 Redis
|
||
apt install redis-server -y
|
||
|
||
# 配置 Redis
|
||
vim /etc/redis/redis.conf
|
||
|
||
# 设置密码（可选）
|
||
requirepass 你的密码
|
||
|
||
# 设置最大内存
|
||
maxmemory 256mb
|
||
maxmemory-policy allkeys-lru
|
||
|
||
# 重启 Redis
|
||
systemctl restart redis
|
||
```
|
||
|
||
### 数据备份
|
||
|
||
```bash
|
||
# 备份数据库
|
||
cp fakabot.db fakabot.db.backup
|
||
|
||
# 定时备份（每天凌晨3点）
|
||
crontab -e
|
||
|
||
# 添加：
|
||
0 3 * * * cp /root/fakabot/fakabot.db /root/backup/fakabot_$(date +\%Y\%m\%d).db
|
||
```
|
||
|
||
---
|
||
|
||
## 💰 订阅价格
|
||
|
||
| 套餐 | 价格 | 优惠 | 推荐 |
|
||
|------|------|------|------|
|
||
| 月付 | 50 USDT/月 | - | 试用 ⭐ |
|
||
| 季付 | 135 USDT/季 | 10% | 推荐 ⭐⭐ |
|
||
| 年付 | 510 USDT/年 | 15% | 最划算 ⭐⭐⭐ |
|
||
|
||
### 购买方式
|
||
|
||
**联系客服**: [@sonhshu](https://t.me/sonhshu)
|
||
|
||
**支付方式**: USDT (TRC20)
|
||
```
|
||
TDZM5DSSq8SrB8QTSBHyNwrcTswtCjKs9t
|
||
```
|
||
|
||
> 💡 支付后请提供交易哈希和 Telegram 用户名，10 分钟内开通授权
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
### 购买相关
|
||
|
||
**Q: 可以试用吗？**
|
||
A: 建议先购买月付（50 USDT）试用一个月，满意后再升级年付。首次购买 7 天内不满意可全额退款。
|
||
|
||
**Q: 授权码会过期吗？**
|
||
A: 是的，月付30天，季付90天，年付365天。到期前7天会自动提醒。
|
||
|
||
**Q: 可以退款吗？**
|
||
A: 首次购买7天内不满意可申请全额退款。
|
||
|
||
**Q: 包含技术支持吗？**
|
||
A: 是的，所有订阅都包含技术支持，响应时间通常 1-24 小时。
|
||
|
||
**Q: 续费如何操作？**
|
||
A: 联系客服，支付续费金额，获得新授权码，替换 license.key 文件即可。
|
||
|
||
### 技术相关
|
||
|
||
**Q: 需要什么配置的服务器？**
|
||
A: 最低 1核1GB，推荐 1核2GB。月费约 $5-10。
|
||
|
||
**Q: 必须要域名吗？**
|
||
A: 不是必须的，但强烈推荐。域名可以配置 SSL，更安全。
|
||
|
||
**Q: 支持哪些支付方式？**
|
||
A: 机器人支持支付宝、微信、USDT (TOKEN188)、USDT (柠檬支付)。购买授权使用 USDT (TRC20)。
|
||
|
||
**Q: 可以自定义界面吗？**
|
||
A: 可以，修改配置文件中的文案和按钮即可。
|
||
|
||
**Q: 支持多语言吗？**
|
||
A: 目前支持中文，可以自行翻译配置文件实现多语言。
|
||
|
||
**Q: 数据存储在哪里？**
|
||
A: 使用 SQLite 数据库，存储在 fakabot.db 文件中。
|
||
|
||
**Q: 如何备份数据？**
|
||
A: 定期备份 fakabot.db 文件和 config.json 配置文件。
|
||
|
||
**Q: 授权码丢了怎么办？**
|
||
A: 联系客服，提供购买记录，可以重新发送授权码。
|
||
|
||
### 使用相关
|
||
|
||
**Q: 如何添加商品？**
|
||
A: 发送 /admin → 商品管理 → 添加商品。
|
||
|
||
**Q: 如何查看收入？**
|
||
A: 发送 /admin → 数据统计。
|
||
|
||
**Q: 支持自动发货吗？**
|
||
A: 是的，支付成功后自动发货，无需人工干预。
|
||
|
||
**Q: 可以设置优惠券吗？**
|
||
A: 可以，在管理后台设置优惠码和折扣。
|
||
|
||
**Q: 支持分销吗？**
|
||
A: 当前版本不支持，后续版本会添加。
|
||
|
||
---
|
||
|
||
## 🔒 授权保护
|
||
|
||
本项目采用内置授权验证，代码中嵌入了授权检查逻辑。
|
||
|
||
**无法绕过的原因**：
|
||
- ✅ 授权检查嵌入在每个文件中
|
||
- ✅ 删除授权检查会导致程序崩溃
|
||
- ✅ 授权码采用签名验证，无法伪造
|
||
- ✅ 破解成本远高于购买价格
|
||
|
||
---
|
||
|
||
## 📞 联系我们
|
||
|
||
- **Telegram 客服**: [@sonhshu](https://t.me/sonhshu)
|
||
- **演示机器人**: [@fakawan_bot](https://t.me/fakawan_bot)
|
||
- **GitHub 项目**: [GUGEGEBAIDU/fakabot](https://github.com/GUGEGEBAIDU/fakabot)
|
||
|
||
---
|
||
|
||
## 📄 许可证
|
||
|
||
本项目为商业软件，采用订阅制授权。
|
||
|
||
未经授权，禁止：
|
||
- 反编译或反向工程
|
||
- 分发或转售
|
||
- 删除版权声明
|
||
- 商业使用（需购买授权）
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**专业的 Telegram 自动发卡解决方案**
|
||
|
||
Made with ❤️ by Fakabot Team
|
||
|
||
[开始使用](#-快速开始) · [查看演示](https://t.me/fakawan_bot) · [联系客服](https://t.me/sonhshu)
|
||
|
||
</div>
|