346 lines
5.8 KiB
Markdown
346 lines
5.8 KiB
Markdown
# WPS Bot Game 部署指南
|
||
|
||
## 📋 前置要求
|
||
|
||
- Ubuntu 20.04+ 服务器
|
||
- Python 3.10+（建议使用conda）
|
||
- 1GB内存 + 单核CPU
|
||
- sudo权限
|
||
|
||
## 🚀 快速部署
|
||
|
||
### 1. 上传项目到服务器
|
||
|
||
```bash
|
||
# 方式1: 使用scp
|
||
scp -r WPSBotGame/ user@server:/opt/wps-bot
|
||
|
||
# 方式2: 使用git
|
||
cd /opt
|
||
git clone <your-repo-url> wps-bot
|
||
```
|
||
|
||
### 2. 运行安装脚本
|
||
|
||
```bash
|
||
cd /opt/wps-bot
|
||
chmod +x deploy/install.sh
|
||
sudo bash deploy/install.sh
|
||
```
|
||
|
||
安装脚本会自动完成：
|
||
- ✅ 检查环境
|
||
- ✅ 安装依赖
|
||
- ✅ 创建数据目录
|
||
- ✅ 配置systemd服务
|
||
|
||
### 3. 配置环境变量
|
||
|
||
```bash
|
||
# 编辑配置文件
|
||
sudo nano /opt/wps-bot/.env
|
||
|
||
# 修改Webhook URL
|
||
WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=你的密钥
|
||
```
|
||
|
||
### 4. 启动服务
|
||
|
||
```bash
|
||
# 使用管理脚本（推荐）
|
||
chmod +x deploy/manage.sh
|
||
./deploy/manage.sh start
|
||
|
||
# 或直接使用systemctl
|
||
sudo systemctl start wps-bot
|
||
sudo systemctl status wps-bot
|
||
```
|
||
|
||
### 5. 配置开机自启
|
||
|
||
```bash
|
||
./deploy/manage.sh enable
|
||
# 或
|
||
sudo systemctl enable wps-bot
|
||
```
|
||
|
||
## 🛠️ 服务管理
|
||
|
||
### 使用管理脚本（推荐）
|
||
|
||
```bash
|
||
cd /opt/wps-bot
|
||
|
||
# 启动服务
|
||
./deploy/manage.sh start
|
||
|
||
# 停止服务
|
||
./deploy/manage.sh stop
|
||
|
||
# 重启服务
|
||
./deploy/manage.sh restart
|
||
|
||
# 查看状态
|
||
./deploy/manage.sh status
|
||
|
||
# 查看实时日志
|
||
./deploy/manage.sh logs
|
||
|
||
# 启用开机自启
|
||
./deploy/manage.sh enable
|
||
|
||
# 禁用开机自启
|
||
./deploy/manage.sh disable
|
||
|
||
# 更新代码并重启
|
||
./deploy/manage.sh update
|
||
```
|
||
|
||
### 使用systemctl命令
|
||
|
||
```bash
|
||
# 启动服务
|
||
sudo systemctl start wps-bot
|
||
|
||
# 停止服务
|
||
sudo systemctl stop wps-bot
|
||
|
||
# 重启服务
|
||
sudo systemctl restart wps-bot
|
||
|
||
# 查看状态
|
||
sudo systemctl status wps-bot
|
||
|
||
# 启用开机自启
|
||
sudo systemctl enable wps-bot
|
||
|
||
# 禁用开机自启
|
||
sudo systemctl disable wps-bot
|
||
|
||
# 查看日志
|
||
sudo journalctl -u wps-bot -f
|
||
|
||
# 查看最近100行日志
|
||
sudo journalctl -u wps-bot -n 100
|
||
|
||
# 查看今天的日志
|
||
sudo journalctl -u wps-bot --since today
|
||
```
|
||
|
||
## 📊 监控和调试
|
||
|
||
### 查看系统状态
|
||
|
||
```bash
|
||
# 方式1: 通过API
|
||
curl http://localhost:8000/stats
|
||
|
||
# 方式2: 通过日志
|
||
sudo journalctl -u wps-bot | grep "memory_mb"
|
||
```
|
||
|
||
### 常用调试命令
|
||
|
||
```bash
|
||
# 查看服务是否运行
|
||
sudo systemctl is-active wps-bot
|
||
|
||
# 查看服务是否开机自启
|
||
sudo systemctl is-enabled wps-bot
|
||
|
||
# 查看端口占用
|
||
sudo netstat -tlnp | grep 8000
|
||
|
||
# 查看进程
|
||
ps aux | grep python
|
||
|
||
# 查看数据库
|
||
sqlite3 /opt/wps-bot/data/bot.db "SELECT * FROM users;"
|
||
```
|
||
|
||
### 日志分析
|
||
|
||
```bash
|
||
# 查看错误日志
|
||
sudo journalctl -u wps-bot -p err
|
||
|
||
# 查看特定时间段的日志
|
||
sudo journalctl -u wps-bot --since "2025-10-28 10:00:00" --until "2025-10-28 11:00:00"
|
||
|
||
# 导出日志到文件
|
||
sudo journalctl -u wps-bot > /tmp/wps-bot.log
|
||
```
|
||
|
||
## 🔧 配置WPS Callback
|
||
|
||
### 获取服务器地址
|
||
|
||
```bash
|
||
# 查看服务器公网IP
|
||
curl ifconfig.me
|
||
|
||
# 或
|
||
curl icanhazip.com
|
||
```
|
||
|
||
### 在WPS中配置
|
||
|
||
1. 进入WPS群聊
|
||
2. 找到webhook机器人设置
|
||
3. 配置Callback URL：
|
||
```
|
||
http://你的服务器IP:8000/api/callback
|
||
```
|
||
4. 保存并验证（WPS会发送GET请求）
|
||
|
||
### 测试Callback
|
||
|
||
```bash
|
||
# 从服务器测试
|
||
curl http://localhost:8000/api/callback
|
||
|
||
# 从外部测试
|
||
curl http://你的服务器IP:8000/api/callback
|
||
```
|
||
|
||
## 🔒 安全建议
|
||
|
||
### 防火墙配置
|
||
|
||
```bash
|
||
# 允许8000端口
|
||
sudo ufw allow 8000/tcp
|
||
|
||
# 查看防火墙状态
|
||
sudo ufw status
|
||
```
|
||
|
||
### 使用Nginx反向代理（可选）
|
||
|
||
```bash
|
||
# 安装Nginx
|
||
sudo apt update
|
||
sudo apt install nginx
|
||
|
||
# 配置Nginx
|
||
sudo nano /etc/nginx/sites-available/wps-bot
|
||
|
||
# 添加配置（见下方）
|
||
```
|
||
|
||
Nginx配置示例：
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your-domain.com;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:8000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
}
|
||
}
|
||
```
|
||
|
||
## 📈 性能优化
|
||
|
||
### 定期清理数据库
|
||
|
||
```bash
|
||
# 创建清理脚本
|
||
cat > /opt/wps-bot/cleanup.sh << 'EOF'
|
||
#!/bin/bash
|
||
sqlite3 /opt/wps-bot/data/bot.db "DELETE FROM game_states WHERE updated_at < strftime('%s', 'now', '-7 days');"
|
||
echo "数据库清理完成"
|
||
EOF
|
||
|
||
chmod +x /opt/wps-bot/cleanup.sh
|
||
|
||
# 添加定时任务
|
||
sudo crontab -e
|
||
# 添加：每天凌晨2点清理
|
||
0 2 * * * /opt/wps-bot/cleanup.sh
|
||
```
|
||
|
||
### 监控内存使用
|
||
|
||
```bash
|
||
# 创建监控脚本
|
||
cat > /opt/wps-bot/monitor.sh << 'EOF'
|
||
#!/bin/bash
|
||
MEMORY=$(curl -s http://localhost:8000/stats | jq -r '.system.memory_mb')
|
||
echo "$(date): 内存使用 ${MEMORY}MB"
|
||
if (( $(echo "$MEMORY > 200" | bc -l) )); then
|
||
echo "警告：内存使用过高！"
|
||
fi
|
||
EOF
|
||
|
||
chmod +x /opt/wps-bot/monitor.sh
|
||
|
||
# 添加定时任务：每小时检查一次
|
||
0 * * * * /opt/wps-bot/monitor.sh >> /var/log/wps-bot-monitor.log
|
||
```
|
||
|
||
## 🆘 故障排除
|
||
|
||
### 服务启动失败
|
||
|
||
```bash
|
||
# 查看详细错误
|
||
sudo systemctl status wps-bot -l
|
||
|
||
# 查看最新日志
|
||
sudo journalctl -u wps-bot -n 50
|
||
|
||
# 检查配置文件
|
||
sudo systemctl cat wps-bot
|
||
|
||
# 手动测试启动
|
||
cd /opt/wps-bot
|
||
sudo -u ubuntu /home/ubuntu/miniconda3/envs/liubai/bin/python app.py
|
||
```
|
||
|
||
### 端口被占用
|
||
|
||
```bash
|
||
# 查看占用进程
|
||
sudo lsof -i :8000
|
||
|
||
# 杀死占用进程
|
||
sudo kill -9 <PID>
|
||
```
|
||
|
||
### 内存不足
|
||
|
||
```bash
|
||
# 查看内存使用
|
||
free -h
|
||
|
||
# 清理缓存
|
||
sudo sync && sudo sysctl -w vm.drop_caches=3
|
||
|
||
# 重启服务
|
||
./deploy/manage.sh restart
|
||
```
|
||
|
||
### 数据库锁定
|
||
|
||
```bash
|
||
# 检查数据库
|
||
sqlite3 /opt/wps-bot/data/bot.db "PRAGMA integrity_check;"
|
||
|
||
# 如果损坏，恢复数据库
|
||
mv /opt/wps-bot/data/bot.db /opt/wps-bot/data/bot.db.backup
|
||
# 重启服务会自动创建新数据库
|
||
./deploy/manage.sh restart
|
||
```
|
||
|
||
## 📞 技术支持
|
||
|
||
如有问题，请查看：
|
||
- 应用日志：`sudo journalctl -u wps-bot -f`
|
||
- 系统状态：`curl http://localhost:8000/stats`
|
||
- README：`/opt/wps-bot/README.md`
|
||
|