mirror of
https://github.com/yanguo888/fakabot.git
synced 2026-06-20 12:30:40 +00:00
Update README with detailed tutorial and features
This commit is contained in:
谷歌个百度
@@ -1,15 +1,29 @@
|
||||
# 🤖 Fakabot - Telegram 自动发卡机器人
|
||||
# 🤖 Fakabot - 专业的 Telegram 自动发卡机器人
|
||||
|
||||
[]()
|
||||
[]()
|
||||
[](https://t.me/sonhshu)
|
||||
|
||||
**需要授权码才能运行**
|
||||
> 🚀 **全自动发卡系统** | 支持多种支付方式 | 订单自动处理 | Redis 高性能缓存
|
||||
|
||||
**适用场景**：知识付费、虚拟商品、在线课程、软件授权、会员订阅
|
||||
|
||||
---
|
||||
|
||||
## 📺 演示视频
|
||||
|
||||
[点击查看演示视频](https://t.me/sonhshu)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 重要说明
|
||||
|
||||
本项目需要授权码才能运行。代码已内置授权验证，无法绕过。
|
||||
本项目需要**授权码**才能运行。代码已内置授权验证系统，无法绕过。
|
||||
|
||||
- ✅ 授权码采用签名验证，无法伪造
|
||||
- ✅ 到期前7天自动提醒
|
||||
- ✅ 到期后自动停止运行
|
||||
- ✅ 支持远程续费，无需重新部署
|
||||
|
||||
---
|
||||
|
||||
@@ -23,55 +37,352 @@
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速安装
|
||||
## 🚀 完整部署教程
|
||||
|
||||
### 1. 克隆项目
|
||||
### 📋 环境要求
|
||||
|
||||
- **操作系统**: Linux (Ubuntu 20.04+) / macOS
|
||||
- **Python**: 3.11+
|
||||
- **内存**: 最低 1GB，推荐 2GB+
|
||||
- **硬盘**: 最低 10GB
|
||||
- **网络**: 需要访问 Telegram API
|
||||
|
||||
### 第1步：购买授权码
|
||||
|
||||
**联系购买**：
|
||||
- 📱 Telegram: https://t.me/sonhshu
|
||||
- 💰 价格：50 USDT/月起
|
||||
- ⏰ 响应时间：通常 1 小时内
|
||||
|
||||
**购买流程**：
|
||||
1. 联系客服
|
||||
2. 选择套餐（月付/季付/年付）
|
||||
3. 支付 USDT
|
||||
4. 获得授权码
|
||||
|
||||
### 第2步：准备服务器
|
||||
|
||||
#### 方案A：使用云服务器（推荐）
|
||||
|
||||
**推荐服务商**：
|
||||
- 阿里云轻量应用服务器（¥24/月）
|
||||
- 腾讯云轻量应用服务器（¥25/月）
|
||||
- Vultr（$5/月）
|
||||
- DigitalOcean（$6/月）
|
||||
|
||||
**配置建议**：
|
||||
- CPU: 1核
|
||||
- 内存: 2GB
|
||||
- 硬盘: 20GB
|
||||
- 带宽: 1Mbps
|
||||
|
||||
#### 方案B：本地运行
|
||||
|
||||
如果只是测试，可以在本地电脑运行。
|
||||
|
||||
### 第3步：克隆项目
|
||||
|
||||
```bash
|
||||
git clone https://github.com/你的用户名/fakabot.git
|
||||
# SSH 登录服务器
|
||||
ssh root@你的服务器IP
|
||||
|
||||
# 克隆项目
|
||||
git clone https://github.com/GUGEGEBAIDU/fakabot.git
|
||||
cd fakabot
|
||||
```
|
||||
|
||||
### 2. 安装依赖
|
||||
### 第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
|
||||
```
|
||||
|
||||
### 3. 配置
|
||||
### 第5步：配置机器人
|
||||
|
||||
#### 5.1 创建 Telegram Bot
|
||||
|
||||
1. 在 Telegram 搜索 [@BotFather](https://t.me/BotFather)
|
||||
2. 发送 `/newbot`
|
||||
3. 输入机器人名称（例如：`我的发卡机器人`）
|
||||
4. 输入机器人用户名（例如：`my_faka_bot`）
|
||||
5. 获得 Bot Token（例如：`123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`）
|
||||
|
||||
#### 5.2 获取你的 Telegram ID
|
||||
|
||||
1. 在 Telegram 搜索 [@userinfobot](https://t.me/userinfobot)
|
||||
2. 发送任意消息
|
||||
3. 获得你的 ID（例如：`123456789`）
|
||||
|
||||
#### 5.3 配置支付接口
|
||||
|
||||
**支付宝/微信**：
|
||||
- 申请支付宝当面付或微信支付
|
||||
- 获取 AppID、商户号、密钥
|
||||
|
||||
**USDT**：
|
||||
- 注册 TOKEN188 或柠檬支付
|
||||
- 获取 API Key 和商户号
|
||||
|
||||
#### 5.4 编辑配置文件
|
||||
|
||||
```bash
|
||||
cp config.json.example config.json
|
||||
vim config.json # 填写你的配置
|
||||
vim config.json
|
||||
```
|
||||
|
||||
### 4. 购买授权码
|
||||
**配置示例**：
|
||||
|
||||
**联系购买**：
|
||||
- Telegram: https://t.me/sonhshu
|
||||
```json
|
||||
{
|
||||
"BOT_TOKEN": "你的Bot Token",
|
||||
"ADMIN_ID": 你的Telegram ID,
|
||||
"DOMAIN": "https://你的域名.com",
|
||||
|
||||
### 5. 保存授权码
|
||||
"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步：配置域名（可选但推荐）
|
||||
|
||||
#### 6.1 购买域名
|
||||
|
||||
- 阿里云：https://wanwang.aliyun.com
|
||||
- 腾讯云：https://dnspod.cloud.tencent.com
|
||||
- Namecheap：https://www.namecheap.com
|
||||
|
||||
**价格**：约 ¥50-100/年
|
||||
|
||||
#### 6.2 配置 DNS
|
||||
|
||||
添加 A 记录：
|
||||
- 主机记录：`@` 或 `bot`
|
||||
- 记录类型：`A`
|
||||
- 记录值：`你的服务器IP`
|
||||
- TTL：`600`
|
||||
|
||||
#### 6.3 配置 SSL 证书（推荐）
|
||||
|
||||
```bash
|
||||
echo "你的授权码" > license.key
|
||||
# 安装 Certbot
|
||||
apt install certbot -y
|
||||
|
||||
# 申请证书
|
||||
certbot certonly --standalone -d 你的域名.com
|
||||
|
||||
# 证书路径
|
||||
# /etc/letsencrypt/live/你的域名.com/fullchain.pem
|
||||
# /etc/letsencrypt/live/你的域名.com/privkey.pem
|
||||
```
|
||||
|
||||
### 6. 启动
|
||||
### 第7步：保存授权码
|
||||
|
||||
```bash
|
||||
# 在项目目录下
|
||||
cd /root/fakabot
|
||||
|
||||
# 保存授权码
|
||||
echo "你的授权码" > license.key
|
||||
|
||||
# 示例：
|
||||
# echo "C001|1738310400|abc123def456..." > license.key
|
||||
```
|
||||
|
||||
### 第8步：启动机器人
|
||||
|
||||
#### 方式A：直接运行（测试用）
|
||||
|
||||
```bash
|
||||
python3 bot.py
|
||||
```
|
||||
|
||||
#### 方式B：后台运行（推荐）
|
||||
|
||||
```bash
|
||||
# 使用 nohup
|
||||
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
|
||||
|
||||
# 查看日志
|
||||
journalctl -u fakabot -f
|
||||
```
|
||||
|
||||
### 第9步：验证运行
|
||||
|
||||
1. 在 Telegram 搜索你的机器人
|
||||
2. 发送 `/start`
|
||||
3. 如果看到欢迎消息，说明运行成功！
|
||||
|
||||
**授权验证成功提示**：
|
||||
```
|
||||
✅ 授权验证通过
|
||||
📝 客户ID: C001
|
||||
📅 到期时间: 2025-11-18
|
||||
⏰ 剩余天数: 30 天
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✨ 功能特性
|
||||
## ✨ 核心功能
|
||||
|
||||
- ✅ 4种支付方式（支付宝/微信/USDT）
|
||||
- ✅ 自动发货系统
|
||||
- ✅ Redis 缓存优化
|
||||
- ✅ 订单管理系统
|
||||
- ✅ 用户管理系统
|
||||
- ✅ 商品管理系统
|
||||
### 💳 支付系统
|
||||
|
||||
支持 **4 种主流支付方式**：
|
||||
|
||||
1. **支付宝**
|
||||
- 当面付
|
||||
- 扫码支付
|
||||
- 自动到账确认
|
||||
|
||||
2. **微信支付**
|
||||
- Native 支付
|
||||
- 扫码支付
|
||||
- 实时回调
|
||||
|
||||
3. **USDT (TOKEN188)**
|
||||
- TRC20/ERC20
|
||||
- 自动监控到账
|
||||
- 链上验证
|
||||
|
||||
4. **USDT (柠檬支付)**
|
||||
- 多链支持
|
||||
- 秒级确认
|
||||
- 低手续费
|
||||
|
||||
### 🎯 自动发货
|
||||
|
||||
- ✅ **支付成功自动发货** - 无需人工干预
|
||||
- ✅ **多种发货方式**：
|
||||
- Telegram 群组邀请链接
|
||||
- 卡密/激活码
|
||||
- 下载链接
|
||||
- 自定义文本
|
||||
- ✅ **库存管理** - 自动扣减，库存不足提醒
|
||||
- ✅ **防重复发货** - 订单去重机制
|
||||
|
||||
### 📊 订单管理
|
||||
|
||||
- ✅ **完整订单记录** - 用户、商品、金额、时间
|
||||
- ✅ **订单状态追踪** - 待付款、已付款、已发货、已完成
|
||||
- ✅ **订单查询** - 用户可查询历史订单
|
||||
- ✅ **退款处理** - 支持订单退款
|
||||
- ✅ **数据导出** - Excel 格式导出
|
||||
|
||||
### 👥 用户管理
|
||||
|
||||
- ✅ **用户信息记录** - Telegram ID、用户名、购买记录
|
||||
- ✅ **用户分组** - VIP、普通用户、黑名单
|
||||
- ✅ **购买统计** - 用户消费金额、购买次数
|
||||
- ✅ **用户黑名单** - 防止恶意用户
|
||||
|
||||
### 🛍️ 商品管理
|
||||
|
||||
- ✅ **多商品支持** - 无限商品数量
|
||||
- ✅ **商品分类** - 自定义分类
|
||||
- ✅ **价格设置** - 灵活定价
|
||||
- ✅ **库存管理** - 实时库存监控
|
||||
- ✅ **商品上下架** - 随时控制销售
|
||||
|
||||
### ⚡ 性能优化
|
||||
|
||||
- ✅ **Redis 缓存** - 性能提升 10-100 倍
|
||||
- ✅ **订单预加载** - 用户无感知等待
|
||||
- ✅ **频率限制** - 防刷单、防攻击
|
||||
- ✅ **自动降级** - Redis 故障不影响业务
|
||||
|
||||
### 🔒 安全特性
|
||||
|
||||
- ✅ **支付签名验证** - 防止伪造订单
|
||||
- ✅ **金额验证** - 防止金额篡改
|
||||
- ✅ **防重复支付** - 订单去重
|
||||
- ✅ **IP 限流** - 防止恶意攻击
|
||||
- ✅ **数据加密** - 敏感信息加密存储
|
||||
|
||||
### 🎨 管理后台
|
||||
|
||||
- ✅ **实时统计** - 今日订单、收入、用户数
|
||||
- ✅ **数据可视化** - 图表展示
|
||||
- ✅ **快速操作** - 一键发货、退款
|
||||
- ✅ **日志查询** - 完整操作日志
|
||||
- ✅ **系统设置** - 灵活配置
|
||||
|
||||
---
|
||||
|
||||
@@ -81,19 +392,224 @@ python3 bot.py
|
||||
|
||||
---
|
||||
|
||||
## 📖 使用教程
|
||||
|
||||
### 管理员操作
|
||||
|
||||
#### 1. 添加商品
|
||||
|
||||
```
|
||||
发送给机器人：
|
||||
/admin → 商品管理 → 添加商品
|
||||
|
||||
填写信息：
|
||||
- 商品名称：VIP会员
|
||||
- 商品价格：99
|
||||
- 商品描述：VIP会员，享受专属权益
|
||||
- 发货内容：https://t.me/+xxx（群组邀请链接）
|
||||
```
|
||||
|
||||
#### 2. 管理库存
|
||||
|
||||
```
|
||||
/admin → 商品管理 → 库存管理
|
||||
|
||||
批量导入卡密：
|
||||
发送文本文件，每行一个卡密
|
||||
```
|
||||
|
||||
#### 3. 查看订单
|
||||
|
||||
```
|
||||
/admin → 订单管理
|
||||
|
||||
可以查看：
|
||||
- 今日订单
|
||||
- 历史订单
|
||||
- 待处理订单
|
||||
- 订单详情
|
||||
```
|
||||
|
||||
#### 4. 数据统计
|
||||
|
||||
```
|
||||
/admin → 数据统计
|
||||
|
||||
查看：
|
||||
- 今日收入
|
||||
- 本月收入
|
||||
- 订单数量
|
||||
- 用户数量
|
||||
```
|
||||
|
||||
### 用户购买流程
|
||||
|
||||
#### 1. 用户发送 `/start`
|
||||
|
||||
机器人显示：
|
||||
```
|
||||
👋 欢迎使用自动发卡机器人！
|
||||
|
||||
📦 商品列表：
|
||||
1. VIP会员 - 99 USDT
|
||||
2. 高级课程 - 199 USDT
|
||||
|
||||
点击商品查看详情
|
||||
```
|
||||
|
||||
#### 2. 选择商品
|
||||
|
||||
用户点击商品 → 显示详情 → 点击购买
|
||||
|
||||
#### 3. 选择支付方式
|
||||
|
||||
```
|
||||
💳 请选择支付方式：
|
||||
- 支付宝
|
||||
- 微信支付
|
||||
- USDT
|
||||
```
|
||||
|
||||
#### 4. 完成支付
|
||||
|
||||
- 扫码支付
|
||||
- 支付成功后自动发货
|
||||
- 收到商品内容
|
||||
|
||||
#### 5. 查询订单
|
||||
|
||||
```
|
||||
发送：/orders
|
||||
|
||||
查看历史订单和购买记录
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 高级配置
|
||||
|
||||
### 配置 Webhook（推荐）
|
||||
|
||||
使用 Webhook 比轮询更高效：
|
||||
|
||||
```python
|
||||
# 在 config.json 中
|
||||
{
|
||||
"WEBHOOK": {
|
||||
"enabled": true,
|
||||
"url": "https://你的域名.com/webhook",
|
||||
"port": 8443
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 配置 Redis 缓存
|
||||
|
||||
```bash
|
||||
# 安装 Redis
|
||||
apt install redis-server -y
|
||||
|
||||
# 配置 Redis
|
||||
vim /etc/redis/redis.conf
|
||||
|
||||
# 设置密码（可选）
|
||||
requirepass 你的密码
|
||||
|
||||
# 重启 Redis
|
||||
systemctl restart redis
|
||||
```
|
||||
|
||||
### 配置反向代理（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;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 数据备份
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ❓ 常见问题
|
||||
|
||||
### 购买相关
|
||||
|
||||
**Q: 可以试用吗？**
|
||||
A: 建议先购买月付（50 USDT）试用一个月。
|
||||
A: 建议先购买月付（50 USDT）试用一个月，满意后再升级年付。
|
||||
|
||||
**Q: 授权码会过期吗？**
|
||||
A: 是的，月付30天，季付90天，年付365天。
|
||||
A: 是的，月付30天，季付90天，年付365天。到期前7天会自动提醒。
|
||||
|
||||
**Q: 可以退款吗？**
|
||||
A: 首次购买7天内不满意可申请退款。
|
||||
A: 首次购买7天内不满意可申请全额退款。
|
||||
|
||||
**Q: 包含技术支持吗？**
|
||||
A: 是的，所有订阅都包含技术支持。
|
||||
A: 是的，所有订阅都包含技术支持，响应时间通常 1-24 小时。
|
||||
|
||||
**Q: 续费如何操作？**
|
||||
A: 联系客服，支付续费金额，获得新授权码，替换 license.key 文件即可。
|
||||
|
||||
### 技术相关
|
||||
|
||||
**Q: 需要什么配置的服务器？**
|
||||
A: 最低 1核1GB，推荐 1核2GB。月费约 $5-10。
|
||||
|
||||
**Q: 必须要域名吗？**
|
||||
A: 不是必须的，但强烈推荐。域名可以配置 SSL，更安全。
|
||||
|
||||
**Q: 支持哪些支付方式？**
|
||||
A: 支付宝、微信、USDT (TOKEN188)、USDT (柠檬支付)。
|
||||
|
||||
**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: 当前版本不支持，后续版本会添加。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user