free-stockdb 安装部署指南30 分钟从零基础到可用的完整本地量化数据引擎【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb本文带你完整走一遍 free-stockdb 的安装与部署它是一款面向 A 股日K、分钟K 与 ETF 分钟数据的本地量化数据引擎把增量同步、本地缓存、复权、批量查询、回测与指标计算整合在一套本机服务里。跟着步骤做完行情数据全部存在自己硬盘上查询不再依赖远程接口。选对版本四大平台、两条安装路线free-stockdb 覆盖 Windows、macOS、Alpine、manylinux 四个平台[08-10] 起 macOS、Alpine、manylinux 的发行包均已发布并通过多轮压力测试。整体流程只有三步跑一次数据更新、启动一次服务、按自己的习惯挑一个调用入口。平台拿到手之后做什么Windows用发行包里的 exe全程双击新手首选macOS下载对应平台发行包直接运行 updater 与 serverAlpine / manylinux下载 Linux 发行包终端里先跑数据更新器再启动服务Windows双击发行包不用编译从项目 Releases 页面拿 Windows 版本压缩包里已经包含全部可执行文件不需要自己编译环境。里面与安装直接相关的只有两个数据更新.exe—— 负责把数据同步下来stockdb.exe—— 本地数据库服务本体macOS / Alpine / manylinux终端两条命令Linux 系平台的典型顺序就是先同步、后启动./stockdb_updater # 先把数据同步到 ./data ./stockdb # 再启动本地数据服务端口 7899进阶场景如果想从源码自己构建需要准备 CMake 3.14、C17 编译器外加 libcurl 与 OpenSSL 开发包构建定义在 cpp/CMakeLists.txt。普通用户直接拿预编译包就够完全不用碰编译。安装前先看磁盘和内存要留多少同步之前把空间留足能避免中途卡壳项目最低配置推荐配置磁盘空间约 5GB只存日线约 20GB含全量分钟线内存2GB8GB操作系统Windows 7 / macOS / AlpineWindows 10数据文件全部走 Zstd 压缩落盘实际占位比同等规模的 CSV 或 MySQL 存储小 3 倍以上所以上表是压缩后的真实占用。 首次同步怎么跑把数据落到 ./data装好之后第一件事是让数据落地。双击数据更新.exe它会按配置好的数据源拉取最新数据写入./data目录首跑同步量约 5GB 起具体大小取决于你选的数据范围不用盯着看等它跑完就行一次没跑完也没关系退出后重新运行直到完全同步为止注意启动更新器之前先把正在运行的stockdb.exe关掉同步结束再开服务首跑之后每次更新只处理变化数据之后每天或隔 N 天跑一次即可两个让同步更稳的机制校验先行每个文件写入前都会核对 SHA-256 与文件大小本地已存在且校验一致的文件直接跳过不重复下载断点续传中途断了、网断了都没关系重跑更新工具会自动接着来数据源在哪配sync_url.txt 的三种来源镜像地址不写死在程序里而是看sync_url.txt第一条有效配置就是数据镜像根目录。它支持三种接法来源类型配置示例适用场景本地目录file:///D:/stockdb-mirror离线同步快照拷一份放本地内网节点http://192.168.1.5:1234/stockdb局域网里的同步节点公网镜像https://...公网拉取必须使用 HTTPS镜像的清单格式、校验规则与安全建议完整说明在 docs/DATA_SOURCE.md。⚠️stockdb.conf里放着端口 7899、缓存大小、日志级别这些核心参数是数据库的关键配置请不要随手改。启动服务确认数据真的能查同步完成后双击stockdb.exe整个文件只有 2.2MB本地服务随即拉起它默认绑定127.0.0.1:7899只有本机能访问不暴露公网启动成功时状态窗口会显示「正在运行已启用监听」并给出监听地址最省事的验证方式双击数据网页版.html用浏览器直接翻行情。看到数据正常返回说明同步、服务、存储这一整条链路已经通了。 挑一个顺手的入口五种调用方式服务跑起来后取数有五扇门按使用习惯挑一扇推开就行调用方式适合谁Python SDK回测、研究、策略开发HTTP API任意语言、和本地系统集成Excel / WPS 宏表格里做分析、选股、办公自动化HTML 页面不写代码直接浏览本地行情AI MCPClaude、Cursor、Windsurf 等 AI 工具直接查数、算指标引擎内置前/后复权因子、39 种技术指标、5 种指数算法全部在本机服务侧完成查询零远程延迟。各方式的现成示例都放在 调用方式/ 目录下。让 Python 在任何目录都能 import类 pip 全局装发行包里的pybao/目录就是 Python SDK要求 Python 3.8。全局装只有一条命令python pybao/安装.py跑完它会把pybao目录写进用户级 site-packages 下的.pth文件效果等同于 pip 全局安装全程不需要管理员权限。重启 Python 解释器或 IDE 之后在任意工作目录下直接写import stockdb # 原生调用 import stock_sdk # 成品 SDK三个最常用的接口接口干什么rd.get_data()全市场、长周期的批量行情查询zb.get()39 种技术指标批量计算bk.get()股票与申万行业、概念板块双向映射完整跑法看 调用方式/python/sdk_test.py、调用方式/python/zb_test.pyHTTP 侧示例在 调用方式/http/http_api.py。让 AI 工具直接查数据MCP想让 Claude、Cursor、Windsurf 这类 AI 助手直接取数算指标项目内置的 MCP 协议是自实现的不需要额外安装任何 MCP SDK。AI 工具连上之后即可调用查询与指标计算接入步骤见 调用方式/ai_mcp/README.md。容易卡住的 5 个问题Q1更新数据时提示「服务占用」顺序反了。先退出stockdb.exe再跑数据更新同步全部完成之后再启动服务。Q2同步中断了怎么办直接重新运行更新工具。它支持断点续传已校验一致的文件会自动跳过不会重头再来。Q3没有外网还能用吗可以。数据已经落盘在./data查询、回测、指标计算全部在本机完成需要补数据时还能用file://从内网目录离线同步数据快照。Q4能让 AI 工具直接查数据吗能。内置 MCP 协议自实现无需额外安装 MCP SDKClaude、Cursor、Windsurf 等 AI 工具连接后可直接调用查询与指标计算说明见 调用方式/ai_mcp/README.md。Q5把服务暴露到公网安全吗默认只监听127.0.0.1:7899仅本机可访问。确实要多人协作时在stockdb.conf里修改监听 IP 并配置auth密码即可开启局域网服务。✅ 从零到就绪对一遍检查表步骤动作耗时1从 Releases 下载对应平台的发行包约 2 分钟2运行数据更新器完成首次同步可后台挂机视数据量而定3双击stockdb.exe启动服务浏览器验证约 1 分钟4运行pybao/安装.py配置 Python 全局调用约 1 分钟四步走完合计 30 分钟左右。作为参照同样的数据管道如果靠在线 API 自己搭光数据工程就要花 10-15 天。至此本地量化数据引擎就绪数据都在自己手里可以开始写策略了。【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 free-stockdb 安装部署指南：30 分钟从零基础到可用的完整本地量化数据引擎
free-stockdb 安装部署指南30 分钟从零基础到可用的完整本地量化数据引擎【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb本文带你完整走一遍 free-stockdb 的安装与部署它是一款面向 A 股日K、分钟K 与 ETF 分钟数据的本地量化数据引擎把增量同步、本地缓存、复权、批量查询、回测与指标计算整合在一套本机服务里。跟着步骤做完行情数据全部存在自己硬盘上查询不再依赖远程接口。选对版本四大平台、两条安装路线free-stockdb 覆盖 Windows、macOS、Alpine、manylinux 四个平台[08-10] 起 macOS、Alpine、manylinux 的发行包均已发布并通过多轮压力测试。整体流程只有三步跑一次数据更新、启动一次服务、按自己的习惯挑一个调用入口。平台拿到手之后做什么Windows用发行包里的 exe全程双击新手首选macOS下载对应平台发行包直接运行 updater 与 serverAlpine / manylinux下载 Linux 发行包终端里先跑数据更新器再启动服务Windows双击发行包不用编译从项目 Releases 页面拿 Windows 版本压缩包里已经包含全部可执行文件不需要自己编译环境。里面与安装直接相关的只有两个数据更新.exe—— 负责把数据同步下来stockdb.exe—— 本地数据库服务本体macOS / Alpine / manylinux终端两条命令Linux 系平台的典型顺序就是先同步、后启动./stockdb_updater # 先把数据同步到 ./data ./stockdb # 再启动本地数据服务端口 7899进阶场景如果想从源码自己构建需要准备 CMake 3.14、C17 编译器外加 libcurl 与 OpenSSL 开发包构建定义在 cpp/CMakeLists.txt。普通用户直接拿预编译包就够完全不用碰编译。安装前先看磁盘和内存要留多少同步之前把空间留足能避免中途卡壳项目最低配置推荐配置磁盘空间约 5GB只存日线约 20GB含全量分钟线内存2GB8GB操作系统Windows 7 / macOS / AlpineWindows 10数据文件全部走 Zstd 压缩落盘实际占位比同等规模的 CSV 或 MySQL 存储小 3 倍以上所以上表是压缩后的真实占用。 首次同步怎么跑把数据落到 ./data装好之后第一件事是让数据落地。双击数据更新.exe它会按配置好的数据源拉取最新数据写入./data目录首跑同步量约 5GB 起具体大小取决于你选的数据范围不用盯着看等它跑完就行一次没跑完也没关系退出后重新运行直到完全同步为止注意启动更新器之前先把正在运行的stockdb.exe关掉同步结束再开服务首跑之后每次更新只处理变化数据之后每天或隔 N 天跑一次即可两个让同步更稳的机制校验先行每个文件写入前都会核对 SHA-256 与文件大小本地已存在且校验一致的文件直接跳过不重复下载断点续传中途断了、网断了都没关系重跑更新工具会自动接着来数据源在哪配sync_url.txt 的三种来源镜像地址不写死在程序里而是看sync_url.txt第一条有效配置就是数据镜像根目录。它支持三种接法来源类型配置示例适用场景本地目录file:///D:/stockdb-mirror离线同步快照拷一份放本地内网节点http://192.168.1.5:1234/stockdb局域网里的同步节点公网镜像https://...公网拉取必须使用 HTTPS镜像的清单格式、校验规则与安全建议完整说明在 docs/DATA_SOURCE.md。⚠️stockdb.conf里放着端口 7899、缓存大小、日志级别这些核心参数是数据库的关键配置请不要随手改。启动服务确认数据真的能查同步完成后双击stockdb.exe整个文件只有 2.2MB本地服务随即拉起它默认绑定127.0.0.1:7899只有本机能访问不暴露公网启动成功时状态窗口会显示「正在运行已启用监听」并给出监听地址最省事的验证方式双击数据网页版.html用浏览器直接翻行情。看到数据正常返回说明同步、服务、存储这一整条链路已经通了。 挑一个顺手的入口五种调用方式服务跑起来后取数有五扇门按使用习惯挑一扇推开就行调用方式适合谁Python SDK回测、研究、策略开发HTTP API任意语言、和本地系统集成Excel / WPS 宏表格里做分析、选股、办公自动化HTML 页面不写代码直接浏览本地行情AI MCPClaude、Cursor、Windsurf 等 AI 工具直接查数、算指标引擎内置前/后复权因子、39 种技术指标、5 种指数算法全部在本机服务侧完成查询零远程延迟。各方式的现成示例都放在 调用方式/ 目录下。让 Python 在任何目录都能 import类 pip 全局装发行包里的pybao/目录就是 Python SDK要求 Python 3.8。全局装只有一条命令python pybao/安装.py跑完它会把pybao目录写进用户级 site-packages 下的.pth文件效果等同于 pip 全局安装全程不需要管理员权限。重启 Python 解释器或 IDE 之后在任意工作目录下直接写import stockdb # 原生调用 import stock_sdk # 成品 SDK三个最常用的接口接口干什么rd.get_data()全市场、长周期的批量行情查询zb.get()39 种技术指标批量计算bk.get()股票与申万行业、概念板块双向映射完整跑法看 调用方式/python/sdk_test.py、调用方式/python/zb_test.pyHTTP 侧示例在 调用方式/http/http_api.py。让 AI 工具直接查数据MCP想让 Claude、Cursor、Windsurf 这类 AI 助手直接取数算指标项目内置的 MCP 协议是自实现的不需要额外安装任何 MCP SDK。AI 工具连上之后即可调用查询与指标计算接入步骤见 调用方式/ai_mcp/README.md。容易卡住的 5 个问题Q1更新数据时提示「服务占用」顺序反了。先退出stockdb.exe再跑数据更新同步全部完成之后再启动服务。Q2同步中断了怎么办直接重新运行更新工具。它支持断点续传已校验一致的文件会自动跳过不会重头再来。Q3没有外网还能用吗可以。数据已经落盘在./data查询、回测、指标计算全部在本机完成需要补数据时还能用file://从内网目录离线同步数据快照。Q4能让 AI 工具直接查数据吗能。内置 MCP 协议自实现无需额外安装 MCP SDKClaude、Cursor、Windsurf 等 AI 工具连接后可直接调用查询与指标计算说明见 调用方式/ai_mcp/README.md。Q5把服务暴露到公网安全吗默认只监听127.0.0.1:7899仅本机可访问。确实要多人协作时在stockdb.conf里修改监听 IP 并配置auth密码即可开启局域网服务。✅ 从零到就绪对一遍检查表步骤动作耗时1从 Releases 下载对应平台的发行包约 2 分钟2运行数据更新器完成首次同步可后台挂机视数据量而定3双击stockdb.exe启动服务浏览器验证约 1 分钟4运行pybao/安装.py配置 Python 全局调用约 1 分钟四步走完合计 30 分钟左右。作为参照同样的数据管道如果靠在线 API 自己搭光数据工程就要花 10-15 天。至此本地量化数据引擎就绪数据都在自己手里可以开始写策略了。【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考