很多人第一次接觸 NocoBase 是在“零代碼平臺(tái)”這個(gè)關(guān)鍵詞框里搜到的。市面上的零代碼產(chǎn)品很多但大多數(shù)是商業(yè) SaaS要么按人頭收費(fèi)要么把數(shù)據(jù)鎖在平臺(tái)上想做二次開(kāi)發(fā)非常困難。NocoBase 最大的不同在于它是一個(gè)開(kāi)源的、數(shù)據(jù)模型驅(qū)動(dòng)的零代碼平臺(tái)你既可以在界面上點(diǎn)點(diǎn)畫(huà)畫(huà)配出一套后臺(tái)管理系統(tǒng)也可以在現(xiàn)有代碼基礎(chǔ)上繼續(xù)擴(kuò)展插件。本文是 NocoBase 系列教程的第 2 篇重點(diǎn)講清楚兩件事怎么把 NocoBase 2 跑起來(lái)以及怎么用它從零搭一個(gè)博客管理后臺(tái)。文章會(huì)以 Docker 安裝為主線配合數(shù)據(jù)表設(shè)計(jì)、區(qū)塊配置和權(quán)限設(shè)置的完整案例盡量做到照著操作就能跑通。1. NocoBase 是什么開(kāi)源零代碼平臺(tái)的定位1.1 零代碼和低代碼到底有什么區(qū)別在開(kāi)始安裝之前先理清一個(gè)概念。低代碼平臺(tái)通常還需要寫(xiě)少量代碼來(lái)完成復(fù)雜邏輯而零代碼平臺(tái)的目標(biāo)是讓業(yè)務(wù)人員不寫(xiě)代碼也能搭建系統(tǒng)。NocoBase 更準(zhǔn)確的說(shuō)法是“以零代碼操作為主、同時(shí)保留開(kāi)發(fā)能力的平臺(tái)”。它有一個(gè)非常核心的設(shè)計(jì)理念數(shù)據(jù)模型驅(qū)動(dòng)。傳統(tǒng)后臺(tái)管理系統(tǒng)開(kāi)發(fā)流程通常是先建數(shù)據(jù)庫(kù)表再寫(xiě)后端接口再寫(xiě)前端頁(yè)面最后處理權(quán)限和菜單。而 NocoBase 把這一步濃縮成了三個(gè)操作創(chuàng)建集合Collection相當(dāng)于創(chuàng)建數(shù)據(jù)表配置字段和關(guān)系相當(dāng)于設(shè)計(jì)表結(jié)構(gòu)添加區(qū)塊Block相當(dāng)于把數(shù)據(jù)用表格、表單、看板等形式展示到頁(yè)面上。這三個(gè)操作全部在 Web 界面里完成不需要寫(xiě) SQL、不需要寫(xiě) Vue/React 頁(yè)面代碼系統(tǒng)會(huì)自動(dòng)生成管理界面和 API。1.2 NocoBase 2 的核心特性NocoBase 2 是 NocoBase 團(tuán)隊(duì)在 1.x 基礎(chǔ)上持續(xù)迭代的版本。從安裝體驗(yàn)和功能覆蓋上來(lái)看它有以下幾個(gè)特點(diǎn)開(kāi)源可自部署數(shù)據(jù)在自己服務(wù)器上不受 SaaS 平臺(tái)限制商業(yè)版本和社區(qū)版都有明確的開(kāi)源協(xié)議約束。數(shù)據(jù)模型驅(qū)動(dòng)先有數(shù)據(jù)結(jié)構(gòu)再生成頁(yè)面和 API這一點(diǎn)和很多“表單驅(qū)動(dòng)”的零代碼平臺(tái)思路不同?？梢暬渲媒缑婕?、字段、頁(yè)面、區(qū)塊、角色權(quán)限都可以在圖形界面完成。插件擴(kuò)展機(jī)制如果內(nèi)置功能不夠用可以開(kāi)發(fā)自己的插件這使得 NocoBase 不是封閉系統(tǒng)。自動(dòng)生成 REST API每個(gè)集合創(chuàng)建后系統(tǒng)會(huì)自動(dòng)提供對(duì)應(yīng)的數(shù)據(jù)訪問(wèn)接口方便后續(xù)對(duì)接其他系統(tǒng)。1.3 適合做什么不適合做什么適用場(chǎng)景很清晰企業(yè)內(nèi)部管理系統(tǒng)、運(yùn)營(yíng)后臺(tái)、內(nèi)容管理后臺(tái)、項(xiàng)目管理工具、進(jìn)銷(xiāo)存、數(shù)據(jù)錄入系統(tǒng)等。這些場(chǎng)景的共同特點(diǎn)是流程清晰、數(shù)據(jù)結(jié)構(gòu)明確、頁(yè)面交互不復(fù)雜。不太適合的場(chǎng)景也很明確高并發(fā) C 端產(chǎn)品、非常復(fù)雜的實(shí)時(shí)協(xié)作編輯、對(duì)前端交互要求極高的定制頁(yè)面。這類(lèi)場(chǎng)景仍然需要專(zhuān)業(yè)開(kāi)發(fā)團(tuán)隊(duì)用代碼實(shí)現(xiàn)。不過(guò)你依然可以用 NocoBase 快速建立原型再導(dǎo)出或?qū)诱较到y(tǒng)。2. 環(huán)境準(zhǔn)備與版本說(shuō)明2.1 安裝方式選擇NocoBase 2 官方提供了多種安裝方式常見(jiàn)的有安裝方式特點(diǎn)適合人群Docker Compose依賴(lài)少部署快一鍵啟動(dòng)大多數(shù)用戶推薦create-nocobase-app需要 Node.js 環(huán)境靈活度高二次開(kāi)發(fā)用戶源碼方式從 GitHub 拉取源碼本地運(yùn)行插件開(kāi)發(fā)者本文重點(diǎn)演示 Docker Compose 方式。這種方式的好處是所有依賴(lài)都被容器管理不用在本地安裝數(shù)據(jù)庫(kù)和 Node.js環(huán)境隔離最徹底出問(wèn)題的概率也最低。2.2 環(huán)境依賴(lài)清單在開(kāi)始之前你需要準(zhǔn)備一臺(tái)能聯(lián)網(wǎng)的服務(wù)器或本地電腦操作系統(tǒng)不限Windows/macOS/Linux 均可Docker 和 Docker Compose 插件確保 Docker 啟動(dòng)正常瀏覽器推薦 Chrome 或 Edge至少 8GB 內(nèi)存避免數(shù)據(jù)庫(kù)和應(yīng)用同時(shí)運(yùn)行時(shí)卡頓。版本方面需要提醒一句N(xiāo)ocoBase 迭代比較快本文的配置示例以當(dāng)前較常見(jiàn)版本為參考你在實(shí)際操作時(shí)如果遇到界面差異以你安裝的版本和官方文檔為準(zhǔn)。2.3 示例項(xiàng)目結(jié)構(gòu)為了后續(xù)維護(hù)方便建議單獨(dú)創(chuàng)建一個(gè)目錄存放 NocoBase 的配置文件nocobase-demo/ ├── docker-compose.yml ├── storage/ # 應(yīng)用數(shù)據(jù)掛載目錄 └── data/ # 數(shù)據(jù)庫(kù)數(shù)據(jù)掛載目錄這樣可以保證容器刪除后數(shù)據(jù)不丟失。3. 使用 Docker 部署 NocoBase 23.1 編寫(xiě) Docker Compose 配置在nocobase-demo目錄下新建docker-compose.yml內(nèi)容如下services: nocobase: image: nocobase/nocobase:latest container_name: nocobase depends_on: - postgres environment: - APP_KEYyour-secret-key-change-me - DB_DIALECTpostgres - DB_HOSTpostgres - DB_PORT5432 - DB_DATABASEnocobase - DB_USERnocobase - DB_PASSWORDnocobase - TZAsia/Shanghai ports: - 13000:80 volumes: - ./storage:/app/nocobase/storage restart: always postgres: image: postgres:15 container_name: nocobase-postgres environment: - POSTGRES_DBnocobase - POSTGRES_USERnocobase - POSTGRES_PASSWORDnocobase - TZAsia/Shanghai volumes: - ./data:/var/lib/postgresql/data restart: always簡(jiǎn)單解釋幾個(gè)關(guān)鍵配置項(xiàng)APP_KEYNocoBase 用于簽名和安全相關(guān)的密鑰。生產(chǎn)環(huán)境務(wù)必修改為足夠長(zhǎng)的隨機(jī)字符串不要使用默認(rèn)值。DB_DIALECT數(shù)據(jù)庫(kù)類(lèi)型這里使用postgres。DB_HOST數(shù)據(jù)庫(kù)地址Compose 內(nèi)部可以直接使用服務(wù)名postgres。DB_PASSWORD建議修改為復(fù)雜度更高的密碼。ports映射13000:80表示把容器內(nèi) 80 端口映射到宿主機(jī) 13000 端口。你可以改成其他端口但后續(xù)訪問(wèn)地址也要跟著變。volumes掛載./storage和./data分別保存應(yīng)用數(shù)據(jù)和數(shù)據(jù)庫(kù)數(shù)據(jù)避免容器重建后數(shù)據(jù)丟失。3.2 啟動(dòng)命令與驗(yàn)證在docker-compose.yml所在目錄執(zhí)行docker-compose up -d如果 Docker 版本較新也可以使用docker compose up -d首次啟動(dòng)需要拉取鏡像耗時(shí)取決于網(wǎng)絡(luò)情況。啟動(dòng)完成后用以下命令查看容器狀態(tài)docker-compose ps正常情況下nocobase和nocobase-postgres兩個(gè)容器都應(yīng)該是Up狀態(tài)。如果啟動(dòng)失敗推薦用以下命令查看日志docker-compose logs -f nocobase3.3 第一次訪問(wèn)創(chuàng)建管理員賬號(hào)容器啟動(dòng)成功后瀏覽器訪問(wèn)http://localhost:13000如果你是安裝在遠(yuǎn)程服務(wù)器上請(qǐng)將localhost替換為服務(wù)器 IP并確認(rèn)防火墻和云安全組已經(jīng)放行 13000 端口。NocoBase 首次訪問(wèn)時(shí)會(huì)進(jìn)入安裝引導(dǎo)界面。你需要按照界面提示設(shè)置管理員用戶名、郵箱和密碼。這里要特別提醒不要依賴(lài)任何“默認(rèn)密碼”NocoBase 不會(huì)給你預(yù)設(shè)一個(gè) admin/admin123賬號(hào)密碼完全由你第一次安裝時(shí)創(chuàng)建。設(shè)置完成后這個(gè)管理員賬號(hào)就是整個(gè)系統(tǒng)的最高權(quán)限賬號(hào)需要妥善保管。如果安裝頁(yè)面要求配置數(shù)據(jù)庫(kù)則需要填寫(xiě)你在docker-compose.yml中定義的數(shù)據(jù)庫(kù)名稱(chēng)、用戶和密碼。如果你完全按照上面的 Compose 文件配置數(shù)據(jù)庫(kù)相關(guān)信息通常是數(shù)據(jù)庫(kù)地址localhost或127.0.0.1端口5432數(shù)據(jù)庫(kù)名nocobase用戶名nocobase密碼nocobase不過(guò)需要注意NocoBase 各版本在安裝向?qū)下杂胁町愑行┌姹緯?huì)自動(dòng)讀取環(huán)境變量有些版本需要手動(dòng)填寫(xiě)。遇到不確定的界面時(shí)可以回看docker-compose.yml里的環(huán)境變量。3.4 另一種方式create-nocobase-app 提示如果你不想使用 Docker也可以使用官方提供的腳手架創(chuàng)建應(yīng)用yarn create nocobase-app my-nocobase-app這種方式需要先安裝 Node.js且對(duì) Node 版本有要求。相比 Docker它可以更方便地進(jìn)行二次開(kāi)發(fā)和調(diào)試但環(huán)境配置也更復(fù)雜。對(duì)于第一次接觸 NocoBase 的讀者建議先通過(guò) Docker 跑通流程后續(xù)需要插件開(kāi)發(fā)時(shí)再切換到源碼方式。4. NocoBase 核心概念拆解在進(jìn)入實(shí)戰(zhàn)案例之前有必要先理解 NocoBase 的幾組核心概念。這些概念貫穿整個(gè)使用過(guò)程理解之后配置起來(lái)會(huì)順暢很多。4.1 集合 CollectionNocoBase 里的“數(shù)據(jù)表”集合是 NocoBase 中最基礎(chǔ)的概念。你可以把它理解成數(shù)據(jù)庫(kù)表也可以理解成 Excel 里的一個(gè)工作表。每個(gè)集合都有若干個(gè)字段字段定義了這個(gè)集合能存哪些數(shù)據(jù)。例如一個(gè)“文章”集合可以包含以下字段標(biāo)題、正文、發(fā)布時(shí)間、狀態(tài)、所屬分類(lèi)。NocoBase 會(huì)把這些字段映射到數(shù)據(jù)庫(kù)表的列上并自動(dòng)生成對(duì)應(yīng)的增刪改查接口。4.2 字段類(lèi)型與關(guān)系字段NocoBase 內(nèi)置了豐富的字段類(lèi)型常見(jiàn)的有文本類(lèi)單行文本、多行文本、富文本、Markdown數(shù)值類(lèi)整數(shù)、小數(shù)、百分比、幣種選項(xiàng)類(lèi)單選、多選、下拉選擇日期時(shí)間日期、時(shí)間、日期時(shí)間文件類(lèi)附件、圖片關(guān)系類(lèi)關(guān)聯(lián)字段比如一對(duì)多、多對(duì)一、多對(duì)多。關(guān)系字段是 NocoBase 比較強(qiáng)大的地方。例如一篇文章屬于一個(gè)分類(lèi)一個(gè)分類(lèi)下有多篇文章這就是一對(duì)多關(guān)系一篇文章可以打多個(gè)標(biāo)簽一個(gè)標(biāo)簽也可以關(guān)聯(lián)多篇文章這就是多對(duì)多關(guān)系。通過(guò)關(guān)系字段你可以把多個(gè)集合串聯(lián)起來(lái)做出聯(lián)動(dòng)的數(shù)據(jù)界面。4.3 區(qū)塊 Block頁(yè)面的積木區(qū)塊是 NocoBase 頁(yè)面布局的最小單元。你可以把區(qū)塊理解成積木頁(yè)面就是拼好的積木組合。常見(jiàn)的區(qū)塊類(lèi)型有表格區(qū)塊以表格形式展示數(shù)據(jù)支持分頁(yè)、排序、篩選表單區(qū)塊用于新增或編輯數(shù)據(jù)詳情區(qū)塊用于展示單條數(shù)據(jù)的詳細(xì)信息看板區(qū)塊適合任務(wù)管理、項(xiàng)目管理日歷區(qū)塊按日歷形式展示帶日期字段的數(shù)據(jù)。一個(gè)頁(yè)面可以放多個(gè)區(qū)塊區(qū)塊之間可以通過(guò)關(guān)系字段聯(lián)動(dòng)。例如在“文章分類(lèi)詳情”頁(yè)面里左邊展示分類(lèi)信息右邊展示該分類(lèi)下的文章列表這就是關(guān)系區(qū)塊的典型用法。4.4 角色權(quán)限NocoBase 在安裝完成后會(huì)自動(dòng)創(chuàng)建一個(gè)管理員角色。管理員擁有全部權(quán)限可以創(chuàng)建其他角色并分配權(quán)限。角色權(quán)限通常包括對(duì)每個(gè)集合的查看、新增、編輯、刪除權(quán)限對(duì)字段級(jí)別的訪問(wèn)控制對(duì)頁(yè)面和菜單的可見(jiàn)性控制。在實(shí)際項(xiàng)目中我建議你給不同角色配置不同的權(quán)限范圍避免普通用戶直接看到或修改敏感數(shù)據(jù)。4.5 工作流與自動(dòng)化除了基礎(chǔ)的數(shù)據(jù)管理NocoBase 還內(nèi)置了工作流插件可以用來(lái)實(shí)現(xiàn)簡(jiǎn)單的自動(dòng)化操作比如提交審批、定時(shí)觸發(fā)、數(shù)據(jù)變更通知等。工作流的配置方式也是圖形化的不需要寫(xiě)代碼。第一版可以先不深入使用工作流但如果你做的系統(tǒng)涉及審批流程這個(gè)是值得提前了解的擴(kuò)展方向。4.6 API 能力提示NocoBase 每個(gè)集合創(chuàng)建后都會(huì)自動(dòng)生成一套 REST API。這意味著你在界面上配置好的數(shù)據(jù)表本身就相當(dāng)于一個(gè)后端服務(wù)可以給其他系統(tǒng)或前端頁(yè)面提供接口。你可以把 NocoBase 看成一個(gè)“會(huì)生成后臺(tái)管理界面的數(shù)據(jù)服務(wù)”這對(duì)快速搭建內(nèi)部工具非常有價(jià)值。5. 實(shí)戰(zhàn)用 NocoBase 搭建一個(gè)博客管理系統(tǒng)前面概念介紹得差不多了這一節(jié)我們走一個(gè)完整案例用 NocoBase 搭建一個(gè)最簡(jiǎn)單的博客管理系統(tǒng)。這個(gè)案例不會(huì)涉及復(fù)雜的前端代碼所有操作都在 NocoBase 界面內(nèi)完成。5.1 需求梳理與數(shù)據(jù)模型設(shè)計(jì)博客系統(tǒng)的核心數(shù)據(jù)通常包括文章標(biāo)題、摘要、正文、狀態(tài)草稿/已發(fā)布、發(fā)布時(shí)間、所屬分類(lèi)分類(lèi)分類(lèi)名稱(chēng)、排序標(biāo)簽標(biāo)簽名稱(chēng)評(píng)論昵稱(chēng)、郵箱、內(nèi)容、狀態(tài)待審核/已通過(guò)、關(guān)聯(lián)文章。基于這些需求我們規(guī)劃以下集合集合名主要字段說(shuō)明posts標(biāo)題、摘要、正文、狀態(tài)、發(fā)布時(shí)間、分類(lèi)、作者文章表categories名稱(chēng)、描述、排序分類(lèi)表tags名稱(chēng)標(biāo)簽表comments昵稱(chēng)、郵箱、內(nèi)容、狀態(tài)、文章評(píng)論表關(guān)系設(shè)計(jì)如下一個(gè)分類(lèi)下有多篇文章一篇文章屬于一個(gè)分類(lèi)categories 一對(duì)多 posts一篇文章可以打多個(gè)標(biāo)簽一個(gè)標(biāo)簽可以關(guān)聯(lián)多篇文章posts 多對(duì)多 tags一篇文章下有多條評(píng)論一條評(píng)論屬于一篇文章posts 一對(duì)多 comments。5.2 創(chuàng)建集合登錄 NocoBase 后臺(tái)后進(jìn)入“設(shè)置”或“數(shù)據(jù)源管理”相關(guān)菜單找到集合管理入口。點(diǎn)擊“新建集合”輸入集合名稱(chēng)。以文章集合posts為例步驟如下填寫(xiě)集合名稱(chēng)posts填寫(xiě)集合標(biāo)識(shí)通常系統(tǒng)會(huì)自動(dòng)生成在字段列表中添加字段。字段建議如下字段名稱(chēng)字段類(lèi)型說(shuō)明title單行文本文章標(biāo)題excerpt多行文本文章摘要content多行文本或富文本正文status單選草稿 / 已發(fā)布published_at日期時(shí)間發(fā)布時(shí)間category關(guān)聯(lián)字段關(guān)聯(lián) categories 表tags關(guān)聯(lián)字段多對(duì)多關(guān)聯(lián) tags 表按同樣的方式創(chuàng)建categories、tags、comments集合。comments表里可以添加post關(guān)聯(lián)字段指向posts表示這條評(píng)論屬于哪篇文章。5.3 配置關(guān)系字段在創(chuàng)建字段時(shí)如果選擇“關(guān)聯(lián)字段”NocoBase 會(huì)要求你選擇關(guān)聯(lián)的目標(biāo)集合并設(shè)置關(guān)系類(lèi)型。例如在posts中創(chuàng)建category關(guān)聯(lián)字段目標(biāo)集合選擇categories關(guān)系類(lèi)型選擇“多對(duì)一”含義是一篇文章對(duì)應(yīng)一個(gè)分類(lèi)。在posts中創(chuàng)建tags關(guān)聯(lián)字段目標(biāo)集合選擇tags關(guān)系類(lèi)型選擇“多對(duì)多”含義是一篇文章有多個(gè)標(biāo)簽一個(gè)標(biāo)簽對(duì)應(yīng)多篇文章。配置完成后你可以進(jìn)入對(duì)應(yīng)集合的數(shù)據(jù)管理頁(yè)面手動(dòng)新增幾條數(shù)據(jù)來(lái)驗(yàn)證關(guān)系字段是否生效。5.4 創(chuàng)建頁(yè)面與區(qū)塊數(shù)據(jù)表和字段配置完成后接下來(lái)要把數(shù)據(jù)展示到頁(yè)面上。NocoBase 的頁(yè)面由區(qū)塊組成你可以新建一個(gè)菜單叫“文章管理”。在文章管理頁(yè)面中添加一個(gè)“表格區(qū)塊”數(shù)據(jù)來(lái)源選擇posts集合。表格中會(huì)顯示所有文章字段你可以選擇顯示哪些列比如標(biāo)題、狀態(tài)、發(fā)布時(shí)間、分類(lèi)。為了豐富頁(yè)面你還可以再添加一個(gè)“看板區(qū)塊”數(shù)據(jù)來(lái)源同樣是posts看板的分組字段選擇status這樣文章可以按“草稿”和“已發(fā)布”分組展示方便管理內(nèi)容發(fā)布狀態(tài)。對(duì)于評(píng)論管理新建一個(gè)“評(píng)論管理”菜單頁(yè)面添加comments表格區(qū)塊顯示昵稱(chēng)、郵箱、內(nèi)容和狀態(tài)字段。這樣后臺(tái)就基本成型了。5.5 配置權(quán)限在 NocoBase 中角色權(quán)限決定了誰(shuí)能看到哪些內(nèi)容、能操作哪些數(shù)據(jù)。默認(rèn)管理員擁有全部權(quán)限。假設(shè)你希望給一位“內(nèi)容編輯”開(kāi)放部分權(quán)限可以這樣配置進(jìn)入角色權(quán)限管理新建角色“內(nèi)容編輯”為該角色配置posts集合的查看、新增、編輯權(quán)限但不允許刪除配置categories和tags的查看、新增、編輯權(quán)限評(píng)論的刪除權(quán)限默認(rèn)關(guān)閉只允許查看和審核狀態(tài)更新。這樣“內(nèi)容編輯”角色登錄后可以管理文章和分類(lèi)但不能刪除評(píng)論也不能進(jìn)入系統(tǒng)設(shè)置。5.6 完善頁(yè)面與發(fā)布預(yù)覽為了讓博客前臺(tái)有一個(gè)“展示”視角你還可以配置一個(gè)訪客角色。訪客角色的權(quán)限通常只有查看posts中的已發(fā)布文章無(wú)法進(jìn)入后臺(tái)管理頁(yè)面。通過(guò) NocoBase 的權(quán)限配置這種“前后臺(tái)分離”的體驗(yàn)可以在同一個(gè)系統(tǒng)里實(shí)現(xiàn)。完成以上步驟后你實(shí)際上已經(jīng)用 NocoBase 搭出了一個(gè)可用的博客后臺(tái)。你可以在后臺(tái)發(fā)布一篇測(cè)試文章然后通過(guò) NocoBase 生成的 API 或頁(yè)面預(yù)覽查看效果。5.7 案例小結(jié)這個(gè)案例本質(zhì)上只用了 NocoBase 的四個(gè)基礎(chǔ)能力集合、字段、區(qū)塊和權(quán)限。如果你能獨(dú)立完成這個(gè)過(guò)程說(shuō)明你已經(jīng)掌握了 NocoBase 的核心操作路徑先設(shè)計(jì)數(shù)據(jù)結(jié)構(gòu)再配置界面最后控制權(quán)限。后續(xù)所有復(fù)雜的系統(tǒng)基本都是在這些基礎(chǔ)操作上疊加更多字段、區(qū)塊和工作流。6. 常見(jiàn)問(wèn)題與排查思路NocoBase 安裝和使用過(guò)程中有不少讀者會(huì)遇到一些重復(fù)性問(wèn)題。這里整理一張排查表你可以先對(duì)照排查再結(jié)合官方文檔處理。問(wèn)題現(xiàn)象常見(jiàn)原因解決思路瀏覽器訪問(wèn) 13000 端口沒(méi)有反應(yīng)容器未啟動(dòng)或防火墻未放行端口執(zhí)行docker-compose ps查看狀態(tài)檢查宿主機(jī)防火墻和安全組頁(yè)面提示數(shù)據(jù)庫(kù)連接失敗數(shù)據(jù)庫(kù)環(huán)境變量配置錯(cuò)誤或數(shù)據(jù)庫(kù)容器未啟動(dòng)檢查docker-compose.yml中 DB_HOST、DB_USER、DB_PASSWORD 是否一致查看數(shù)據(jù)庫(kù)容器日志第一次安裝時(shí)不知道用戶名密碼安裝向?qū)е性O(shè)置的賬號(hào)密碼忘掉或誤以為存在默認(rèn)密碼NocoBase 沒(méi)有默認(rèn)密碼如果忘記密碼需要進(jìn)入數(shù)據(jù)庫(kù)重置或參考官方文檔恢復(fù)流程容器反復(fù)重啟端口沖突或磁盤(pán)權(quán)限問(wèn)題查看日志docker-compose logs -f nocobase檢查掛載目錄是否有寫(xiě)入權(quán)限頁(yè)面配置保存后看不到效果瀏覽器緩存或區(qū)塊數(shù)據(jù)源選擇錯(cuò)誤清除瀏覽器緩存檢查區(qū)塊綁定的集合是否正確升級(jí)后部分插件不可用NocoBase 版本升級(jí)后插件未同步升級(jí)升級(jí)前先備份完整數(shù)據(jù)在測(cè)試環(huán)境驗(yàn)證插件兼容性后再應(yīng)用到生產(chǎn)環(huán)境如果你遇到的是某個(gè)具體報(bào)錯(cuò)推薦先把完整報(bào)錯(cuò)信息貼到搜索引擎或官方 GitHub Issues 里搜索很多問(wèn)題已經(jīng)有解決方案。7. 最佳實(shí)踐與工程建議把 NocoBase 部署起來(lái)并不難難的是把它用成一個(gè)穩(wěn)定、可維護(hù)的生產(chǎn)系統(tǒng)。以下建議來(lái)自實(shí)際項(xiàng)目的經(jīng)驗(yàn)總結(jié)。7.1 數(shù)據(jù)模型設(shè)計(jì)階段多投入時(shí)間NocoBase 的優(yōu)勢(shì)之一是你不用寫(xiě)建表 SQL但這不代表可以隨便建表。相反因?yàn)閿?shù)據(jù)結(jié)構(gòu)一旦被多個(gè)頁(yè)面的區(qū)塊引用后續(xù)修改字段類(lèi)型會(huì)牽連較多地方所以在新建集合之前建議先整理一份數(shù)據(jù)模型文檔明確每個(gè)集合的用途、字段、類(lèi)型和關(guān)系。一個(gè)比較實(shí)用的做法是先在紙上畫(huà)出實(shí)體關(guān)系圖確定一對(duì)多、多對(duì)多關(guān)系再在 NocoBase 中落地。這樣能減少后續(xù)反復(fù)調(diào)整結(jié)構(gòu)的工作量。7.2 權(quán)限最小化原則在配置權(quán)限時(shí)默認(rèn)建議“能不給權(quán)限就不給權(quán)限”。管理員賬號(hào)只用于維護(hù)系統(tǒng)日常運(yùn)營(yíng)人員使用受限角色。特別注意文章刪除權(quán)限不要隨意開(kāi)放給普通編輯評(píng)論審核和刪除權(quán)限盡量分離系統(tǒng)設(shè)置菜單只對(duì)管理員可見(jiàn)。這樣做的好處是即使某個(gè)賬號(hào)被泄露損失范圍也是可控的。7.3 定期備份數(shù)據(jù)庫(kù)和應(yīng)用目錄NocoBase 的數(shù)據(jù)主要存在數(shù)據(jù)庫(kù)里但應(yīng)用目錄下的storage目錄也保存著附件、資源和部分配置。備份策略建議定期使用pg_dump備份 PostgreSQL 數(shù)據(jù)庫(kù)備份整個(gè)storage目錄在升級(jí)版本或修改重要配置前先手動(dòng)備份一次。備份是性價(jià)比最高的安全性投入不要等出了問(wèn)題再后悔。7.4 生產(chǎn)環(huán)境安全配置如果你的 NocoBase 要部署到公網(wǎng)需要注意將APP_KEY修改為足夠復(fù)雜的隨機(jī)字符串?dāng)?shù)據(jù)庫(kù)不要暴露到公網(wǎng)端口僅在 Docker 內(nèi)部網(wǎng)絡(luò)環(huán)境使用使用 HTTPS 訪問(wèn) NocoBase 頁(yè)面為管理員賬號(hào)設(shè)置高強(qiáng)度密碼開(kāi)啟必要的登錄限制。尤其不要直接把 5432 端口暴露到公網(wǎng)數(shù)據(jù)庫(kù)一旦暴露攻擊者可能會(huì)嘗試暴力破解。7.5 版本升級(jí)前先在測(cè)試環(huán)境驗(yàn)證NocoBase 2 還處于持續(xù)迭代階段版本升級(jí)可能帶來(lái)新的功能和破壞性變更。上線前建議先在測(cè)試環(huán)境執(zhí)行完整升級(jí)流程確認(rèn)核心功能正常再更新生產(chǎn)環(huán)境。升級(jí)前一定先做數(shù)據(jù)庫(kù)備份。8. 總結(jié)與下一步學(xué)習(xí)路線本文從零開(kāi)始介紹了 NocoBase 2 的定位、Docker 部署、核心概念、博客后臺(tái)實(shí)戰(zhàn)以及常見(jiàn)問(wèn)題的排查思路。現(xiàn)在你應(yīng)該已經(jīng)具備以下能力使用 Docker Compose 快速部署 NocoBase理解集合、字段、區(qū)塊和角色權(quán)限之間的關(guān)聯(lián)能在界面中完成數(shù)據(jù)表建模和頁(yè)面配置知道如何規(guī)劃?rùn)?quán)限避免生產(chǎn)環(huán)境權(quán)限失控。如果你已經(jīng)把本文案例跑通下一步可以嘗試這幾個(gè)方向研究 NocoBase 的字段聯(lián)動(dòng)和條件顯示做出更靈活的表單嘗試配置工作流實(shí)現(xiàn)文章發(fā)布前的審批流程了解 NocoBase 的插件開(kāi)發(fā)寫(xiě)一個(gè)滿足自己業(yè)務(wù)需求的小插件使用 NocoBase 自動(dòng)生成的 REST API對(duì)接一個(gè)簡(jiǎn)單的前端頁(yè)面。NocoBase 的價(jià)值不在于替你寫(xiě)代碼而在于把“數(shù)據(jù)管理后臺(tái)”這類(lèi)重復(fù)性極高的開(kāi)發(fā)工作壓縮成幾天的配置工作。如果你在安裝或使用過(guò)程中遇到任何問(wèn)題可以把報(bào)錯(cuò)信息整理好發(fā)到評(píng)論區(qū)我們一起排查解決。動(dòng)手跑一遍比看十遍教程都更有用。