Add files via upload

Xbox-bot使用教程.md

@@ -0,0 +1,222 @@
+# Xbox Bot 部署手册
+
+## 架构概览
+
+```
+Telegram / Surge 脚本
+        ↓
+  Cloudflare Worker（故障转移）
+   /              \
+服务器 A            服务器 B
+locvps             tkarm1
+(主)               (备)
+   \              /
+   Redis Cloud（共享数据）
+```
+
+---
+
+## 一、文件清单
+
+| 文件 | 说明 |
+|------|------|
+| `server.js` | Bot 主程序 |
+| `package.json` | Node.js 依赖 |
+| `Dockerfile` | Docker 镜像构建 |
+| `docker-compose.yml` | 容器编排（含 Redis，迁移到 Redis Cloud 后 Redis 容器可移除） |
+| `.env` | 环境变量配置 |
+| `worker.js` | Cloudflare Worker 故障转移脚本 |
+| `NewAddToCart_Web.js` | Surge 加购脚本（GitHub） |
+| `SyncXboxCloud.js` | Surge 同步脚本（GitHub） |
+| `XboxWebController.sgmodule` | Surge 模块（GitHub） |
+
+---
+
+## 二、Redis Cloud 配置
+
+### 创建数据库
+1. 注册 [Redis Cloud](https://redis.io/try-free/)
+2. 创建免费数据库：**GCP + AP East (Hong Kong)**
+3. 进入数据库详情 → Configuration
+4. 获取 **Public endpoint** 和 **Default user password**
+5. 拼接连接地址：
+   ```
+   redis://default:密码@redis-xxxxx.c1.ap-east-1-1.ec2.redns.redis-cloud.com:端口
+   ```
+
+### 测试连接
+```bash
+docker run --rm redis redis-cli -u "redis://default:密码@地址:端口" ping
+# 返回 PONG 即成功
+```
+
+---
+
+## 三、服务器部署（A 和 B 步骤相同）
+
+### 1. 上传文件
+```bash
+scp server.js package.json Dockerfile docker-compose.yml .env \
+    user@服务器IP:/opt/1panel/apps/xbox-bot/
+```
+
+### 2. 配置 .env
+```env
+BOT_TOKEN=8755879992:AAFLp9ZSD-n6ynT9X9pwyVTB1MN43H3AZNw
+ALLOWED_USER_ID=1732587552
+VIEW_TOKEN=xbox123
+WEBHOOK_SECRET=
+REDIS_URL=redis://default:密码@redis-xxxxx地址:端口   # ← Redis Cloud 地址
+PORT=3000
+```
+
+> ⚠️ 两台服务器的 REDIS_URL 必须指向同一个 Redis Cloud 实例
+
+### 3. 启动服务
+```bash
+cd /opt/1panel/apps/xbox-bot
+docker compose up -d --build
+```
+
+### 4. 查看日志
+```bash
+docker compose logs -f bot
+```
+
+---
+
+## 四、1Panel 反向代理配置
+
+两台服务器都需要配置，将域名流量转发到 bot 的 3000 端口。
+
+### 服务器 A（locvps）
+- 域名：`locvps.dragonisheep.com`
+- 类型：反向代理
+- 代理地址：`http://127.0.0.1:3000`
+
+### 服务器 B（tkarm1）
+- 域名：`tkarm1xboxbot.dragonisheep.com`
+- 类型：反向代理
+- 代理地址：`http://127.0.0.1:3000`
+
+---
+
+## 五、Cloudflare Worker 部署
+
+### 1. 修改 worker.js
+```js
+const SERVER_A = 'https://locvps.dragonisheep.com';    // 主服务器
+const SERVER_B = 'https://tkarm1xboxbot.dragonisheep.com'; // 备用服务器
+```
+
+### 2. 部署
+1. 登录 [Cloudflare Dashboard](https://dash.cloudflare.com)
+2. Workers & Pages → Create Application → Create Worker
+3. 粘贴 `worker.js` 内容 → 部署
+4. 记录 Worker 地址，如 `xbox-bot.yourname.workers.dev`
+5. 可在 Worker 设置里绑定自定义域名
+
+### 3. 设置 Telegram Webhook
+```bash
+curl "https://api.telegram.org/bot8755879992:AAFLp9ZSD-n6ynT9X9pwyVTB1MN43H3AZNw/setWebhook?url=https://Worker地址/webhook"
+```
+
+### 4. 验证 Webhook
+```bash
+curl "https://api.telegram.org/bot8755879992:AAFLp9ZSD-n6ynT9X9pwyVTB1MN43H3AZNw/getWebhookInfo"
+# 确认 url 字段是 Worker 地址，last_error_message 为空
+```
+
+---
+
+## 六、Surge 脚本配置
+
+> 脚本托管在 GitHub，修改后推送即可自动生效。
+
+### NewAddToCart_Web.js
+```js
+const REMOTE_READ_URL   = 'https://Worker地址/surge?token=xbox123';
+const REMOTE_COMMIT_URL = 'https://Worker地址/surge/commit?token=xbox123';
+```
+
+### SyncXboxCloud.js
+```js
+const readUrl   = 'https://Worker地址/surge?token=xbox123';
+const commitUrl = 'https://Worker地址/surge/commit?token=xbox123';
+```
+
+### XboxWebController.sgmodule
+无需修改，脚本地址已指向 GitHub raw 链接。
+
+---
+
+## 七、BotFather 指令设置
+
+发送给 @BotFather → `/setcommands` → 粘贴：
+
+```
+run - 执行链接队列解析
+us - 获取队列链接的美区 Surge 参数
+view_list - 查看待处理链接队列
+view_product - 查看当前 Surge 分组队列
+update_product - 覆盖更新 Surge 分组数据
+force_stop - 强制停止当前执行任务
+clear - 清空所有队列与记录
+```
+
+---
+
+## 八、故障排查
+
+### Bot 无响应
+```bash
+# 检查容器状态
+docker compose ps
+
+# 查看错误日志
+docker compose logs --tail=50 bot
+
+# 检查 Webhook 状态
+curl "https://api.telegram.org/bot<TOKEN>/getWebhookInfo"
+```
+
+### Redis 连接失败
+```bash
+# 测试连接
+docker run --rm redis redis-cli -u "redis://default:密码@地址:端口" ping
+```
+
+### 主服务器宕机切换验证
+访问 Worker 地址的 `/surge?token=xbox123`，能返回 JSON 说明 Worker 正常工作。
+
+---
+
+## 九、日常维护
+
+### 更新 server.js
+```bash
+scp server.js user@服务器IP:/opt/1panel/apps/xbox-bot/server.js
+cd /opt/1panel/apps/xbox-bot && docker compose up -d --build
+```
+> ⚠️ A 和 B 两台服务器都需要更新
+
+### 更新 Surge 脚本
+推送到 GitHub 即可，Surge 会自动拉取最新版本。
+
+### 查看 Redis 用量
+Redis Cloud Dashboard → 数据库详情 → Memory used
+> 超过 20MB 时 bot 会在每天凌晨 3 点自动清理旧缓存
+
+---
+
+## 十、关键配置速查
+
+| 项目 | 值 |
+|------|-----|
+| Bot Token | `8755879992:AAFLp9ZSD-n6ynT9X9pwyVTB1MN43H3AZNw` |
+| Allowed User ID | `1732587552` |
+| View Token | `xbox123` |
+| 服务器 A | `locvps.dragonisheep.com` |
+| 服务器 B | `tkarm1xboxbot.dragonisheep.com` |
+| Bot 端口 | `3000` |
+| Redis Cloud | GCP + AP East (Hong Kong) |