NocoBase 商業授權激活指南。通過全新的“實例 ID”和“授權密鑰”方式，快速、安全地激活您的商業版功能。

原文鏈接：https://www.nocobase.com/cn/blog/nocobase-commercial-license-activation-guide

NocoBase 商業授權激活指南

為了提升用戶體驗并增強安全性，我們對商業授權和激活流程進行了全面升級。新的授權方式取代了以往在配置文件中填寫用戶名和密碼的舊方法，引入了“實例 ID (Instance ID)”和“授權密鑰 (License-key)”的機制。

新方案的核心優勢在于：

• 提升安全性：不再需要明文存儲您的賬戶信息，降低了敏感信息泄露的風險。
• 簡化流程：授權與您的 NocoBase 實例直接綁定，管理和更新授權更加直觀、便捷。
• 增強靈活性：當您的部署環境發生變化時，可以輕松重新生成授權，快速適應新環境。
• 授權保障：通過后端的授權管理和狀態監控，您可以監控授權的實際使用情況 ，及時發現并處理非授權的應用，避免商業授權被盜用 。

本指南將引導您完成全新的 NocoBase 商業授權激活流程。

---

授權激活分步指南

在開始前，請確保您已成功安裝并運行了 NocoBase 社區版。

第一步：訪問授權頁面并復制實例 ID (Instance ID)

1. 在您本地的 NocoBase 應用中，訪問 系統設置 -> 授權設置 (License settings) 頁面。
2. 在此頁面，您會看到一串 Instance ID，這是您當前運行環境的唯一標識。點擊其右側的復制圖標。

第二步：在 Service 平臺創建應用并關聯實例 ID

1. 登錄 NocoBase Service 平臺，在“應用”管理頁面點擊“添加”按鈕。
2. 在彈出的表單中，填寫您的應用信息，并將上一步復制的 Instance ID 粘貼到 Instance ID 輸入框中，然后提交。

第三步：獲取授權密鑰 (License Key)

1. 應用創建成功后，返回授權列表，找到對應的條目，點擊操作欄中的“查看授權”按鈕。
2. 在授權詳情彈窗中，點擊“復制”按鈕，即可獲取與您實例匹配的 License Key。
   

第四步：在 NocoBase 中配置授權密鑰

1. 返回您本地 NocoBase 的 授權設置 (License settings) 頁面。
2. 將剛剛復制的 License Key 粘貼到 License key 輸入框中，點擊“提交”按鈕。
3. 保存成功后，系統會提示“License key saved successfully, please restart the server”，表明授權密鑰已配置成功，等待重啟。

第五步：完成激活并下載商業版本和商業插件

重啟您的 NocoBase 服務以應用授權并自動下載商業版本和商業插件。

• 對于 Docker 部署：執行重啟命令 docker compose restart app。
• 對于源碼或 create-nocobase-app 部署：在項目根目錄下執行 yarn nocobase pkg download-pro 命令。

服務重啟并成功下載插件后，您的商業版授權即已激活。如需變更授權，可再次進入授權設置頁面，點擊“更改key”按鈕，重復以上流程。

---

如何查看授權信息

授權激活后，您可以隨時點擊 NocoBase 界面右上角的授權信息圖標，查看當前授權的詳細狀態，包括授權版本、到期日、域名匹配狀態及已授權插件列表等。

---

部署與授權快速檢查清單

遇到問題時，可以對照這份清單快速排查：

• 第一步：獲取 Instance ID
  • NocoBase 社區版/未授權版 已成功運行。
  • 已從 License settings 頁面完整復制了 Instance ID。
• 第二步：生成 License Key
  • 已在 Service 平臺創建應用。
  • 創建應用時粘貼的 Instance ID 是最新且正確的。
  • 已從"查看授權"中完整復制了 License Key。
• 第三步：激活
  • 已將 License Key 粘貼回 NocoBase 并成功保存。
  • 已根據部署方式執行了重啟容器或 download-pro 命令。 (很多用戶會漏掉這一步！)
• 驗證
  • 授權信息彈窗中顯示狀態為"Active"(已激活)。

常見問題與解答 (FAQ)

在安裝或使用過程中，您可能會遇到以下提示，請根據對應的解決方案進行處理：

1. License key mismatch - 授權密鑰與環境不匹配

【問】為什么我配置好后，提示 License key mismatch (授權密鑰不匹配)？

【答】可能是您的運行環境發生了變化，導致"Instance ID"更新了，但您的應用中還是舊的"License Key"。
解決方案：請嚴格按照本指南的第一步，去獲取您當前環境最新的 Instance ID，然后走完后續流程，生成一把新的"鑰匙"即可。

2. Invalid license key - 授權密鑰已失效

【問】提示 Invalid license key 是什么意思？

【答】您的 License Key 可能已過期或因其他原因被平臺標記為無效。
解決方案：請聯系我們或在服務平臺檢查您的授權狀態。如果需要，請重新生成 License Key 并配置。

3. Invalid license key format - 授權密鑰格式錯誤

【問】提示 Invalid license key format 怎么辦？

【答】您粘貼的 License Key 不完整或格式有誤，導致系統無法解析。
解決方案：請返回服務平臺，確保完整復制了 License Key，然后重新粘貼并保存。

4. 訪問系統時，強制彈出授權信息提示框

【問】為什么總是彈出授權信息提示框？

【答】出現此彈窗通常意味著授權校驗失敗?？赡艿脑虬ǎ?/p>

• License Key 已損壞或與本地環境不匹配
• 授權已過期或失效
• License Key 與您正在運行的商業插件版本不匹配

解決方案：最直接的解決方法是完整地重新執行一遍授權配置流程：獲取最新的 Instance ID，生成新的 License Key，并設置到本地系統中。

5. 環境遷移相關問題

【問】我遷移了服務器/數據庫，商業插件就用不了了，怎么辦？

【答】這和上一個問題是同一個原因。服務器或數據庫是構成"身份證 (Instance ID)"的關鍵信息，它們一變，Instance ID 就會變。

解決方案：和上面一樣，獲取新的 Instance ID，生成新的 License Key，重新激活一次。整個過程就像您搬家后去更新身份證地址一樣。

6. 插件未生效問題

【問】我已經重啟了，為什么商業插件還是沒生效？

【答】如果確認 License Key 配置無誤，可以嘗試以下排查：

1. 檢查網絡：確保您的服務器可以訪問 NocoBase 的 npm 倉庫。
2. 查看日志：檢查 NocoBase 啟動時的日志，看看是否有插件下載失敗或授權校驗失敗的錯誤信息。
3. 手動執行：如果您是源碼部署，可以再次手動執行 yarn nocobase pkg download-pro 命令，并觀察命令行輸出。

7. 新舊授權方式對比

【問】這個流程和我之前用用戶名/密碼的方式有什么不同？

【答】舊的方式是將您的賬戶密碼直接暴露在環境中，不夠安全。新的 License Key 體系有幾個好處：

1. 更安全：您無需暴露主賬戶密碼，只使用與特定環境綁定的密鑰。
2. 更靈活：您可以為不同的客戶或項目生成不同的 License Key，方便管理。
3. 更清晰：授權信息一目了然，所有細節都記錄在 Service 平臺上。