aiagents-stock/DEPLOYMENT_GUIDE.md

🚀 部署指南

问题解决

OpenAI库版本兼容性问题

错误信息：

Client.init() got an unexpected keyword argument 'proxies'

原因：

• OpenAI库版本过旧（1.3.0）
• 新版本API有变化，不再支持proxies参数

解决方案：

方案1：升级依赖包（推荐）

# 1. 激活虚拟环境
source venv/bin/activate  # Linux/Mac
# 或
.\venv\Scripts\Activate.ps1  # Windows

# 2. 升级openai库
pip install --upgrade openai

# 3. 或者重新安装所有依赖
pip install -r requirements.txt --upgrade

方案2：指定版本安装

pip install openai>=1.12.0

方案3：清理后重新安装

# 1. 卸载旧版本
pip uninstall openai -y

# 2. 安装新版本
pip install openai

# 3. 重新安装所有依赖
pip install -r requirements.txt

📋 完整部署流程

1. 环境准备

# 克隆项目
git clone <your-repo-url>
cd agentsstock1

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
.\venv\Scripts\Activate.ps1
# Linux/Mac:
source venv/bin/activate

2. 安装依赖

# 安装所有依赖
pip install -r requirements.txt

# 如果遇到问题，逐个安装
pip install streamlit requests pandas numpy plotly
pip install yfinance akshare openai python-dotenv
pip install pytz ta reportlab peewee schedule

3. 配置环境变量

# 复制配置文件
cp .env.example .env

# 编辑.env文件
# Windows:
notepad .env
# Linux/Mac:
nano .env

在.env文件中配置：

# DeepSeek API配置（必需）
DEEPSEEK_API_KEY=your_actual_api_key_here
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1

# 邮件通知配置（可选）
EMAIL_ENABLED=false
SMTP_SERVER=smtp.qq.com
SMTP_PORT=587
EMAIL_FROM=your_email@qq.com
EMAIL_PASSWORD=your_authorization_code
EMAIL_TO=receiver@example.com

4. 测试运行

# 本地测试
streamlit run app.py

# 指定端口
streamlit run app.py --server.port 8501

5. 服务器部署

使用Streamlit Cloud

1. 推送代码到GitHub
2. 登录 https://streamlit.io/cloud
3. 连接GitHub仓库
4. 在Settings中配置环境变量
5. 部署

使用Docker

创建Dockerfile：

FROM python:3.9-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

EXPOSE 8501

CMD ["streamlit", "run", "app.py", "--server.port=8501", "--server.address=0.0.0.0"]

构建和运行：

# 构建镜像
docker build -t stock-analysis .

# 运行容器
docker run -p 8501:8501 --env-file .env stock-analysis

使用PM2（适用于VPS）

# 安装PM2
npm install -g pm2

# 创建启动脚本 start.sh
echo "streamlit run app.py --server.port 8501" > start.sh
chmod +x start.sh

# 使用PM2启动
pm2 start start.sh --name stock-analysis

# 保存PM2配置
pm2 save
pm2 startup

🔧 常见部署问题

1. 端口被占用

错误：Address already in use

解决：

# 更换端口
streamlit run app.py --server.port 8502

2. 依赖安装失败

错误：No matching distribution found

解决：

# 升级pip
pip install --upgrade pip

# 使用国内镜像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. API连接失败

错误：Connection timeout

解决：

• 检查网络连接
• 验证API Key是否正确
• 检查BASE_URL是否正确
• 检查防火墙设置

4. 中文字体问题（PDF生成）

错误：Font not found

解决：

# Linux服务器安装中文字体
sudo apt-get install fonts-wqy-zenhei fonts-wqy-microhei

# 或手动下载字体
wget https://github.com/adobe-fonts/source-han-sans/releases/download/2.004R/SourceHanSansCN.zip
unzip SourceHanSansCN.zip -d /usr/share/fonts/
fc-cache -fv

5. 数据库权限问题

错误：Permission denied: stock_monitor.db

解决：

# 设置正确的权限
chmod 666 stock_monitor.db stock_analysis.db
chmod 777 .  # 确保当前目录可写

6. 内存不足

错误：MemoryError

解决：

# 增加系统交换空间
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 或限制Streamlit内存使用
streamlit run app.py --server.maxUploadSize 100

🔐 安全建议

1. 保护敏感信息

# 确保.env文件在.gitignore中
echo ".env" >> .gitignore

# 不要在代码中硬编码密钥
# ❌ BAD
API_KEY = "sk-xxxxx"

# ✅ GOOD
API_KEY = os.getenv("DEEPSEEK_API_KEY")

2. 配置防火墙

# 只允许特定IP访问
# UFW (Ubuntu)
sudo ufw allow from YOUR_IP to any port 8501

# iptables
sudo iptables -A INPUT -p tcp --dport 8501 -s YOUR_IP -j ACCEPT

3. 使用HTTPS

# 使用nginx反向代理
sudo apt-get install nginx

# 配置nginx
sudo nano /etc/nginx/sites-available/stock-analysis

nginx配置：

server {
    listen 80;
    server_name your-domain.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;
    }
}

4. 定期更新

# 更新依赖包
pip list --outdated
pip install --upgrade package_name

# 更新系统
sudo apt-get update && sudo apt-get upgrade

📊 性能优化

1. 启用缓存

代码中已使用@st.cache_data装饰器

2. 配置Streamlit

创建.streamlit/config.toml：

[server]
port = 8501
enableCORS = false
enableXsrfProtection = true

[browser]
gatherUsageStats = false

[client]
showErrorDetails = false

3. 使用CDN

对于静态资源使用CDN加速

🔄 更新部署

# 拉取最新代码
git pull origin main

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

# 重启服务
pm2 restart stock-analysis
# 或
docker restart stock-analysis

📝 监控和日志

查看日志

# PM2日志
pm2 logs stock-analysis

# Docker日志
docker logs stock-analysis

# Streamlit日志
tail -f ~/.streamlit/logs/*

监控性能

# 系统资源
htop

# PM2监控
pm2 monit

# Docker stats
docker stats stock-analysis

🆘 获取帮助

如果遇到其他问题：

1. 查看BUGFIX.md
2. 查看GitHub Issues
3. 检查系统日志
4. 联系技术支持

---

最后更新：2025-10-03