5.8 KiB
5.8 KiB
WPS Bot Game 部署指南
📋 前置要求
- Ubuntu 20.04+ 服务器
- Python 3.10+（建议使用conda）
- 1GB内存 + 单核CPU
- sudo权限
🚀 快速部署
1. 上传项目到服务器
# 方式1: 使用scp
scp -r WPSBotGame/ user@server:/opt/wps-bot
# 方式2: 使用git
cd /opt
git clone <your-repo-url> wps-bot
2. 运行安装脚本
cd /opt/wps-bot
chmod +x deploy/install.sh
sudo bash deploy/install.sh
安装脚本会自动完成：
- ✅ 检查环境
- ✅ 安装依赖
- ✅ 创建数据目录
- ✅ 配置systemd服务
3. 配置环境变量
# 编辑配置文件
sudo nano /opt/wps-bot/.env
# 修改Webhook URL
WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=你的密钥
4. 启动服务
# 使用管理脚本（推荐）
chmod +x deploy/manage.sh
./deploy/manage.sh start
# 或直接使用systemctl
sudo systemctl start wps-bot
sudo systemctl status wps-bot
5. 配置开机自启
./deploy/manage.sh enable
# 或
sudo systemctl enable wps-bot
🛠️ 服务管理
使用管理脚本（推荐）
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命令
# 启动服务
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
📊 监控和调试
查看系统状态
# 方式1: 通过API
curl http://localhost:8000/stats
# 方式2: 通过日志
sudo journalctl -u wps-bot | grep "memory_mb"
常用调试命令
# 查看服务是否运行
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;"
日志分析
# 查看错误日志
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
获取服务器地址
# 查看服务器公网IP
curl ifconfig.me
# 或
curl icanhazip.com
在WPS中配置
- 进入WPS群聊
- 找到webhook机器人设置
- 配置Callback URL：
http://你的服务器IP:8000/api/callback - 保存并验证（WPS会发送GET请求）
测试Callback
# 从服务器测试
curl http://localhost:8000/api/callback
# 从外部测试
curl http://你的服务器IP:8000/api/callback
🔒 安全建议
防火墙配置
# 允许8000端口
sudo ufw allow 8000/tcp
# 查看防火墙状态
sudo ufw status
使用Nginx反向代理（可选）
# 安装Nginx
sudo apt update
sudo apt install nginx
# 配置Nginx
sudo nano /etc/nginx/sites-available/wps-bot
# 添加配置（见下方）
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;
}
}
📈 性能优化
定期清理数据库
# 创建清理脚本
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
监控内存使用
# 创建监控脚本
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
🆘 故障排除
服务启动失败
# 查看详细错误
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
端口被占用
# 查看占用进程
sudo lsof -i :8000
# 杀死占用进程
sudo kill -9 <PID>
内存不足
# 查看内存使用
free -h
# 清理缓存
sudo sync && sudo sysctl -w vm.drop_caches=3
# 重启服务
./deploy/manage.sh restart
数据库锁定
# 检查数据库
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