223 lines
5.4 KiB
Markdown
223 lines
5.4 KiB
Markdown
# 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) |
|