Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Telegram自动发卡机器人 电报发卡机器人 - 支持支付宝/微信/USDT支付 自动发货 订单管理 虚拟商品 | Telegram Auto Card Delivery Bot Payment Shop

License

Notifications You must be signed in to change notification settings

GUGEGEBAIDU/fakabot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Fakabot - 专业的 Telegram 自动发卡机器人

GitHub release GitHub stars GitHub forks GitHub issues License Python Telegram Docker

🚀 全自动发卡系统 | 支持多种支付方式 | 订单自动处理 | Redis 高性能缓存

💳 支付宝 · 微信 · USDT | 🐳 Docker 一键部署 | ⚡ 性能提升 100 倍

适用场景:知识付费 · 虚拟商品 · 在线课程 · 软件授权 · 会员订阅

🎬 在线演示 · 📱 联系客服 · 📖 完整文档

中文文档 | English


⚠️ 重要说明

本项目需要授权码才能运行。代码已内置授权验证系统,无法绕过。

  • ✅ 授权码采用签名验证,无法伪造
  • ✅ 到期前 7 天自动提醒
  • ✅ 到期后自动停止运行
  • ✅ 支持远程续费,无需重新部署

✨ 核心功能

💳 支付系统

支持 4 种主流支付方式,满足不同用户需求:

支付方式 特点 到账速度
支付宝 当面付、扫码支付 实时
微信支付 Native 支付、扫码 实时
USDT (TOKEN188) TRC20/ERC20、链上验证 1-3 分钟
USDT (柠檬支付) 多链支持、低手续费 秒级

特性

  • ✅ 自动到账确认 · ✅ 支付回调处理 · ✅ 订单状态同步 · ✅ 支付超时处理

🎯 自动发货系统

支付成功后自动发货,无需人工干预:

支持的发货方式

📱 Telegram 群组邀请链接
(机器人自动生成一次性邀请链接,无需人工操作)
🔑 卡密/激活码
(从库存自动提取)
📥 下载链接
(自动发送)
📝 自定义文本内容
(灵活配置)

智能功能

  • 自动生成一次性邀请链接
    (Telegram 群组,用后即失效)
  • 库存自动扣减
    (卡密自动提取)
  • 库存不足提醒
    (低于阈值自动通知)
  • 防重复发货
    (订单去重机制)
  • 发货失败重试
    (自动重试3次)
  • 发货记录追踪
    (完整日志)

⚡ 性能优化

采用 Redis 缓存,性能提升 10-100 倍:

优化项

  • 🚀 商品列表缓存(减少 90% 数据库查询) · 🚀 用户数据缓存(响应速度提升 10 倍)
  • 🚀 订单状态缓存(实时更新) · 🚀 支付状态缓存(秒级响应)

其他优化

  • ⚡ 频率限制(防止滥用) · ⚡ 自动降级(高负载保护) · ⚡ 连接池(提升并发) · ⚡ 异步处理(非阻塞)

📊 订单管理

完整的订单管理系统:

功能列表

  • 📋 订单列表(今日/历史/全部)
  • 🔍 订单搜索(订单号/用户/商品)
  • 📝 订单详情(完整信息)
  • 🔄 订单状态(待支付/已支付/已完成/已取消)
  • 💰 订单统计(金额/数量)

👥 用户管理

强大的用户管理功能:

用户信息

  • 👤 用户列表 · 📊 用户统计 · 💰 消费记录

🛍️ 商品管理

灵活的商品管理系统:

商品设置

  • ➕ 添加商品 · ✏️ 编辑商品 · 🗑️ 删除商品 · 📦 批量操作

库存管理

  • 📥 批量导入卡密 · 📊 库存统计 · ⚠️ 库存预警 · 🔄 自动补货提醒

🎨 管理后台

专业的管理后台界面:

数据统计

  • 📊 今日数据(订单/收入/用户)
  • 📈 本月数据统计
  • 💰 总收入统计

快速操作

  • ⚡ 一键发货 · 📢 批量通知 · 🔄 数据刷新

系统设置

  • ⚙️ 基础配置 · 💳 支付配置 · 📧 通知配置

🚀 快速开始

🎉 首次使用教程

💡 适用于:刚购买授权码,第一次部署机器人

第 1 步:克隆项目

git clone https://github.com/GUGEGEBAIDU/fakabot.git
cd fakabot

第 2 步:配置文件

# 复制配置示例
cp config.json.example config.json

# 编辑配置
vim config.json

必须填写的内容

{
  "BOT_TOKEN": "你的Bot Token",  // 从 @BotFather 获取
  "ADMIN_ID": 123456789,         // 你的 Telegram ID(从 @userinfobot 获取)
  "DOMAIN": "https://你的域名.com",  // 可选,没有域名可以留空
  "PAYMENTS": {
    // 支付配置(后续配置)
  }
}

获取 Bot Token

  1. @BotFather
  2. 发送 /newbot
  3. 按提示创建机器人
  4. 获取 Token

获取管理员 ID

  1. @userinfobot
  2. 发送任意消息
  3. 获取你的 ID

第 3 步:保存授权码(重要!)

# 把授权码完整复制进去
echo "你的授权码" > license.key

# 示例:
echo "M0001|1738310400|abc123def456..." > license.key

注意

  • ✅ 授权码必须完整,不要有多余的空格或换行
  • ✅ 文件名必须是 license.key
  • ✅ 文件位置在项目根目录

第 4 步:启动服务

# 使用 Docker Compose 启动
docker-compose up -d

第 5 步:验证运行

# 查看日志
docker-compose logs -f

# 应该看到:
# ============================================================
# ✅ 授权验证通过
# 📝 客户ID: M0001
# 📅 到期时间: 2025-02-17
# ⏰ 剩余天数: 30 天
# ============================================================

第 6 步:测试机器人

在 Telegram 搜索你的机器人,发送 /start

如果看到欢迎消息,说明部署成功! 🎉


🔄 续费教程

💡 适用于:授权码快到期或已过期,需要续费

重要:续费只需要替换授权码,所有数据都会保留!

第 1 步:联系客服续费

联系 @sonhshu,选择续费套餐:

套餐 价格 优惠
月卡 50 USDT -
季卡 135 USDT 10%
年卡 510 USDT 15%

第 2 步:支付并获取新授权码

支付后,你会收到一个文件:续费授权码_M0001_xxx.txt

文件内容示例:

客户ID: M0001
新授权码: M0001|1740902400|def456...
续费时长: 30 天
新到期日期: 2025-03-19

第 3 步:SSH 登录服务器

ssh root@你的服务器IP

第 4 步:进入项目目录

cd fakabot

第 5 步:替换授权码

# 方法 1:直接输入
echo "新的授权码" > license.key

# 示例:
echo "M0001|1740902400|def456..." > license.key

# 方法 2:使用编辑器
vim license.key
# 删除旧授权码,粘贴新授权码,保存退出

第 6 步:重启服务

docker-compose restart

第 7 步:验证续费

# 查看日志
docker-compose logs -f

# 应该看到:
# ============================================================
# ✅ 授权验证通过
# 📝 客户ID: M0001
# 📅 到期时间: 2025-03-19  ← 新的到期时间
# ⏰ 剩余天数: 30 天
# ============================================================

如果看到新的到期时间,说明续费成功! 🎉

✅ 续费后数据保留情况

以下数据全部保留

  • ✅ 所有商品配置
  • ✅ 所有订单记录
  • ✅ 所有客户数据
  • ✅ config.json 配置
  • ✅ 数据库文件

不需要重新配置任何东西!


方式一:Docker 一键部署(推荐)⭐

最简单的部署方式,5 分钟搞定!

# 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 命令

# 启动服务
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

第 2 步:准备服务器

推荐服务商:

  • 阿里云轻量应用服务器(¥24/月)
  • 腾讯云轻量应用服务器(¥25/月)
  • Vultr($5/月)
  • DigitalOcean($6/月)

配置建议:1核2GB,20GB 硬盘

第 3 步:克隆项目

# SSH 登录服务器
ssh root@你的服务器IP

# 克隆项目
git clone https://github.com/GUGEGEBAIDU/fakabot.git
cd fakabot

第 4 步:安装依赖

# 更新系统
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

  2. 获取管理员 ID

  3. 配置支付接口

    • 支付宝/微信:申请商户号
    • USDT:注册 TOKEN188 或柠檬支付
  4. 编辑配置文件

cp config.json.example config.json
vim config.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 步:保存授权码

echo "你的授权码" > license.key

第 7 步:启动机器人

方式 A:直接运行(测试用)

python3 bot.py

方式 B:后台运行(推荐)

nohup python3 bot.py > bot.log 2>&1 &
tail -f bot.log

方式 C:使用 systemd(最推荐)

# 创建服务文件
vim /etc/systemd/system/fakabot.service

服务文件内容:

[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

启动服务:

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(可选但推荐)

💡 说明:域名不是必须的,但强烈推荐配置。有域名可以:

  • 配置 Webhook(比轮询更高效)
  • 配置 SSL 证书(更安全)
  • 支付回调更稳定

第 1 步:购买域名

推荐域名服务商

服务商 价格 链接
阿里云 ¥50-100/年 https://wanwang.aliyun.com
腾讯云 ¥50-100/年 https://dnspod.cloud.tencent.com
Namecheap $10-15/年 https://www.namecheap.com
GoDaddy $10-15/年 https://www.godaddy.com

购买流程

  1. 访问域名服务商网站
  2. 搜索你想要的域名(例如:mybot.com
  3. 加入购物车并支付
  4. 完成实名认证(国内域名必须)

第 2 步:配置 DNS 解析

以阿里云为例

  1. 登录阿里云控制台
  2. 进入“域名”管理
  3. 点击你的域名,选择“解析”
  4. 添加解析记录:

解析配置

记录类型 主机记录 记录值 TTL
A @ 你的服务器IP 600
A www 你的服务器IP 600

示例

  • 记录类型:A
  • 主机记录:@ (代表根域名,如 mybot.com
  • 记录值:123.45.67.89 (你的服务器 IP)
  • TTL:600 (10分钟)

验证解析

# 等待 5-10 分钟后执行
ping mybot.com

# 应该显示你的服务器 IP

第 3 步:安装 SSL 证书(免费)

使用 Let's Encrypt 免费证书

# 1. 安装 Certbot
apt update
apt install certbot -y

# 2. 停止占用 80 端口的服务(如果有)
systemctl stop nginx  # 或 systemctl stop apache2

# 3. 申请证书
certbot certonly --standalone -d mybot.com -d www.mybot.com

# 4. 按提示输入邮箱地址
# 同意服务条款:Y

# 5. 证书申请成功!

证书文件位置

证书文件:/etc/letsencrypt/live/mybot.com/fullchain.pem
私钥文件:/etc/letsencrypt/live/mybot.com/privkey.pem

设置自动续期

# 测试续期
certbot renew --dry-run

# 添加定时任务(每天凌晨2点检查)
crontab -e

# 添加以下内容:
0 2 * * * certbot renew --quiet

第 4 步:配置 config.json

修改配置文件

vim config.json

更新 DOMAIN 字段

{
  "BOT_TOKEN": "...",
  "ADMIN_ID": 123456789,
  "DOMAIN": "https://mybot.com",  // 改成你的域名,注意使用 https://
  ...
}

第 5 步:配置 Webhook(可选)

Webhook 比轮询更高效

config.json 中添加:

{
  "BOT_TOKEN": "...",
  "DOMAIN": "https://mybot.com",
  "USE_WEBHOOK": true,
  "WEBHOOK_PATH": "/webhook/telegram",
  "WEBHOOK_PORT": 58002
}

重启服务

docker-compose restart

配置 Nginx 反向代理(推荐)

💡 作用:使用 Nginx 作为反向代理,可以:

  • 配置 SSL 证书
  • 负载均衡
  • 防火墙功能
  • 更好的性能

安装 Nginx

# Ubuntu/Debian
apt update
apt install nginx -y

# 启动 Nginx
systemctl start nginx
systemctl enable nginx

创建配置文件

# 创建配置文件
vim /etc/nginx/sites-available/fakabot

HTTP 配置(基础版)

server {
    listen 80;
    server_name mybot.com www.mybot.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;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

HTTPS 配置(完整版,推荐)

# HTTP 自动跳转 HTTPS
server {
    listen 80;
    server_name mybot.com www.mybot.com;
    return 301 https://$server_name$request_uri;
}

# HTTPS 配置
server {
    listen 443 ssl http2;
    server_name mybot.com www.mybot.com;
    
    # SSL 证书配置
    ssl_certificate /etc/letsencrypt/live/mybot.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mybot.com/privkey.pem;
    
    # SSL 优化配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    
    # 反向代理配置
    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;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # 超时设置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
    
    # Webhook 配置(如果使用)
    location /webhook/telegram {
        proxy_pass http://127.0.0.1:58002;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

启用配置

# 创建软链接
ln -s /etc/nginx/sites-available/fakabot /etc/nginx/sites-enabled/

# 测试配置
nginx -t

# 重启 Nginx
systemctl restart nginx

验证配置

# 访问你的域名
curl https://mybot.com

# 应该返回机器人的响应

### 配置 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

数据备份

# 备份数据库
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

支付方式: USDT (TRC20)

TDZM5DSSq8SrB8QTSBHyNwrcTswtCjKs9t

💡 支付后请提供交易哈希和 Telegram 用户名,10 分钟内开通授权


❓ 常见问题

购买相关

Q: 可以试用吗?
A: 建议先购买月付(50 USDT)试用一个月,满意后再升级年付。

Q: 授权码会过期吗?
A: 是的,月付30天,季付90天,年付365天。到期前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: 当前版本不支持,后续版本会添加。


🔒 授权保护

本项目采用内置授权验证,代码中嵌入了授权检查逻辑。

无法绕过的原因

  • ✅ 授权检查嵌入在每个文件中
  • ✅ 删除授权检查会导致程序崩溃
  • ✅ 授权码采用签名验证,无法伪造
  • ✅ 破解成本远高于购买价格

📞 联系我们


⚠️ 免责声明

本项目仅供学习和合法商业用途使用。

使用本项目即表示您同意:

  • ✅ 遵守所在国家/地区的法律法规
  • ✅ 仅用于合法的商业用途
  • ✅ 对使用本项目产生的任何后果自行负责
  • ✅ 不侵犯他人合法权益

开发者声明:

  • 📢 本项目开发者不对用户的使用行为负责
  • 📢 不对因使用本项目造成的任何损失负责
  • 📢 保留随时停止服务和撤销授权的权利
  • 📢 保留拒绝向任何用户提供服务的权利

明确禁止用途:

  • ❌ 赌博、色情等非法内容销售
  • ❌ 侵犯知识产权的内容分发
  • ❌ 诈骗、传销等违法行为
  • ❌ 洗钱、非法资金转移
  • ❌ 其他违反法律法规的行为

合法用途示例:

  • ✅ 在线课程、教育内容销售
  • ✅ 正版软件授权码销售
  • ✅ 会员订阅服务
  • ✅ 数字艺术品、音乐销售
  • ✅ 电子书、文档资料销售

如发现用户将本项目用于非法用途,开发者将立即终止服务并配合相关部门调查。


📄 许可证

Commercial License - 商业许可证

本项目采用商业许可证:

允许:

  • ✅ 个人学习和研究
  • ✅ 购买授权后的合法商业使用
  • ✅ 在授权范围内的修改和定制

禁止:

  • ❌ 未经授权的商业使用
  • ❌ 二次销售或分发授权码
  • ❌ 移除或修改授权验证系统
  • ❌ 用于任何非法用途

授权说明:

  • 授权码仅限购买者本人使用
  • 不可转让、出租或共享
  • 违反许可协议将导致授权立即失效
  • 开发者保留追究法律责任的权利

版权所有 © 2025 Fakabot Team. 保留所有权利。

详见 服务条款


专业的 Telegram 自动发卡解决方案

Made with ❤️ by Fakabot Team

开始使用 · 查看演示 · 联系客服