科技背景
🔧 NOCOBASE IMPLEMENTATION GUIDE

實施者指南 部署與配置實戰

快速完成NocoBase部署與配置,確保系統穩定執行

部署前準備:環境檢查與規劃

三種部署方式:Docker Compose、Dockerfile、原始碼安裝

基礎配置:系統設定與常見問題解決

📋 部署準備 🚀 部署方式 ⚙️ 基礎配置 🔧 問題解決

📋 部署前準備

環境檢查與規劃,確保部署順利進行

硬體與網路要求

最低配置(測試環境)

  • CPU:2核
  • 記憶體:4GB
  • 磁碟:50GB
  • 網路:穩定的網際網路連線

推薦配置(生產環境)

  • CPU:4核及以上
  • 記憶體:8GB及以上
  • 磁碟:100GB SSD及以上
  • 網路:穩定的網際網路連線,建議使用專線

軟體環境要求

Docker 部署方式

  • Docker:20.10.0+
  • Docker Compose:1.29.0+
  • 作業系統:Linux、Windows、macOS

原始碼安裝方式

  • Node.js:16.14.0+ 或 18.0.0+
  • 資料庫:PostgreSQL 14.0+
  • 作業系統:Linux、Windows、macOS

部署規劃

1 環境準備

  • 確認伺服器硬體配置
  • 安裝必要的軟體依賴
  • 配置網路和防火牆

2 部署方式選擇

  • 測試環境:Docker Compose
  • 生產環境:Dockerfile
  • 深度定製:原始碼安裝

3 後續規劃

  • 資料備份策略
  • 監控與告警
  • 定期更新計劃

🚀 部署方式

三種部署方式詳細教程,滿足不同場景需求

方式一:Docker Compose 一鍵部署(推薦測試環境)

部署步驟

1

建立部署目錄

mkdir -p nocobase && cd nocobase
2

建立 docker-compose.yml 檔案

cat > docker-compose.yml << 'EOF' version: '3' services: nocobase: image: nocobase/nocobase:latest ports: - "8080:8080" environment: - DATABASE_URL=postgresql://nocobase:nocobase@postgres:5432/nocobase depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=nocobase - POSTGRES_USER=nocobase - POSTGRES_PASSWORD=nocobase volumes: - postgres-data:/var/lib/postgresql/data volumes: postgres-data: EOF
3

啟動服務

docker-compose up -d
4

訪問 NocoBase

開啟瀏覽器,訪問 http://伺服器IP:8080

注意事項

  • 此方式適合測試環境,生產環境建議使用 Dockerfile 方式
  • 預設使用最新版本映象,如需指定版本請修改 image 標籤
  • 預設資料庫密碼為 nocobase,生產環境請修改為強密碼

方式二:Dockerfile 自定義構建(推薦生產環境)

部署步驟

1

建立 Dockerfile 檔案

cat > Dockerfile << 'EOF' FROM nocobase/nocobase:latest # 如需安裝額外依賴,請在此新增 # RUN npm install some-package # 如需複製自定義配置,請在此新增 # COPY config.yml /app/config/ EOF
2

構建映象

docker build -t my-nocobase .
3

建立 docker-compose.yml 檔案

cat > docker-compose.yml << 'EOF' version: '3' services: nocobase: image: my-nocobase ports: - "8080:8080" environment: - DATABASE_URL=postgresql://nocobase:your_strong_password@postgres:5432/nocobase depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=nocobase - POSTGRES_USER=nocobase - POSTGRES_PASSWORD=your_strong_password volumes: - postgres-data:/var/lib/postgresql/data volumes: postgres-data: EOF
4

啟動服務

docker-compose up -d

注意事項

  • 生產環境請務必修改資料庫密碼為強密碼
  • 建議使用固定版本映象,而非 latest 標籤
  • 可根據需要在 Dockerfile 中新增自定義配置和依賴

方式三:create-nocobase-app 原始碼安裝(適合深度定製)

部署步驟

1

安裝 Node.js

確保安裝了 Node.js 16.14.0+ 或 18.0.0+

2

建立專案

npm create nocobase-app@latest my-nocobase-app
3

配置資料庫

根據提示配置資料庫連線資訊

4

啟動服務

cd my-nocobase-app && npm run dev
5

生產環境構建

npm run build && npm run start

注意事項

  • 此方式適合需要深度定製或二次開發的場景
  • 需要更多的系統資源和 Node.js 相關知識
  • 生產環境建議使用 PM2 等程序管理工具

⚙️ 基礎配置

系統設定與初始化配置,確保系統正常執行

初始配置

1. 建立管理員賬戶

首次訪問 NocoBase 時,系統會引導建立管理員賬戶。請設定強密碼並妥善保管。

2. 配置系統資訊

進入「設定」->「系統設定」,配置系統名稱、LOGO、版權資訊等。

3. 配置郵件服務

進入「設定」->「郵件設定」,配置 SMTP 服務,用於傳送驗證碼、通知等。

4. 安裝必要外掛

進入「外掛市場」,安裝所需的外掛,如 AI 整合、圖表分析等。

安全配置

1. 配置 HTTPS

生產環境建議配置 HTTPS,可以透過反向代理(如 Nginx)實現。

2. 配置防火牆

僅開放必要的埠,如 80、443 等,關閉不必要的埠。

3. 配置許可權管理

進入「設定」->「角色許可權」,配置不同角色的許可權,遵循最小許可權原則。

4. 配置資料備份

定期備份資料庫,可以透過 crontab 定時執行備份指令碼。

效能最佳化

伺服器最佳化

  • 調整伺服器核心引數
  • 配置合適的 swap 空間
  • 使用 SSD 儲存

資料庫最佳化

  • 調整 PostgreSQL 配置引數
  • 定期清理無用資料
  • 建立合適的索引

應用最佳化

  • 啟用快取機制
  • 合理配置外掛
  • 最佳化圖片和靜態資源

🔧 常見問題及解決方案

部署與使用過程中常見問題的解決方法

問題:Docker 部署後無法訪問

可能原因

  • 埠未開放
  • 防火牆阻止
  • 容器未正常啟動

解決方案

  • 檢查埠對映是否正確:docker-compose ps
  • 檢查防火牆設定,開放相應埠
  • 檢視容器日誌:docker-compose logs

問題:資料庫連線失敗

可能原因

  • 資料庫配置錯誤
  • 資料庫服務未啟動
  • 網路連線問題

解決方案

  • 檢查資料庫配置是否正確
  • 確保資料庫服務正常執行
  • 測試資料庫連線:psql -h localhost -U nocobase -d nocobase

問題:外掛安裝失敗

可能原因

  • 網路連線問題
  • 外掛版本與系統不相容
  • 伺服器資源不足

解決方案

  • 檢查網路連線是否正常
  • 確保外掛版本與系統版本相容
  • 檢查伺服器記憶體和磁碟空間是否充足

問題:系統執行緩慢

可能原因

  • 伺服器資源不足
  • 資料庫未最佳化
  • 外掛過多或配置不當

解決方案

  • 增加伺服器資源(CPU、記憶體)
  • 最佳化資料庫配置,建立合適的索引
  • 禁用不必要的外掛,最佳化系統配置