news 2026/10/21 20:18:48

free-stockdb 快速上手：30 分钟搭一套本地 A 股分钟K数据引擎

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
free-stockdb 快速上手：30 分钟搭一套本地 A 股分钟K数据引擎

free-stockdb 快速上手：30 分钟搭一套本地 A 股分钟K数据引擎

【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎，集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb

free-stockdb 是一个面向 A 股的本地量化数据引擎，管理日K、分钟K与 ETF 分钟数据，内置增量同步、复权因子和 39 种指标计算。跟着下面几步做完，你机器里会多一份全市场行情数据和一份只服务本机的数据接口，全程不碰远程接口。

🎯 30 分钟搭完：你手里会多出什么

照做完全部步骤，30 分钟内你会收获三样东西：

  1. ./data目录里的全市场数据——7000 多只股票的日K、分钟K 与 ETF 分钟，复权因子已内置
  2. 一个跑在本机的数据服务，端口127.0.0.1:7899，取数、回测、算指标都走它
  3. 数据全部留在自己机器上，断网之后照常研究

发行包里另有一份 先看！这个！！使用说明.txt，目录结构有疑问时先翻它。

那数据和这个服务分别怎么落地？从数据开始。

📥 本地行情数据怎么更新

⚠️ 运行更新前，先确认 stockdb 服务没有开着；之前启动过的话，先退出。

  1. 双击数据更新.exe：它会按 sync_url.txt 里的镜像地址，把清单中的文件逐个拉到./data，逐一做 SHA-256 校验
  2. 首次同步比较耗时，期间可以直接关掉——这就是断点续传：重跑时已完成的文件自动跳过，接着没下的部分继续
  3. 以后每天或隔几天跑一次就行，增量同步只拉这段时间变化的部分，不用重下全量

成功信号：同步提示全部完成、./data里出现数据文件。同步中途退了怎么办？再双击一次即可，已下好的部分不会重复下载。

数据就位，下一步让它能被查询。

🚦 本地数据库服务怎么启动

  1. 双击stockdb.exe，服务程序本体只有 2.2MB
  2. 启动后端口仅绑在本机127.0.0.1:7899，外网访问不到，天然安全

成功信号：浏览器打开数据网页版能看到行情（下一节演示），服务即已就绪。

🌐 无代码看行情：数据网页版怎么用

双击 数据网页版.html 让浏览器打开：输入代码、挑一段日期、选日K或分钟K频率、定复权类型，就能筛出对应行情，结果可以导出成 Excel 或 CSV 存档。

顺带把"复权"说白：分红、拆股会让历史价格出现跳空，复权就是把这层影响修正掉，历史数据因此能直接拿来算收益。

成功信号：输入任一代码，K 线表格立刻有数，本地数据底座就算打通了。

想换成写代码调用，往下看五种入口。

🔌 五种调用入口怎么选

  • Python SDK：先跑 pybao/安装.py，参考 调用方式/python/sdk_test.py。一行rd.get_data()就能取回全市场的日K、分钟K，周期和复权方式随便挑；zb.get()把 MA、MACD、KDJ 在内的 39 种指标与 5 种指数一次算完
  • HTTP API：调用方式/http/http_api.py，任何语言都能接
  • Excel / WPS 宏：调用方式/excel/wps_js_macro.js，适合在表格里做选股
  • HTML 网页：数据网页版.html，就是上一节用的那个
  • AI MCP：调用方式/ai_mcp/stock_mcp_server.py，接给 AI 工具，让它直接查行情、算指标

🧰 避坑清单：遇到 X 这样处理

  • 不确定磁盘要留多大 → 空间按日线约 5GB、分钟K全量约20GB预估；存的是 Zstd 压缩格式，体积只有 CSV 或 MySQL 方案的三分之一左右，内存按 2GB 准备
  • 同步中断、或想换成自己的数据源 → 中断直接重跑即可续传；换源把 sync_url.txt 指到自建镜像或内网服务器，file://本地目录也支持，清单格式与安全约束写在 docs/DATA_SOURCE.md
  • 离线了还要跑策略 → 不用改任何配置，取数、回测、算指标都在本机完成，不碰网络
  • 不在 Windows 上 → 官方已发布 Windows、macOS、Alpine、manylinux 版本，非 Windows 平台用对应发行包即可

🏁 下一步：第一个 Python 回测怎么跑

数据底座已就绪，别让它闲着：

  1. 跑一遍 pybao/安装.py 装好 SDK
  2. 照着 调用方式/python/sdk_test.py 取一只股票的分钟K
  3. 用zb.get()给它算上 MA 和 MACD，把参数换成你自己的条件

看到终端打印出这只股票的 MA、MACD 数值，整条链路就算真正跑通了——接着把范围从一只股票扩到全市场，就是你的第二个动作。

【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎，集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/10/21 20:07:13

HashMap源码和并发异常问题分析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/10/21 20:05:39

读写数据依赖：芯片设计中的性能隐形杀手与处理策略

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/10/21 20:03:39

从零理解电机旋转电压矢量：Clarke/Park变换与SVPWM仿真实践

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/10/21 19:56:52

LangChain实战指南：从核心概念到RAG知识库搭建

刚接触大模型应用开发的人，几乎都会在某个时间点听到“LangChain”这个词。它是一个开源框架，常被描述为“大模型应用的脚手架”，但说实话，第一次看到这种说法，很多人仍然不清楚它到底能干什么。我用了一段时间之后&am…

作者头像 李华
网站建设 2026/10/21 19:56:24

C++多态与虚函数：从工程场景到底层机制

多态这个词，在C里被提到的频率，几乎和“面向对象”本身一样高。但说实话，我见过不少写了三五年C的开发者，能把virtual关键字用得很溜，你问他“多态到底解决了什么问题”，他反而会愣一下。这个问题其实特别关…

作者头像 李华
网站建设 2026/10/21 19:55:57

CAN总线高频故障排查：从物理层到采样点的实战指南

做CAN总线开发这些年，要问我什么最磨人，不是CAN协议栈写不出来，也不是应用层逻辑理不清，而是总线上的“高频问题”——反复出现、排查费劲、最后发现原因往往特别基础。波形不稳、报文丢失、一上高负载就报错，这类问题…

作者头像 李华