Ye-Yu-Mo/FundVal-Live：盘中基金估值，实时估值，基金净值

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

盘中基金估值实时更新系统——Ye-Yu-Mo/FundVal-Live 分析

项目背景与痛点

在股票市场和基金投资领域，盘中实时的基金净值信息对投资者来说至关重要。市场的波动性需要投资者在短时间内作出决策，而及时的基金净值信息可以显著提升决策效率。然而，现存的基金估值服务大多只能提供日间统计和事后更新，无法满足盘中实时的需求。因此，Ye-Yu-Mo 发起的 FundVal-Live 项目应运而生，它利用实时数据流和技术手段，提供盘中全局基金净值估值，弥补了市场空白，极大提高了投资者的信息决策效率。

核心技术揭秘

FundVal-Live 项目的核心技术在于其高效的数据处理和实时更新机制，它能够采集市场行情数据并快速计算出当前基金净值的真实估值。下面通过一张架构图来展示其架构和技术实现原理：

graph TD A[用户请求] --> B{"参数校验"} B -->|"通过"| C[数据采集] C --> D[数据清洗] D --> E{"行情分析"} E -->|"自动调用"| F[净值计算] E -->|"触发警告"| G[监控告警] F --> H[返回净值] G -->|"邮件通知"| H

技术栈和设计模式

数据采集：项目采用了定时抓取和即时推送相结合的方式，确保数据的全面覆盖和实时性。
数据清洗：考虑到实时性带来的数据噪声，采用了高效的预处理机制做好数据净化，降低后续计算负担。
行情分析：利用高性能的计算引擎，如 Kylin 或 Spark，实时分析产出基金净值。
净值计算：核心逻辑确保在计算时充分考虑到了各项实时指标，特别是市场波动的影响。
监控告警和邮件通知：实现了以规则为基础的告警机制，确保异常情况下能够快速反应并通知相关负责人。

实现原理

FundVal-Live 的设计完善了不同类型基金在市场行情波动过程中的各项数据抓取和计算工作。这些基金包括股票基金、债券基金等多种投资标的，从根本上解决了实时行情和净值估值之间的数据延迟问题。通过对数据流进行精细化管理，并利用多线程和异步处理技术，项目显著提高了处理效率和用户体验。

功能亮点与差异

相比其他基金估值系统，FundVal-Live 不仅提供了实时基金净值数据，还具备详细的基金分析报告，涵盖每一只基金的市场表现和净值变化情况。此外，项目还在算法上做了大量优化，保证计算的时间准确性和稳定性。项目中融入的监控和告警功能，帮助投资者即时了解到可能的风险与收益变化，成为其独特的技术亮点。

应用场景与落地建议

在生产环境中使用 FundVal-Live 时，必须确保后端稳定的数据源以及高效的计算服务器支持。此项目特别适用于投资机构和财务顾问，他们在提供市场情报和投资建议时需要利用更为全面、实时的数据做出专业分析。同时，系统的可扩展性和稳定性必须充分验证，以确保在多种环境下都能够平稳运行。

综合评价

优点：

实时，准确地基金净值数据。
高效的数据处理能力和计算性能。
丰富的监控告警功能，提供多维度的分析报告。
复杂而透明的数据流管理。

缺点：

数据源的限制可能导致某些非公开基金的信息无法获取。
对计算服务器的依赖性较高，成本较高。

总之，Ye-Yu-Mo/FundVal-Live 是一个强实用性且功能全面的基金估值系统，尤其在市场需求日益增长的大背景下，显现出其强大的竞争优势和应用前景。

关于

fund-analysis fund-valuation realtime-fund

GNU Affero General Public License v3.0
535 Stars
104 Forks
1 Watching

简要分析

热度分

744

价值分

352

活跃状态

活跃

GitHub

语言占比

CSS

Dockerfile

HTML

JavaScript

Kotlin

Python

Rust

Shell

Release

v2.6.06月18日
v2.5.36月11日
v2.5.26月5日
v2.5.16月5日
v2.5.06月4日

贡献者

Ye-Yu-Mo

Fundval

GitHub stars GitHub views

盘中基金实时估值与逻辑审计系统

拒绝黑箱，拒绝情绪化叙事。基于透明的持仓穿透 + 实时行情加权计算 + 硬核数学模型，让基金估值回归数学事实。

试用网址：https://fund.jasxu.dpdns.org/

警告：试用环境请勿使用真实持仓数据和 API Key

服务器内存和 CPU 性能较低，仅做使用演示

加入讨论群组

issue - 讨论群组

遇到问题？

问题排查手册 — 涵盖注册、部署、数据源、持仓计算等常见问题的完整排查指南

功能特性

实时估值：基于持仓穿透 + 实时行情加权计算，支持东方财富、养基宝、小倍养基、蛋卷（雪球）四数据源，多源 fallback 提升净值覆盖率
持仓穿透：指数/ETF 基金前十大持仓股实时行情，瀑布图 + 表格双视图，30s 自动刷新
基金 PK 对比：2-5 只基金雷达图多维对比，收益/风险/回撤/夏普一站图，结果可分享
基金排行榜：涨幅榜 / 人气榜 / 估值准度榜，分类板块筛选
大盘指数：上证、深证、创业板、科创50 实时行情，30s 自动刷新
AI 分析：接入任意 OpenAI 协议大模型，内置默认提示词模板，基金/持仓/投资报告三维度
AI 投资报告：AI 生成周报/月报/年报，Markdown 格式，可推送到 Webhook/邮件
暗色模式：全局浅色/深色主题切换，偏好持久化，全站 15 个文件颜色 token 化
养基宝集成：扫码登录、一键导入持仓、实时估值同步
小倍养基集成：手机号 + 短信验证码登录，按账户分组一键导入全部持仓
持仓管理：多账户、父子账户结构，支持买入/卖出流水，自动重算持仓
管理员面板：用户管理、系统统计、Celery 任务手动触发
多渠道通知：基金涨跌幅阈值触发，飞书/钉钉/企业微信/邮件
历史净值：净值走势图，支持多种时间范围 + 当日盘中估值曲线
估值准确率：多数据源误差对比，历史准确率趋势
自选列表：自定义基金分组，分组综合涨跌幅 badge，可拖拽排序
数据源偏好：用户级别数据源切换，主题/报告偏好持久化

快速开始

整个项目分为服务端客户端两部分

服务端可以使用 Docker 或手动部署

最快方式（Docker）

1. 下载配置文件

# 下载 docker-compose.yml
curl -O https://raw.githubusercontent.com/Ye-Yu-Mo/FundVal-Live/main/docker-compose.yml

# 下载环境变量模板
curl -O https://raw.githubusercontent.com/Ye-Yu-Mo/FundVal-Live/main/.env.example

# 复制为 .env 并修改配置
cp .env.example .env

2. 修改配置

请注意：如果你是在服务器，NAS等机器上部署（非本机访问情况下），需要修改ALLOWED_HOSTS项目，ALLOWED_HOSTS=*

编辑 .env 文件，自定义配置：

# 数据库配置
POSTGRES_DB=fundval
POSTGRES_USER=fundval
POSTGRES_PASSWORD=change_me_in_production  # ⚠️ 生产环境请修改
POSTGRES_PORT=5432
POSTGRES_IMAGE=postgres:16-alpine  # 数据库镜像版本

# Django 配置
SECRET_KEY=change_me_in_production_use_random_string  # ⚠️ 生产环境请修改
DEBUG=false
ALLOWED_HOSTS=localhost,127.0.0.1  # 生产环境添加你的域名

# Redis 配置
REDIS_IMAGE=redis:7-alpine  # Redis 镜像版本
REDIS_URL=redis://redis:6379/0

# 应用配置
ALLOW_REGISTER=false  # 是否允许用户注册

# 前端配置
FRONTEND_PORT=21345  # 前端访问端口
FRONTEND_IMAGE=jasamine/fundval-frontend:latest  # 前端镜像版本

# 后端配置
BACKEND_IMAGE=jasamine/fundval-backend:latest  # 后端镜像版本
GUNICORN_WORKERS=4  # Gunicorn 工作进程数（根据 CPU 核心数调整）

# Celery 配置
CELERY_LOGLEVEL=info  # 日志级别：debug, info, warning, error

性能调优建议：

GUNICORN_WORKERS：推荐设置为 (CPU 核心数 × 2) + 1
CELERY_LOGLEVEL：生产环境建议使用 warning 减少日志输出
高负载场景可使用 POSTGRES_IMAGE=postgres:16 替代 alpine 版本

自定义数据库端口（可选）：如需从宿主机直接访问数据库（调试/备份），需同时修改两处：

在 .env 中设置 POSTGRES_PORT=5432（或其他端口）
在 docker-compose.yml 中取消注释 db.ports 配置行

3. 启动服务

docker-compose up -d

4. 访问应用

访问 http://localhost:21345（或你在 .env 中配置的端口）

首次启动：

系统会自动运行数据库迁移
自动同步基金数据（需要等待几分钟）
控制台会显示 Bootstrap Key，用于初始化管理员账户

查看日志：

docker-compose logs -f backend  # 查看后端日志和 Bootstrap Key

5. 更新到最新版本

新版本发布后，按以下步骤更新，数据不会丢失：

# 1. 拉取所有最新镜像
docker compose pull

# 2. 如有新数据库迁移，先执行（重要）
docker compose exec backend python manage.py migrate --noinput

# 3. 重启所有服务
docker compose up -d --no-deps backend frontend celery-beat celery-worker

# 4. 等待服务启动后验证
sleep 5
curl http://localhost:21345/api/health/

注意：

postgres_data 和 config_data 两个 volume 是持久化的，更新不会影响数据
严禁 docker compose down -v：-v 会删除 volume，导致 Bootstrap Key 丢失和数据清空
.env 文件不会被覆盖，自定义配置保留
如果 .env 有新增的配置项，需要对照 .env.example 手动添加
更新后如页面仍显示旧版，请强制刷新浏览器（Ctrl+Shift+R / Cmd+Shift+R）清除 JS 缓存
如遇 加载基金数据失败 等错误，通常是未执行迁移导致，执行第 2 步即可

6. 常见问题

问题	原因	解决
页面报错 `加载基金数据失败`	更新后未执行数据库迁移	`docker compose exec backend python manage.py migrate --noinput`
更新后页面仍是旧版	浏览器缓存了旧 JS 文件	强制刷新（Ctrl+Shift+R）或开无痕窗口
Celery 任务不执行	celery-beat 容器未更新	`docker compose up -d --no-deps celery-beat`

更多问题参考问题排查手册。

手动部署

必需组件

Python: 3.13+
Node.js: 20+
npm: 9+
uv: Python 包管理器
数据库: SQLite 3.x 或 PostgreSQL 16+

可选组件

Redis: 用于 Celery 任务队列（可选）
Nginx: 生产环境反向代理（推荐）

开始部署

git clone https://github.com/Ye-Yu-Mo/FundVal-Live.git
cd FundVal-Live

运行构建脚本

chmod +x build.sh
./build.sh

依次选择构建前端，端口号设定，数据库初始化，静态文件收集

chmod +x start.sh stop.sh
./start.sh

管理员设置（必读）

启动之后，需要在日志中获取 Bootstrap Key

Docker 用户：docker-compose logs backend | grep 'BOOTSTRAP KEY'
手动部署用户：运行 ./start.sh 即可看到

然后访问 http://localhost:21345/initialize（需要换成你自己的 IP + 端口）进行初始化

填入 BOOTSTRAP KEY，配置管理员账户和密码，是否开通注册功能

如果开启注册功能，需要重新启动后端

技术栈

Frontend: React 19 + Vite + Ant Design + ECharts
Backend: Django 6 + DRF + Celery
Database: PostgreSQL 16
Cache: Redis 7
Platform: Web + Desktop (Tauri) + Android (Capacitor)

客户端

可以通过Web页面直接访问使用，无需客户端

其他版本客户端，需前往 Releases 下载最新版本：

目前支持

安卓客户端
macOS (ARM64)
macOS (x86_64)
Windows
Linux

架构

graph TD subgraph Clients["客户端层"] Browser["Web Browser"] Desktop["Desktop · Tauri"] Android["Android · Capacitor"] end subgraph FE["前端容器 · Nginx"] React["React 19 · Ant Design · ECharts"] end subgraph BE["后端容器 · Gunicorn"] Django["Django 6 + DRF\nAPI · Auth · 业务逻辑"] end subgraph Queue["任务队列 · Celery"] Beat["Beat · 定时调度"] Worker["Worker · 异步执行"] end subgraph Store["存储层"] PG[("PostgreSQL 16")] Redis[("Redis 7")] end subgraph Ext["外部数据源"] EM["东方财富"] YJB["养基宝"] XBYJ["小倍养基"] DJ["蛋卷/雪球"] end Browser & Desktop & Android -->|HTTP| FE FE -->|静态文件| React FE -->|"/api/*"| BE BE <-->|读写| PG BE <-->|缓存 / Broker| Redis Beat -->|任务入队| Redis Redis -->|任务分发| Worker Worker -->|数据抓取| EM & YJB & XBYJ & DJ Django -->|按需请求| EM & YJB & XBYJ & DJ

前端通过 Nginx 反向代理 /api/ 到后端。Celery Beat 定时触发净值同步，Worker 并发抓取多数据源后写入 PostgreSQL。

容器启动流程

Docker 容器启动时，backend/entrypoint.sh 会自动执行：

等待数据库就绪
运行数据库迁移 (migrate)
收集静态文件 (collectstatic)
检查系统初始化状态 (check_bootstrap)
自动同步基金数据（仅在数据库为空时，sync_funds --if-empty）
启动应用

如需手动同步基金数据：

# Docker 环境
docker-compose exec backend python manage.py sync_funds

# 手动部署
cd backend && uv run python manage.py sync_funds

项目结构

fundval/
├── frontend/          # React 前端
├── backend/           # Django 后端
│   ├── api/
│   │   ├── sources/   # 数据源（东方财富、养基宝、小倍养基、蛋卷）
│   │   └── services/  # 业务逻辑（持仓计算、养基宝/小倍养基导入）
│   └── entrypoint.sh  # Docker 启动脚本（自动迁移）
├── docker-compose.yml # Docker 编排
├── start.sh           # 手动部署启动脚本（自动迁移）
└── .github/workflows/ # CI/CD

开源协议

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 开源协议。

这意味着：

你可以自由使用、修改、分发本软件
个人使用无需开源你的修改
如果你用本项目代码提供网络服务（SaaS），必须开源你的修改
衍生作品必须使用相同协议

为什么选择 AGPL-3.0？

金融工具需要透明度，用户有权知道估值逻辑
防止闭源商业化，确保改进回流社区
保护开源生态，避免"拿来主义"

详见 LICENSE 文件。

免责声明

本项目提供的数据与分析仅供技术研究使用，不构成任何投资建议。市场有风险，代码无绝对，交易需谨慎。

Star History

暂无评论

FundVal-Live

技术解读

盘中基金估值实时更新系统——Ye-Yu-Mo/FundVal-Live 分析

项目背景与痛点

核心技术揭秘

技术栈和设计模式

实现原理

功能亮点与差异

应用场景与落地建议

综合评价

相关仓库

关于

简要分析

语言占比

Release

贡献者

Fundval

加入讨论群组

遇到问题？

功能特性

快速开始

最快方式（Docker）

1. 下载配置文件

2. 修改配置

3. 启动服务

4. 访问应用

5. 更新到最新版本

6. 常见问题

手动部署

必需组件

可选组件

开始部署

管理员设置（必读）

技术栈

客户端

架构

容器启动流程

项目结构

开源协议

免责声明

Star History

评论