# 🐳 Docker 部署指南

本文档详细说明如何使用 Docker 部署 AI 股票分析系统。

## 📋 前置要求

- Docker 20.10+ 
- Docker Compose 2.0+（可选，但推荐）
- 至少 2GB 可用磁盘空间
- DeepSeek API Key

### 安装 Docker

#### Windows
1. 下载并安装 [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)
2. 启动 Docker Desktop
3. 确认安装成功：
```bash
docker --version
docker-compose --version
```

#### macOS
1. 下载并安装 [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop/)
2. 启动 Docker Desktop
3. 确认安装成功：
```bash
docker --version
docker-compose --version
```

#### Linux
```bash
# Ubuntu/Debian
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl start docker
sudo systemctl enable docker

# 安装 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker --version
docker-compose --version
```

## 🚀 快速开始

### 方法一：使用 Docker Compose（推荐）

1. **克隆或下载项目**
```bash
cd /path/to/agentsstock1
```

2. **配置环境变量**
```bash
# Windows (PowerShell)
Copy-Item .env.example .env

# Linux/macOS
cp .env.example .env
```

3. **编辑 `.env` 文件，填入您的配置**
```env
DEEPSEEK_API_KEY=sk-your-actual-api-key-here
EMAIL_ENABLED=false
# ... 其他配置
```

4. **启动服务**
```bash
docker-compose up -d
```

5. **访问应用**
打开浏览器访问：http://localhost:8503

6. **查看日志**
```bash
docker-compose logs -f
```

7. **停止服务**
```bash
docker-compose down
```

### 方法二：使用 Docker 命令

1. **构建镜像**
```bash
docker build -t agentsstock1:latest .
```

2. **创建数据目录**
```bash
mkdir -p data
```

3. **运行容器**
```bash
docker run -d \
  --name agentsstock1 \
  -p 8501:8501 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/stock_analysis.db:/app/stock_analysis.db \
  -v $(pwd)/stock_monitor.db:/app/stock_monitor.db \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  agentsstock1:latest
```

**Windows PowerShell 用户请使用：**
```powershell
docker run -d `
  --name agentsstock1 `
  -p 8503:8501 `
  -v ${PWD}/data:/app/data `
  -v ${PWD}/.env:/app/.env `
  -v ${PWD}/stock_analysis.db:/app/stock_analysis.db `
  -v ${PWD}/stock_monitor.db:/app/stock_monitor.db `
  -e TZ=Asia/Shanghai `
  --restart unless-stopped `
  agentsstock1:latest
```

4. **查看日志**
```bash
docker logs -f agentsstock1
```

5. **停止容器**
```bash
docker stop agentsstock1
docker rm agentsstock1
```

## 📁 数据持久化

Docker 部署会自动挂载以下目录/文件到宿主机：

- `./data` - 临时数据目录
- `./stock_analysis.db` - 分析历史数据库
- `./stock_monitor.db` - 监测数据库
- `./.env` - 环境变量配置

**重要**：即使删除容器，这些数据也会保留在宿主机上。

## 🔧 常用命令

### Docker Compose

```bash
# 启动服务（后台运行）
docker-compose up -d

# 启动服务（前台运行，可看日志）
docker-compose up

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 查看日志
docker-compose logs -f

# 查看服务状态
docker-compose ps

# 重新构建并启动
docker-compose up -d --build

# 完全清理（包括volumes）
docker-compose down -v
```

### Docker 命令

```bash
# 查看运行中的容器
docker ps

# 查看所有容器
docker ps -a

# 查看日志
docker logs agentsstock1
docker logs -f agentsstock1  # 实时日志

# 进入容器
docker exec -it agentsstock1 bash

# 重启容器
docker restart agentsstock1

# 停止容器
docker stop agentsstock1

# 启动已停止的容器
docker start agentsstock1

# 删除容器
docker rm agentsstock1

# 删除镜像
docker rmi agentsstock1:latest

# 查看镜像
docker images

# 查看容器资源使用
docker stats agentsstock1
```

## 🐛 故障排除

### 1. 容器启动失败

**检查日志**：
```bash
docker-compose logs
# 或
docker logs agentsstock1
```

**常见原因**：
- `.env` 文件未配置或配置错误
- 端口 8501 已被占用
- Docker 资源不足

### 2. 端口被占用

修改 `docker-compose.yml` 中的端口映射：
```yaml
ports:
  - "8502:8501"  # 改为其他端口
```

或在 docker run 命令中修改：
```bash
docker run ... -p 8502:8501 ...
```

### 3. 无法访问网页

**检查容器状态**：
```bash
docker ps
```

**检查健康状态**：
```bash
docker inspect agentsstock1 | grep Health -A 10
```

**检查网络**：
```bash
# 确认端口映射
docker port agentsstock1

# 尝试从容器内访问
docker exec agentsstock1 curl http://localhost:8501
```

### 4. 数据库权限问题

Linux/macOS 用户可能遇到权限问题：
```bash
# 修改数据库文件权限
chmod 666 *.db
chmod 777 data/
```

### 5. Node.js 相关错误

如果遇到 pywencai 相关错误，进入容器检查：
```bash
docker exec -it agentsstock1 bash
node --version
npm --version
```

### 6. 内存不足

增加 Docker 可用内存（Docker Desktop → Settings → Resources）：
- 推荐至少 4GB RAM
- 推荐至少 2GB Swap

或在 docker-compose.yml 中限制：
```yaml
services:
  agentsstock:
    # ... 其他配置
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 1G
```

## 🔒 安全建议

1. **保护 .env 文件**
   - 不要提交到 Git
   - 设置适当的文件权限：`chmod 600 .env`

2. **使用 secrets（生产环境）**
```yaml
services:
  agentsstock:
    secrets:
      - deepseek_api_key
    environment:
      - DEEPSEEK_API_KEY_FILE=/run/secrets/deepseek_api_key

secrets:
  deepseek_api_key:
    file: ./secrets/deepseek_api_key.txt
```

3. **定期更新镜像**
```bash
docker-compose pull
docker-compose up -d
```

## 🌐 反向代理（可选）

如需通过域名访问，可配置 Nginx：

```nginx
server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:8501;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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
docker-compose build --no-cache  # 清除缓存重建
```

2. **多阶段构建（高级）**
可以修改 Dockerfile 使用多阶段构建减小镜像体积。

3. **资源限制**
```yaml
services:
  agentsstock:
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 2G
```

## 📝 生产环境部署建议

1. 使用环境变量管理敏感信息
2. 配置日志轮转
3. 设置健康检查和自动重启
4. 使用 Docker volumes 而非 bind mounts
5. 配置备份策略（数据库文件）
6. 使用 HTTPS（配合 Nginx/Caddy）
7. 配置防火墙规则

## 🆘 获取帮助

如遇到问题：
1. 查看日志：`docker-compose logs -f`
2. 检查容器状态：`docker ps -a`
3. 查看 GitHub Issues
4. 联系：ws3101001@126.com

---

**享受 Docker 带来的便捷部署体验！** 🚀