# 部署文档

本文档介绍如何部署A股AI分析Agent系统到生产环境。

## 部署方式

### 方式一：本地部署

#### 1. 系统要求

- 操作系统：Linux/macOS/Windows
- Python 3.9+
- Redis 6.0+（可选）
- 内存：至少2GB
- 磁盘：至少1GB

#### 2. 安装步骤

```bash
# 1. 克隆代码
git clone <repository_url>
cd Stock_Agent

# 2. 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. 安装依赖
cd backend
pip install -r requirements.txt

# 4. 配置环境变量
cp ../.env.example ../.env
# 编辑.env文件，填写必要的配置

# 5. 启动Redis（可选）
redis-server

# 6. 启动应用
python -m app.main
```

#### 3. 使用进程管理器

**使用Supervisor（推荐）**

创建配置文件 `/etc/supervisor/conf.d/stock_agent.conf`：

```ini
[program:stock_agent]
directory=/path/to/Stock_Agent/backend
command=/path/to/venv/bin/python -m app.main
user=your_user
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/stock_agent.log
```

启动服务：

```bash
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start stock_agent
```

**使用systemd**

创建服务文件 `/etc/systemd/system/stock_agent.service`：

```ini
[Unit]
Description=Stock Agent Service
After=network.target

[Service]
Type=simple
User=your_user
WorkingDirectory=/path/to/Stock_Agent/backend
Environment="PATH=/path/to/venv/bin"
ExecStart=/path/to/venv/bin/python -m app.main
Restart=always

[Install]
WantedBy=multi-user.target
```

启动服务：

```bash
sudo systemctl daemon-reload
sudo systemctl enable stock_agent
sudo systemctl start stock_agent
```

### 方式二：Docker部署

#### 1. 创建Dockerfile

在项目根目录创建 `Dockerfile`：

```dockerfile
FROM python:3.9-slim

WORKDIR /app

# 安装依赖
COPY backend/requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制代码
COPY backend/ ./backend/
COPY frontend/ ./frontend/
COPY .env .env

# 暴露端口
EXPOSE 8000

# 启动应用
CMD ["python", "-m", "backend.app.main"]
```

#### 2. 创建docker-compose.yml

```yaml
version: '3.8'

services:
  redis:
    image: redis:6-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data

  stock_agent:
    build: .
    ports:
      - "8000:8000"
    environment:
      - REDIS_HOST=redis
      - REDIS_PORT=6379
    env_file:
      - .env
    depends_on:
      - redis
    volumes:
      - ./backend:/app/backend
      - ./frontend:/app/frontend
      - ./stock_agent.db:/app/stock_agent.db

volumes:
  redis_data:
```

#### 3. 启动服务

```bash
# 构建镜像
docker-compose build

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down
```

### 方式三：云服务器部署

#### 阿里云/腾讯云部署

1. **购买云服务器**
   - 配置：2核4GB内存
   - 系统：Ubuntu 20.04 LTS

2. **安全组配置**
   - 开放8000端口（HTTP）
   - 开放22端口（SSH）

3. **安装环境**

```bash
# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装Python
sudo apt install python3.9 python3.9-venv python3-pip -y

# 安装Redis
sudo apt install redis-server -y
sudo systemctl enable redis-server
sudo systemctl start redis-server

# 安装Nginx（可选，用于反向代理）
sudo apt install nginx -y
```

4. **部署应用**

按照"本地部署"步骤进行。

5. **配置Nginx反向代理**

创建配置文件 `/etc/nginx/sites-available/stock_agent`：

```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;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /static {
        alias /path/to/Stock_Agent/frontend;
    }
}
```

启用配置：

```bash
sudo ln -s /etc/nginx/sites-available/stock_agent /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
```

6. **配置HTTPS（推荐）**

使用Let's Encrypt免费证书：

```bash
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your_domain.com
```

## 生产环境配置

### 1. 环境变量配置

生产环境的 `.env` 配置：

```env
# API密钥
TUSHARE_TOKEN=your_production_token
ZHIPUAI_API_KEY=your_production_key

# Redis
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password

# 数据库（生产环境建议使用PostgreSQL）
DATABASE_URL=postgresql://user:password@localhost/stock_agent

# API设置
API_HOST=0.0.0.0
API_PORT=8000
DEBUG=False

# 安全
SECRET_KEY=your_very_long_random_secret_key_here
RATE_LIMIT=100/minute

# CORS（根据实际域名配置）
CORS_ORIGINS=https://your_domain.com
```

### 2. 数据库迁移到PostgreSQL

安装PostgreSQL：

```bash
sudo apt install postgresql postgresql-contrib -y
```

创建数据库：

```sql
sudo -u postgres psql
CREATE DATABASE stock_agent;
CREATE USER stock_user WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE stock_agent TO stock_user;
\q
```

更新 `.env` 中的 `DATABASE_URL`。

### 3. 性能优化

**Redis配置优化**

编辑 `/etc/redis/redis.conf`：

```conf
maxmemory 256mb
maxmemory-policy allkeys-lru
save 900 1
save 300 10
save 60 10000
```

**应用配置优化**

在 `config.py` 中调整：

```python
# 增加工作进程数
workers = multiprocessing.cpu_count() * 2 + 1

# 调整超时时间
timeout = 120
```

### 4. 监控和日志

**日志配置**

在 `utils/logger.py` 中配置日志文件：

```python
logger = setup_logger(
    name="stock_agent",
    level=logging.INFO,
    log_file="/var/log/stock_agent/app.log"
)
```

**日志轮转**

创建 `/etc/logrotate.d/stock_agent`：

```
/var/log/stock_agent/*.log {
    daily
    rotate 7
    compress
    delaycompress
    notifempty
    create 0640 your_user your_user
    sharedscripts
}
```

**监控工具**

推荐使用：
- Prometheus + Grafana（系统监控）
- Sentry（错误追踪）
- ELK Stack（日志分析）

## 备份和恢复

### 数据库备份

**SQLite备份**

```bash
# 备份
cp stock_agent.db stock_agent_backup_$(date +%Y%m%d).db

# 恢复
cp stock_agent_backup_20240101.db stock_agent.db
```

**PostgreSQL备份**

```bash
# 备份
pg_dump -U stock_user stock_agent > backup_$(date +%Y%m%d).sql

# 恢复
psql -U stock_user stock_agent < backup_20240101.sql
```

### Redis备份

```bash
# 备份
redis-cli SAVE
cp /var/lib/redis/dump.rdb /backup/redis_$(date +%Y%m%d).rdb

# 恢复
sudo systemctl stop redis
cp /backup/redis_20240101.rdb /var/lib/redis/dump.rdb
sudo systemctl start redis
```

## 安全加固

### 1. 防火墙配置

```bash
# 使用ufw
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
```

### 2. 限制API访问

在Nginx中配置限流：

```nginx
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;

location /api/ {
    limit_req zone=api_limit burst=20 nodelay;
    proxy_pass http://127.0.0.1:8000;
}
```

### 3. 定期更新

```bash
# 更新系统
sudo apt update && sudo apt upgrade -y

# 更新Python依赖
pip install --upgrade -r requirements.txt
```

## 故障排查

### 常见问题

1. **服务无法启动**
   - 检查端口是否被占用：`lsof -i :8000`
   - 查看日志：`tail -f /var/log/stock_agent.log`

2. **Redis连接失败**
   - 检查Redis状态：`sudo systemctl status redis`
   - 测试连接：`redis-cli ping`

3. **数据库错误**
   - 检查数据库连接：`psql -U stock_user -d stock_agent`
   - 查看数据库日志：`sudo tail -f /var/log/postgresql/postgresql-*.log`

4. **API响应慢**
   - 检查Redis缓存是否正常
   - 查看系统资源：`htop`
   - 分析慢查询日志

## 性能测试

使用Apache Bench进行压力测试：

```bash
# 安装ab
sudo apt install apache2-utils -y

# 测试API
ab -n 1000 -c 50 http://localhost:8000/api/stock/quote/600519
```

## 更新部署

### 零停机更新

使用蓝绿部署或滚动更新：

```bash
# 1. 拉取最新代码
git pull origin main

# 2. 安装新依赖
pip install -r requirements.txt

# 3. 运行数据库迁移（如有）
# python manage.py migrate

# 4. 重启服务
sudo supervisorctl restart stock_agent
# 或
sudo systemctl restart stock_agent
```

## 联系支持

如遇到部署问题，请提交Issue或联系技术支持。