🚀 量化投资实训平台安装包

这是一个完整的量化投资实训平台安装包，包含 JupyterHub、AI 评估引擎和所有必要的服务组件。

📋 安装步骤

第一步：安装 Clash 代理

sudo bash install_clash.sh

• 安装并启动 clashmeta 代理服务
• 配置网络代理，确保能够访问外网资源
• 注意：必须使用 sudo 权限运行

第二步：安装 Miniconda 和 JupyterHub

bash install_conda_jupyterhub.sh

• 下载并安装 Miniconda3
• 安装 JupyterHub、JupyterLab 和 Notebook
• 配置 PAM 认证和系统权限
• 自动接受 conda 服务条款

⚠️ 重要：安装完成后必须激活环境

source ~/.bashrc

第三步：安装 Ollama AI 引擎

bash install_ollama.sh

• 使用 clashmeta 代理安装 Ollama
• 自动下载 CodeLlama 模型
• 创建启动和停止脚本
• 配置 AI 评估服务

🎯 安装完成后

安装 Python 依赖

cd quant_platform
bash install_dependencies.sh

启动所有服务

bash start_all_services.sh

访问地址

• 主平台: http://localhost:8000
• Dashboard: http://localhost:8082/dashboard
• Student Task: http://localhost:8084/task
• Uploads: http://localhost:8085/uploads
• Database: http://localhost:8086/db_browser
• AI Model Management: http://localhost:8087/ai_models

停止所有服务

bash stop_all_services.sh

🔧 系统要求

• Ubuntu 18.04+ 或 CentOS 7+
• 至少 4GB RAM
• 至少 10GB 可用磁盘空间
• 网络连接（通过代理）

📁 目录结构

install_quant_platform/
├── install_clash.sh              # Clash 代理安装脚本
├── install_conda_jupyterhub.sh   # Miniconda + JupyterHub 安装脚本
├── install_ollama.sh             # Ollama AI 引擎安装脚本
├── clash/                        # Clash 配置文件
│   ├── clash.yaml               # 代理配置文件
│   ├── mihomo/                  # Mihomo 代理组件
│   └── clashmeta                # ClashMeta 可执行文件
├── quant_platform/               # 核心平台文件
│   ├── start_all_services.sh    # 启动所有服务
│   ├── stop_all_services.sh     # 停止所有服务
│   ├── start_jupyterhub.sh      # 启动 JupyterHub
│   ├── start_dashboard.sh       # 启动 Dashboard
│   ├── start_student_task.sh    # 启动学生任务服务
│   ├── start_uploads.sh         # 启动上传管理服务
│   ├── start_database_browser.sh # 启动数据库浏览器
│   ├── start_ai_model_management.sh # 启动 AI 模型管理服务
│   ├── install_dependencies.sh  # 安装 Python 依赖
│   ├── jupyterhub_config.py     # JupyterHub 配置
│   ├── database_manager.py      # 数据库管理
│   ├── dashboard_service.py     # Dashboard 服务
│   ├── student_task_service.py  # 学生任务服务
│   ├── uploads_service.py       # 上传管理服务
│   ├── database_browser_service.py # 数据库浏览器服务
│   ├── ai_model_management_service.py # AI 模型管理服务
│   ├── admin_navigation.html    # 管理员导航页面
│   └── quant_platform.db        # SQLite 数据库
└── README.md                     # 本说明文件

🚨 注意事项

1. 安装顺序：必须按照 1→2→3 的顺序安装
2. 权限要求：第一步需要 sudo 权限，其他步骤使用普通用户权限
3. 环境激活：conda 安装后必须运行 source ~/.bashrc 激活环境
4. 依赖安装：启动服务前必须先安装 Python 依赖
5. 网络要求：确保 clashmeta 代理正常运行
6. 磁盘空间：CodeLlama 模型较大，确保有足够空间
7. 系统兼容性：建议在 Ubuntu 20.04+ 上运行

🔍 故障排除

Clash 代理问题

# 检查代理状态
pgrep -f clashmeta
netstat -tlnp | grep 7890

# 重启代理
sudo bash install_clash.sh

Conda 环境问题

# 激活环境
source ~/miniconda3/etc/profile.d/conda.sh
conda activate base

# 重新安装依赖
bash install_conda_jupyterhub.sh

Ollama 服务问题

# 检查服务状态
pgrep -f "ollama serve"
curl http://localhost:11434/api/tags

# 重启服务
~/start_ollama.sh
~/stop_ollama.sh

📞 技术支持

如果遇到安装问题，请检查：

1. 系统版本和权限
2. 网络连接和代理状态
3. 磁盘空间和内存
4. 安装日志输出

📝 完整安装流程示例

# 1. 安装 Clash 代理
sudo bash install_clash.sh

# 2. 安装 Miniconda 和 JupyterHub
bash install_conda_jupyterhub.sh

# 3. 激活 conda 环境
source ~/.bashrc

# 4. 安装 Ollama AI 引擎
bash install_ollama.sh

# 5. 下载 AI 模型
bash download_models.sh

# 6. 进入平台目录并安装依赖
cd quant_platform
bash install_dependencies.sh

# 7. 启动所有服务
bash start_all_services.sh

🎉 安装完成

安装完成后，您将拥有一个完整的量化投资实训平台，包括：

• 🎓 学生任务管理系统
• 📊 管理员仪表板
• 🤖 AI 驱动的代码评估
• 📁 文件上传和管理
• 🗄️ 数据库浏览和管理
• 🌐 基于 JupyterHub 的 Web 界面
• 🎛️ AI 模型管理界面

开始您的量化投资教学之旅吧！🚀