股票分析系统 (Stock Analysis System)

简介

基于 https://github.com/DR-lin-eng/stock-scanner ( lanzhihong6/stock-scanner ) 二次修改，感谢原作者

📖 详细部署指南: 如需了解多种部署方案（单容器、微服务、开发环境等），请参考 DEPLOYMENT_GUIDE.md

镜像版本和说明

版本（docker tag）	变更内容
v0.2.23	修正多容器版本的前端容器编译问题。
v0.2.22	加上持仓，且允许在AI分析中使用和提出建议。
v0.2.21	修正网页上配置API的bug，优化token用量统计。
v0.2.20	多套API配置的支持，即可使用多个API供应商，在前端切换。
v0.2.19	增加token usage。
v0.2.18	避免弹出浏览器的密码管理器。
v0.2.17	优化分析过程展示，修正截图。
v0.2.16	加上多角色分析模式。
v0.2.15	修复登陆界面。加上mysql支持。
v0.2.10	新界面稳定性问题修复
v0.2.6	优化界面，更加紧凑
v0.2.5	重构界面支持tab分析
v0.2.4	修正A股分析的时候'date'出错。
v0.2.3	加上数据库迁移。
v0.2.2-SNAPSHOT	加上AI对话。
v0.2.1-SNAPSHOT	记录分析历史，可直接从历史中恢复分析结果
v0.2.0-SNAPSHOT	增加用户系统，配置 后默认用demo/demo登陆
v0.1.2	增加K线/布林带；支持截图分享

说明：

1. -SNAPSHOT 是测试版，不会打到latest。
2. 数据库默认在data/stock_scanner.db目录下，默认建议启用用户(ENABLE_USER_SYSTEM=true)。
3. 系统支持自动数据库迁移，当仍然需要用户升级前自行备份数据。

数据库迁移

系统支持自动数据库迁移，尽量确保升级时数据安全：

自动迁移

• 应用启动时自动检查并运行迁移
• 自动备份数据库到 .backup.YYYYMMDD_HHMMSS 文件
• 支持版本控制和迁移历史记录

手动迁移

# 查看迁移状态
python manage_migrations.py status

# 运行迁移到最新版本
python manage_migrations.py migrate --latest

# 运行迁移到指定版本
python manage_migrations.py migrate --version 3

# 不备份数据库运行迁移
python manage_migrations.py migrate --latest --no-backup

迁移历史

• v1: 初始数据库结构 (用户、收藏、分析历史)
• v2: 添加对话功能表
• v3: 添加用户设置表
• v4: 为分析历史添加AI输出和图表数据字段

Docker镜像一键部署

Note

对于在 Synology NAS 等特定设备上的部署，请参考我们的 Synology NAS 部署指南。

观看 Stock Scanner 演示视频 (在新窗口打开)

# 拉取最新版本
docker pull heyfluke/stock-scanner:latest

# 启动主应用容器
docker run -d \
  --name stock-scanner-app \
  --network stock-scanner-network \
  -p 8888:8888 \
  -v "$(pwd)/logs:/app/logs" \
  -v "$(pwd)/data:/app/data" \
  -e API_KEY="你的API密钥" \
  -e API_URL="你的API地址" \
  -e API_MODEL="你的API模型" \
  -e API_TIMEOUT="60" \
  -e ANNOUNCEMENT_TEXT="你的公告内容" \
  --restart unless-stopped \
  heyfluke/stock-scanner:latest
  
# 运行Nginx容器
docker run -d \
  --name stock-scanner-nginx \
  --network stock-scanner-network \
  -p 80:80 \
  -p 443:443 \
  -v "$(pwd)/nginx/nginx.conf:/etc/nginx/conf.d/default.conf" \
  -v "$(pwd)/nginx/logs:/var/log/nginx" \
  -v "$(pwd)/nginx/ssl:/etc/nginx/ssl" \
  --restart unless-stopped \
  nginx:stable-alpine

针对API_URL处理兼容更多的api地址，规则与Cherry Studio一致， /结尾忽略v1版本，#结尾强制使用输入地址。
API_URL 处理逻辑说明：
1. 当 API_URL 以 / 结尾时直接追加 chat/completions，保留原有版本号：
  示例：
   输入: https://ark.cn-beijing.volces.com/api/v3/
   输出: https://ark.cn-beijing.volces.com/api/v3/chat/completions
2. 当 API_URL 以 # 结尾时强制使用当前链接：
  示例：
   输入: https://ark.cn-beijing.volces.com/api/v3/chat/completions#
   输出: https://ark.cn-beijing.volces.com/api/v3/chat/completions
3. 当 API_URL 不以 / 结尾时使用默认版本号 v1：
  示例：
   输入: https://ark.cn-beijing.volces.com/api
   输出: https://ark.cn-beijing.volces.com/api/v1/chat/completions

默认8888端口，部署完成后访问 http://你的域名或ip:8888 即可使用

使用Nginx反向代理

项目已集成Nginx服务，可以通过80端口(HTTP)和443端口(HTTPS)访问应用
使用docker-compose启动：

# 克隆仓库
git clone https://github.com/heyfluke/stock-scanner.git
cd stock-scanner

# 创建.env文件并填写必要的环境变量
cat > .env << EOL
API_KEY=你的API密钥
API_URL=你的API地址
API_MODEL=你的API模型
API_TIMEOUT=超时时间(默认60秒)
ANNOUNCEMENT_TEXT=公告文本
EOL

# 请注意API_URL要有`/`结尾，例如：API_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/

# 创建SSL证书目录
mkdir -p nginx/ssl

# 生成自签名SSL证书（仅用于测试环境）
openssl req -x509 -nodes -days 365 \
  -newkey rsa:2048 \
  -keyout nginx/ssl/privkey.pem \
  -out nginx/ssl/fullchain.pem \
  -subj "/CN=localhost" \
  -addext "subjectAltName=DNS:localhost,IP:127.0.0.1"

# 启动服务
docker-compose up -d

使用自己的SSL证书

如果您有自己的SSL证书，可以替换自签名证书：

1. 将您的证书文件放在 nginx/ssl/ 目录下
2. 确保证书文件命名为 fullchain.pem，私钥文件命名为 privkey.pem
3. 重启服务: docker-compose restart nginx

相关参考：免费泛域名 SSL 证书申请及自动续期（使用 1Panel 面板）

多API key的支持

试验性功能：目前面向开发者，因为.env配置对普通用户来说还比较难。 可在数据库中添加多个API key，然后在界面上随时切换不同的服务商。 添加办法：

# 添加配置
python manage_api_configs.py --add \
  --config-name "OpenAI-GPT4" \
  --url "https://api.openai.com/v1/" \
  --key "sk-xxx" \
  --model "gpt-4o" \
  --description "OpenAI GPT-4o"

# 列出配置
python manage_api_configs.py --list

# 删除配置
python manage_api_configs.py --delete --config-name "OpenAI-GPT4"

Github Actions 部署

环境变量	说明
DOCKERHUB_USERNAME	Docker Hub用户名
DOCKERHUB_TOKEN	Docker Hub访问令牌
SERVER_HOST	部署服务器地址
SERVER_USERNAME	服务器用户名
SSH_PRIVATE_KEY	SSH私钥
DEPLOY_PATH	部署路径
SLACK_WEBHOOK	Slack通知Webhook（可选）

注意事项 (Notes)

• 股票分析仅供参考，不构成投资建议
• 使用前请确保网络连接正常
• 建议在实盘前充分测试

贡献 (Contributing)

欢迎提交 issues 和 pull requests！

许可证 (License)

[待添加具体许可证信息]

免责声明 (Disclaimer)

本系统仅用于学习和研究目的，投资有风险，入市需谨慎。