244 lines
4.2 KiB
Markdown
244 lines
4.2 KiB
Markdown
# WPS Bot Game 启动方式说明
|
|
|
|
## 🚀 多种启动方式
|
|
|
|
### 1. 命令行参数启动（推荐）
|
|
|
|
#### 基本启动
|
|
```bash
|
|
python app.py --webhook-url "https://xz.wps.cn/api/v1/webhook/send?key=your_key"
|
|
```
|
|
|
|
#### 自定义参数启动
|
|
```bash
|
|
python app.py \
|
|
--webhook-url "https://xz.wps.cn/api/v1/webhook/send?key=your_key" \
|
|
--host 0.0.0.0 \
|
|
--port 8080 \
|
|
--workers 1 \
|
|
--log-level debug
|
|
```
|
|
|
|
#### 短参数形式
|
|
```bash
|
|
python app.py -w "https://xz.wps.cn/api/v1/webhook/send?key=your_key" -p 8080 -l debug
|
|
```
|
|
|
|
### 2. 使用启动脚本
|
|
|
|
#### Linux/Mac
|
|
```bash
|
|
# 基本启动
|
|
./start.sh -w "https://xz.wps.cn/api/v1/webhook/send?key=your_key"
|
|
|
|
# 自定义参数
|
|
./start.sh -w "your_webhook_url" -p 8080 -l debug
|
|
|
|
# 查看帮助
|
|
./start.sh --help
|
|
```
|
|
|
|
#### Windows
|
|
```cmd
|
|
REM 基本启动
|
|
start.bat -w "https://xz.wps.cn/api/v1/webhook/send?key=your_key"
|
|
|
|
REM 自定义参数
|
|
start.bat -w "your_webhook_url" -p 8080 -l debug
|
|
|
|
REM 查看帮助
|
|
start.bat --help
|
|
```
|
|
|
|
### 3. 环境变量启动
|
|
|
|
#### 设置环境变量
|
|
```bash
|
|
# Linux/Mac
|
|
export WEBHOOK_URL="https://xz.wps.cn/api/v1/webhook/send?key=your_key"
|
|
export HOST="0.0.0.0"
|
|
export PORT="8080"
|
|
export LOG_LEVEL="debug"
|
|
|
|
# Windows
|
|
set WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=your_key
|
|
set HOST=0.0.0.0
|
|
set PORT=8080
|
|
set LOG_LEVEL=debug
|
|
```
|
|
|
|
#### 启动应用
|
|
```bash
|
|
python app.py
|
|
```
|
|
|
|
### 4. 配置文件启动
|
|
|
|
#### 创建配置文件
|
|
```bash
|
|
# 复制配置模板
|
|
cp config.env.example config.env
|
|
|
|
# 编辑配置文件
|
|
nano config.env
|
|
```
|
|
|
|
#### 配置文件内容
|
|
```env
|
|
WEBHOOK_URL=https://xz.wps.cn/api/v1/webhook/send?key=your_key
|
|
HOST=0.0.0.0
|
|
PORT=8080
|
|
WORKERS=1
|
|
LOG_LEVEL=debug
|
|
```
|
|
|
|
#### 启动应用
|
|
```bash
|
|
python app.py
|
|
```
|
|
|
|
## 📋 参数说明
|
|
|
|
| 参数 | 短参数 | 默认值 | 说明 |
|
|
|------|--------|--------|------|
|
|
| `--webhook-url` | `-w` | 无 | WPS Webhook URL |
|
|
| `--host` | `-H` | `0.0.0.0` | 服务器主机地址 |
|
|
| `--port` | `-p` | `11000` | 服务器端口 |
|
|
| `--workers` | 无 | `1` | 工作进程数 |
|
|
| `--log-level` | `-l` | `info` | 日志级别 |
|
|
|
|
## 🔧 生产环境部署
|
|
|
|
### 使用systemd服务
|
|
```bash
|
|
# 编辑服务文件
|
|
sudo nano /etc/systemd/system/wps-bot.service
|
|
|
|
# 服务文件内容
|
|
[Unit]
|
|
Description=WPS Bot Game
|
|
After=network.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=your_user
|
|
WorkingDirectory=/path/to/WPSBotGame
|
|
ExecStart=/usr/bin/python3 app.py --webhook-url "your_webhook_url" --port 11000
|
|
Restart=always
|
|
RestartSec=10
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
### 使用Docker
|
|
```dockerfile
|
|
FROM python:3.10-slim
|
|
|
|
WORKDIR /app
|
|
COPY requirements.txt .
|
|
RUN pip install -r requirements.txt
|
|
|
|
COPY . .
|
|
|
|
CMD ["python", "app.py", "--webhook-url", "your_webhook_url"]
|
|
```
|
|
|
|
### 使用Nginx反向代理
|
|
```nginx
|
|
server {
|
|
listen 80;
|
|
server_name your-domain.com;
|
|
|
|
location / {
|
|
proxy_pass http://127.0.0.1:11000;
|
|
proxy_set_header Host $host;
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
|
proxy_set_header X-Forwarded-Proto $scheme;
|
|
}
|
|
}
|
|
```
|
|
|
|
## 🐛 故障排除
|
|
|
|
### 1. 端口被占用
|
|
```bash
|
|
# 查看端口占用
|
|
netstat -tlnp | grep :11000
|
|
|
|
# 杀死占用进程
|
|
sudo kill -9 PID
|
|
|
|
# 或使用其他端口
|
|
python app.py --port 8080
|
|
```
|
|
|
|
### 2. 权限问题
|
|
```bash
|
|
# 给启动脚本执行权限
|
|
chmod +x start.sh
|
|
|
|
# 检查文件权限
|
|
ls -la start.sh
|
|
```
|
|
|
|
### 3. 依赖问题
|
|
```bash
|
|
# 检查Python版本
|
|
python --version
|
|
|
|
# 安装依赖
|
|
pip install -r requirements.txt
|
|
|
|
# 检查依赖
|
|
python -c "import fastapi, uvicorn"
|
|
```
|
|
|
|
### 4. 网络问题
|
|
```bash
|
|
# 测试Webhook URL
|
|
curl -X POST "your_webhook_url" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"msg_type": "text", "content": {"text": "test"}}'
|
|
|
|
# 检查防火墙
|
|
sudo ufw status
|
|
sudo ufw allow 11000
|
|
```
|
|
|
|
## 📊 监控和日志
|
|
|
|
### 查看日志
|
|
```bash
|
|
# 实时查看日志
|
|
tail -f /var/log/wps-bot.log
|
|
|
|
# 查看系统日志
|
|
journalctl -u wps-bot -f
|
|
|
|
# 查看错误日志
|
|
grep ERROR /var/log/wps-bot.log
|
|
```
|
|
|
|
### 健康检查
|
|
```bash
|
|
# 检查服务状态
|
|
curl http://localhost:11000/health
|
|
|
|
# 检查统计信息
|
|
curl http://localhost:11000/stats
|
|
```
|
|
|
|
### 性能监控
|
|
```bash
|
|
# 查看进程状态
|
|
ps aux | grep python
|
|
|
|
# 查看内存使用
|
|
free -h
|
|
|
|
# 查看磁盘使用
|
|
df -h
|
|
```
|