free-stockdb 安裝部署指南30 分鐘從零基礎(chǔ)到可用的完整本地量化數(shù)據(jù)引擎【免費(fèi)下載鏈接】free-stockdb面向 A 股日K、分鐘K與ETF分鐘數(shù)據(jù)的本地量化引擎集成增量同步、本地緩存、復(fù)權(quán)、批量查詢、回測與指標(biāo)計(jì)算。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb本文帶你完整走一遍 free-stockdb 的安裝與部署它是一款面向 A 股日K、分鐘K 與 ETF 分鐘數(shù)據(jù)的本地量化數(shù)據(jù)引擎把增量同步、本地緩存、復(fù)權(quán)、批量查詢、回測與指標(biāo)計(jì)算整合在一套本機(jī)服務(wù)里。跟著步驟做完行情數(shù)據(jù)全部存在自己硬盤上查詢不再依賴遠(yuǎn)程接口。選對版本四大平臺(tái)、兩條安裝路線free-stockdb 覆蓋 Windows、macOS、Alpine、manylinux 四個(gè)平臺(tái)[08-10] 起 macOS、Alpine、manylinux 的發(fā)行包均已發(fā)布并通過多輪壓力測試。整體流程只有三步跑一次數(shù)據(jù)更新、啟動(dòng)一次服務(wù)、按自己的習(xí)慣挑一個(gè)調(diào)用入口。平臺(tái)拿到手之后做什么Windows用發(fā)行包里的 exe全程雙擊新手首選macOS下載對應(yīng)平臺(tái)發(fā)行包直接運(yùn)行 updater 與 serverAlpine / manylinux下載 Linux 發(fā)行包終端里先跑數(shù)據(jù)更新器再啟動(dòng)服務(wù)Windows雙擊發(fā)行包不用編譯從項(xiàng)目 Releases 頁面拿 Windows 版本壓縮包里已經(jīng)包含全部可執(zhí)行文件不需要自己編譯環(huán)境。里面與安裝直接相關(guān)的只有兩個(gè)數(shù)據(jù)更新.exe—— 負(fù)責(zé)把數(shù)據(jù)同步下來stockdb.exe—— 本地?cái)?shù)據(jù)庫服務(wù)本體macOS / Alpine / manylinux終端兩條命令Linux 系平臺(tái)的典型順序就是先同步、后啟動(dòng)./stockdb_updater # 先把數(shù)據(jù)同步到 ./data ./stockdb # 再啟動(dòng)本地?cái)?shù)據(jù)服務(wù)端口 7899進(jìn)階場景如果想從源碼自己構(gòu)建需要準(zhǔn)備 CMake 3.14、C17 編譯器外加 libcurl 與 OpenSSL 開發(fā)包構(gòu)建定義在 cpp/CMakeLists.txt。普通用戶直接拿預(yù)編譯包就夠完全不用碰編譯。安裝前先看磁盤和內(nèi)存要留多少同步之前把空間留足能避免中途卡殼項(xiàng)目最低配置推薦配置磁盤空間約 5GB只存日線約 20GB含全量分鐘線內(nèi)存2GB8GB操作系統(tǒng)Windows 7 / macOS / AlpineWindows 10數(shù)據(jù)文件全部走 Zstd 壓縮落盤實(shí)際占位比同等規(guī)模的 CSV 或 MySQL 存儲(chǔ)小 3 倍以上所以上表是壓縮后的真實(shí)占用。 首次同步怎么跑把數(shù)據(jù)落到 ./data裝好之后第一件事是讓數(shù)據(jù)落地。雙擊數(shù)據(jù)更新.exe它會(huì)按配置好的數(shù)據(jù)源拉取最新數(shù)據(jù)寫入./data目錄首跑同步量約 5GB 起具體大小取決于你選的數(shù)據(jù)范圍不用盯著看等它跑完就行一次沒跑完也沒關(guān)系退出后重新運(yùn)行直到完全同步為止注意啟動(dòng)更新器之前先把正在運(yùn)行的stockdb.exe關(guān)掉同步結(jié)束再開服務(wù)首跑之后每次更新只處理變化數(shù)據(jù)之后每天或隔 N 天跑一次即可兩個(gè)讓同步更穩(wěn)的機(jī)制校驗(yàn)先行每個(gè)文件寫入前都會(huì)核對 SHA-256 與文件大小本地已存在且校驗(yàn)一致的文件直接跳過不重復(fù)下載斷點(diǎn)續(xù)傳中途斷了、網(wǎng)斷了都沒關(guān)系重跑更新工具會(huì)自動(dòng)接著來數(shù)據(jù)源在哪配sync_url.txt 的三種來源鏡像地址不寫死在程序里而是看sync_url.txt第一條有效配置就是數(shù)據(jù)鏡像根目錄。它支持三種接法來源類型配置示例適用場景本地目錄file:///D:/stockdb-mirror離線同步快照拷一份放本地內(nèi)網(wǎng)節(jié)點(diǎn)http://192.168.1.5:1234/stockdb局域網(wǎng)里的同步節(jié)點(diǎn)公網(wǎng)鏡像https://...公網(wǎng)拉取必須使用 HTTPS鏡像的清單格式、校驗(yàn)規(guī)則與安全建議完整說明在 docs/DATA_SOURCE.md。??stockdb.conf里放著端口 7899、緩存大小、日志級(jí)別這些核心參數(shù)是數(shù)據(jù)庫的關(guān)鍵配置請不要隨手改。啟動(dòng)服務(wù)確認(rèn)數(shù)據(jù)真的能查同步完成后雙擊stockdb.exe整個(gè)文件只有 2.2MB本地服務(wù)隨即拉起它默認(rèn)綁定127.0.0.1:7899只有本機(jī)能訪問不暴露公網(wǎng)啟動(dòng)成功時(shí)狀態(tài)窗口會(huì)顯示「正在運(yùn)行已啟用監(jiān)聽」并給出監(jiān)聽地址最省事的驗(yàn)證方式雙擊數(shù)據(jù)網(wǎng)頁版.html用瀏覽器直接翻行情。看到數(shù)據(jù)正常返回說明同步、服務(wù)、存儲(chǔ)這一整條鏈路已經(jīng)通了。 挑一個(gè)順手的入口五種調(diào)用方式服務(wù)跑起來后取數(shù)有五扇門按使用習(xí)慣挑一扇推開就行調(diào)用方式適合誰Python SDK回測、研究、策略開發(fā)HTTP API任意語言、和本地系統(tǒng)集成Excel / WPS 宏表格里做分析、選股、辦公自動(dòng)化HTML 頁面不寫代碼直接瀏覽本地行情AI MCPClaude、Cursor、Windsurf 等 AI 工具直接查數(shù)、算指標(biāo)引擎內(nèi)置前/后復(fù)權(quán)因子、39 種技術(shù)指標(biāo)、5 種指數(shù)算法全部在本機(jī)服務(wù)側(cè)完成查詢零遠(yuǎn)程延遲。各方式的現(xiàn)成示例都放在 調(diào)用方式/ 目錄下。讓 Python 在任何目錄都能 import類 pip 全局裝發(fā)行包里的pybao/目錄就是 Python SDK要求 Python 3.8。全局裝只有一條命令python pybao/安裝.py跑完它會(huì)把pybao目錄寫進(jìn)用戶級(jí) site-packages 下的.pth文件效果等同于 pip 全局安裝全程不需要管理員權(quán)限。重啟 Python 解釋器或 IDE 之后在任意工作目錄下直接寫import stockdb # 原生調(diào)用 import stock_sdk # 成品 SDK三個(gè)最常用的接口接口干什么rd.get_data()全市場、長周期的批量行情查詢zb.get()39 種技術(shù)指標(biāo)批量計(jì)算bk.get()股票與申萬行業(yè)、概念板塊雙向映射完整跑法看 調(diào)用方式/python/sdk_test.py、調(diào)用方式/python/zb_test.pyHTTP 側(cè)示例在 調(diào)用方式/http/http_api.py。讓 AI 工具直接查數(shù)據(jù)MCP想讓 Claude、Cursor、Windsurf 這類 AI 助手直接取數(shù)算指標(biāo)項(xiàng)目內(nèi)置的 MCP 協(xié)議是自實(shí)現(xiàn)的不需要額外安裝任何 MCP SDK。AI 工具連上之后即可調(diào)用查詢與指標(biāo)計(jì)算接入步驟見 調(diào)用方式/ai_mcp/README.md。容易卡住的 5 個(gè)問題Q1更新數(shù)據(jù)時(shí)提示「服務(wù)占用」順序反了。先退出stockdb.exe再跑數(shù)據(jù)更新同步全部完成之后再啟動(dòng)服務(wù)。Q2同步中斷了怎么辦直接重新運(yùn)行更新工具。它支持?jǐn)帱c(diǎn)續(xù)傳已校驗(yàn)一致的文件會(huì)自動(dòng)跳過不會(huì)重頭再來。Q3沒有外網(wǎng)還能用嗎可以。數(shù)據(jù)已經(jīng)落盤在./data查詢、回測、指標(biāo)計(jì)算全部在本機(jī)完成需要補(bǔ)數(shù)據(jù)時(shí)還能用file://從內(nèi)網(wǎng)目錄離線同步數(shù)據(jù)快照。Q4能讓 AI 工具直接查數(shù)據(jù)嗎能。內(nèi)置 MCP 協(xié)議自實(shí)現(xiàn)無需額外安裝 MCP SDKClaude、Cursor、Windsurf 等 AI 工具連接后可直接調(diào)用查詢與指標(biāo)計(jì)算說明見 調(diào)用方式/ai_mcp/README.md。Q5把服務(wù)暴露到公網(wǎng)安全嗎默認(rèn)只監(jiān)聽127.0.0.1:7899僅本機(jī)可訪問。確實(shí)要多人協(xié)作時(shí)在stockdb.conf里修改監(jiān)聽 IP 并配置auth密碼即可開啟局域網(wǎng)服務(wù)。? 從零到就緒對一遍檢查表步驟動(dòng)作耗時(shí)1從 Releases 下載對應(yīng)平臺(tái)的發(fā)行包約 2 分鐘2運(yùn)行數(shù)據(jù)更新器完成首次同步可后臺(tái)掛機(jī)視數(shù)據(jù)量而定3雙擊stockdb.exe啟動(dòng)服務(wù)瀏覽器驗(yàn)證約 1 分鐘4運(yùn)行pybao/安裝.py配置 Python 全局調(diào)用約 1 分鐘四步走完合計(jì) 30 分鐘左右。作為參照同樣的數(shù)據(jù)管道如果靠在線 API 自己搭光數(shù)據(jù)工程就要花 10-15 天。至此本地量化數(shù)據(jù)引擎就緒數(shù)據(jù)都在自己手里可以開始寫策略了?！久赓M(fèi)下載鏈接】free-stockdb面向 A 股日K、分鐘K與ETF分鐘數(shù)據(jù)的本地量化引擎集成增量同步、本地緩存、復(fù)權(quán)、批量查詢、回測與指標(biāo)計(jì)算。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考