From 87f7b876d4baa03e97ebe5654d26684bb44774c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B0=B7=E6=AD=8C=E4=B8=AA=E7=99=BE=E5=BA=A6?= Date: Sat, 18 Oct 2025 15:21:20 +0800 Subject: [PATCH] Add detailed first-time setup and renewal tutorials --- README.md | 180 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 180 insertions(+) diff --git a/README.md b/README.md index 09e4880..ce9eb8c 100644 --- a/README.md +++ b/README.md @@ -161,6 +161,186 @@ ## 🚀 快速开始 +### 🎉 首次使用教程 + +> 💡 **适用于**：刚购买授权码，第一次部署机器人 + +#### 第 1 步：克隆项目 + +```bash +git clone https://github.com/GUGEGEBAIDU/fakabot.git +cd fakabot +``` + +#### 第 2 步：配置文件 + +```bash +# 复制配置示例 +cp config.json.example config.json + +# 编辑配置 +vim config.json +``` + +**必须填写的内容**： + +```json +{ + "BOT_TOKEN": "你的Bot Token", // 从 @BotFather 获取 + "ADMIN_ID": 123456789, // 你的 Telegram ID（从 @userinfobot 获取） + "DOMAIN": "https://你的域名.com", // 可选，没有域名可以留空 + "PAYMENTS": { + // 支付配置（后续配置） + } +} +``` + +**获取 Bot Token**： +1. 找 [@BotFather](https://t.me/BotFather) +2. 发送 `/newbot` +3. 按提示创建机器人 +4. 获取 Token + +**获取管理员 ID**： +1. 找 [@userinfobot](https://t.me/userinfobot) +2. 发送任意消息 +3. 获取你的 ID + +#### 第 3 步：保存授权码（重要！） + +```bash +# 把授权码完整复制进去 +echo "你的授权码" > license.key + +# 示例： +echo "M0001|1738310400|abc123def456..." > license.key +``` + +**注意**： +- ✅ 授权码必须完整，不要有多余的空格或换行 +- ✅ 文件名必须是 `license.key` +- ✅ 文件位置在项目根目录 + +#### 第 4 步：启动服务 + +```bash +# 使用 Docker Compose 启动 +docker-compose up -d +``` + +#### 第 5 步：验证运行 + +```bash +# 查看日志 +docker-compose logs -f + +# 应该看到： +# ============================================================ +# ✅ 授权验证通过 +# 📝 客户ID: M0001 +# 📅 到期时间: 2025-02-17 +# ⏰ 剩余天数: 30 天 +# ============================================================ +``` + +#### 第 6 步：测试机器人 + +在 Telegram 搜索你的机器人，发送 `/start` + +**如果看到欢迎消息，说明部署成功！** 🎉 + +--- + +### 🔄 续费教程 + +> 💡 **适用于**：授权码快到期或已过期，需要续费 + +**重要：续费只需要替换授权码，所有数据都会保留！** ✅ + +#### 第 1 步：联系客服续费 + +联系 [@sonhshu](https://t.me/sonhshu)，选择续费套餐： + +| 套餐 | 价格 | 优惠 | +|------|------|------| +| 月卡 | 50 USDT | - | +| 季卡 | 135 USDT | 10% | +| 年卡 | 510 USDT | 15% | + +#### 第 2 步：支付并获取新授权码 + +支付后，你会收到一个文件：`续费授权码_M0001_xxx.txt` + +文件内容示例： +``` +客户ID: M0001 +新授权码: M0001|1740902400|def456... +续费时长: 30 天 +新到期日期: 2025-03-19 +``` + +#### 第 3 步：SSH 登录服务器 + +```bash +ssh root@你的服务器IP +``` + +#### 第 4 步：进入项目目录 + +```bash +cd fakabot +``` + +#### 第 5 步：替换授权码 + +```bash +# 方法 1：直接输入 +echo "新的授权码" > license.key + +# 示例： +echo "M0001|1740902400|def456..." > license.key + +# 方法 2：使用编辑器 +vim license.key +# 删除旧授权码，粘贴新授权码，保存退出 +``` + +#### 第 6 步：重启服务 + +```bash +docker-compose restart +``` + +#### 第 7 步：验证续费 + +```bash +# 查看日志 +docker-compose logs -f + +# 应该看到： +# ============================================================ +# ✅ 授权验证通过 +# 📝 客户ID: M0001 +# 📅 到期时间: 2025-03-19 ← 新的到期时间 +# ⏰ 剩余天数: 30 天 +# ============================================================ +``` + +**如果看到新的到期时间，说明续费成功！** 🎉 + +#### ✅ 续费后数据保留情况 + +**以下数据全部保留**： +- ✅ 所有商品配置 +- ✅ 所有订单记录 +- ✅ 所有客户数据 +- ✅ config.json 配置 +- ✅ 数据库文件 + +**不需要重新配置任何东西！** ✅ + +--- + ### 方式一：Docker 一键部署（推荐）⭐ **最简单的部署方式，5 分钟搞定！**