NocoBase 本地開(kāi)發(fā)環(huán)境如何從零跑通5 步克隆、編譯、啟動(dòng)并驗(yàn)證接口【免費(fèi)下載鏈接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/no/nocobase剛把 NocoBase 的倉(cāng)庫(kù)拉下來(lái)怎么最快讓它在你自己電腦上轉(zhuǎn)起來(lái)這篇文章帶你走一遍最短路徑裝依賴(lài)、起開(kāi)發(fā)服務(wù)、再改一個(gè)最小示例應(yīng)用加上數(shù)據(jù)庫(kù)最后用一個(gè) curl 請(qǐng)求證明它真的在運(yùn)行。全程不需要先裝數(shù)據(jù)庫(kù)跑完你會(huì)看到一條來(lái)自本地服務(wù)的真實(shí)響應(yīng)。先確認(rèn)兩個(gè)版本Node 和 Yarn這一步別跳過(guò)版本不對(duì)后面全是坑。依據(jù)倉(cāng)庫(kù)里的兩份配置package.json 中engines: { node: 18 }并且用 volta 字段把版本釘死在node 20.16.0、yarn 1.22.19Dockerfile 官方鏡像用的是node:22-bookworm所以給你一條穩(wěn)妥的結(jié)論Node 用 20 LTS或 22包管理器用 Yarn 1.x。不要上 pnpm 或 npm 裝這個(gè)倉(cāng)庫(kù)它是 yarn workspaces 結(jié)構(gòu)packages/*/*多級(jí)工作區(qū)。node -v # 應(yīng)輸出 v20.x 或 v22.x低于 18 請(qǐng)換版本 yarn -v # 應(yīng)輸出 1.22.x沒(méi)有就 npm install -g yarn3 條命令克隆并裝好依賴(lài)# 克隆倉(cāng)庫(kù)倉(cāng)庫(kù)地址就是這一個(gè) git clone https://gitcode.com/GitHub_Trending/no/nocobase cd nocobase # 裝依賴(lài)倉(cāng)庫(kù)共幾十個(gè) workspace 子包耐心等待 yarn install? 成功標(biāo)志yarn install最后打印Done in ...。兩個(gè)常見(jiàn)卡點(diǎn)先說(shuō)清楚??yarn install會(huì)觸發(fā)根目錄的postinstall腳本nocobase-v1 postinstall裝到一半卡住其實(shí)是它在跑不是死機(jī)。如果你看到某個(gè)原生模塊node-gyp 相關(guān)編譯失敗基本是 Node 版本過(guò)新或過(guò)老先回到上一節(jié)對(duì)齊版本再刪掉node_modules重裝。一條命令起開(kāi)發(fā)服務(wù)用 curl 驗(yàn)證真的啟動(dòng)了裝完依賴(lài)直接進(jìn)開(kāi)發(fā)模式# 啟動(dòng)帶熱更新的開(kāi)發(fā)服務(wù)前端用 rsbuild 構(gòu)建 yarn dev跑完等幾十秒終端里出現(xiàn)服務(wù)監(jiān)聽(tīng)地址默認(rèn) 13000 端口就是起來(lái)了。然后開(kāi)另一個(gè)終端# 請(qǐng)求一條接口驗(yàn)證服務(wù)真的能響應(yīng) curl http://localhost:13000/api/app:info? 成功標(biāo)志返回一段 JSON。如果返回 JSON 里帶401之類(lèi)的鑒權(quán)信息也算成功——說(shuō)明服務(wù)和接口框架都在工作只是這個(gè)接口要求登錄。真正失敗的表現(xiàn)是Connection refused那說(shuō)明進(jìn)程根本沒(méi)監(jiān)聽(tīng)端口回到終端看報(bào)錯(cuò)。想要只熱更后端、不動(dòng)前端就換yarn dev-server想打生產(chǎn)構(gòu)建產(chǎn)物用yarn build然后yarn start以生產(chǎn)模式跑。換個(gè)最小示例應(yīng)用把數(shù)據(jù)庫(kù)也帶上內(nèi)置首頁(yè)已經(jīng)能看了但開(kāi)發(fā)者的日常是寫(xiě)自己的代碼。倉(cāng)庫(kù)里放了一個(gè)最小可運(yùn)行應(yīng)用就是為這個(gè)場(chǎng)景準(zhǔn)備的# 啟動(dòng) examples 目錄下的單應(yīng)用示例 yarn run:example app/single-app start# 訪問(wèn)示例自帶的 test 資源 curl http://localhost:13000/api/test:list? 成功標(biāo)志響應(yīng)體是字符串test list?？吹剿f(shuō)明你的代碼 → 服務(wù) → 接口這條鏈路完整通了。數(shù)據(jù)庫(kù)怎么接示例從環(huán)境變量讀配置完整寫(xiě)法見(jiàn) examples/app/single-app.ts核心字段是這幾個(gè)database: { dialect: process.env.DB_DIALECT, // 方言sqlite / mysql / postgres storage: process.env.DB_STORAGE, // sqlite 時(shí)填 .db 文件路徑 // 其余 username / password / host / port 按方言按需設(shè)置 }本地想最快跑通選 SQLite 就對(duì)了——不用起任何數(shù)據(jù)庫(kù)進(jìn)程# 用環(huán)境變量告訴示例用哪個(gè)庫(kù)然后重新啟動(dòng) DB_DIALECTsqlite DB_STORAGE./storage/dev.db yarn run:example app/single-app start需要真正操作表結(jié)構(gòu)時(shí)倉(cāng)庫(kù)提供了遷移示例# 跑 examples 里的建表/刪表演示遷移 yarn run:example app/migrations/add-migration migrator up卡住了按這份清單自查Qyarn install一直報(bào)網(wǎng)絡(luò)錯(cuò)誤或超時(shí)這個(gè)倉(cāng)庫(kù)依賴(lài)量很大幾百個(gè)子包。先換國(guó)內(nèi)鏡像源再試yarn config set registry https://registry.npmmirror.com。倉(cāng)庫(kù)根目錄還有個(gè)cnpm-sync.js輔助腳本裝不上時(shí)可以在文檔里查它的用法。Q改了代碼沒(méi)生效配置不生效先確認(rèn)你啟動(dòng)的方式。yarn dev是熱更新模式改后端 TS 文件保存即重編如果你用的是yarn start生產(chǎn)模式改任何源碼都不會(huì)生效必須yarn build重新打包。Q端口 13000 被占用curl報(bào)ECONNREFUSED多半是上次進(jìn)程沒(méi)退干凈。先CtrlC停掉舊進(jìn)程或換一個(gè)端口啟動(dòng)時(shí)通過(guò)環(huán)境變量調(diào)整examples/app/single-app.ts里沒(méi)寫(xiě)死端口以終端實(shí)際輸出為準(zhǔn)。Q我想寫(xiě)自己的插件代碼放哪新插件統(tǒng)一放在packages/plugins/nocobase/plugin-你的插件名/目錄下直接復(fù)制現(xiàn)有插件的目錄結(jié)構(gòu)改造即可倉(cāng)庫(kù)的 AGENTS.md 明確寫(xiě)了復(fù)用現(xiàn)有腳手架不要自創(chuàng)新布局。倉(cāng)庫(kù)中未找到一鍵生成插件的獨(dú)立腳本命令可參考官方文檔的插件開(kāi)發(fā)章節(jié)。Q前端頁(yè)面白屏看瀏覽器控制臺(tái)的網(wǎng)絡(luò)請(qǐng)求接口 404 通常是服務(wù)沒(méi)起完yarn dev首次編譯前端需要更久接口 401 則是正常鑒權(quán)攔截用登錄接口或數(shù)據(jù)庫(kù)里現(xiàn)成的管理員賬號(hào)登錄即可。跑通之后你可以順著本地界面進(jìn)入數(shù)據(jù)建模效果類(lèi)似官方文檔里的這個(gè)界面表間關(guān)系配置關(guān)鍵步驟速查表步驟命令克隆倉(cāng)庫(kù)git clone https://gitcode.com/GitHub_Trending/no/nocobase cd nocobase裝依賴(lài)Node 20 Yarn 1.xyarn install起開(kāi)發(fā)服務(wù)并熱更新yarn dev驗(yàn)證服務(wù)可用curl http://localhost:13000/api/app:info跑最小示例 驗(yàn)證接口yarn run:example app/single-app start后curl http://localhost:13000/api/test:list【免費(fèi)下載鏈接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/no/nocobase創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考