IronPDF授權金鑰可以解鎖您的Node.js應用程式的生產部署。 沒有有效的金鑰時,IronPDF會以試用模式運行,並在每個生成的PDF上蓋上浮水印。 應用授權金鑰會去除該浮水印並取消所有輸出限制,讓您擁有完全合規的文件,可以供最終使用者使用。 以下步驟將指導您獲取金鑰,正確配置並確認其已激活。

快速入門:在Node.js中應用IronPDF授權金鑰

您如何獲得IronPDF授權金鑰?

當您購買商業授權或註冊免費試用時,會發放授權金鑰。 這兩條路徑均通過相同的IronPDF授權頁面,那裡提供單一開發者、團隊和免版稅再分發等級的選項。

想在購買之前評估IronPDF,可註冊免費的30天試用授權。 試用金鑰激活所有生產功能——包括HTML到PDF渲染、PDF合併、蓋印和加密——這樣您就可以根據實際需求測試完整的API。

如果您的組織需要批量定價或企業協議,聯繫IronPDF銷售團隊以獲取自訂報價。

如何在Node.js中應用授權金鑰?

在呼叫任何IronPDF功能之前,設置全域配置物件上的licenseKey屬性。 將此初始化放在應用程式的入口點——通常是app.js檔案的前幾行——以便隨後的每個PDF操作都啟用了金鑰。

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-1.js
// Import IronPdfGlobalConfig from the IronPDF package
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Apply your license key at application startup
// Replace the placeholder with the key you received from Iron Software
IronPdfGlobalConfig.getConfig().licenseKey = "YOUR-LICENSE-KEY-HERE";
JAVASCRIPT

該分配立即生效——不需要重新啟動或重新導入。 此行之後的任何PDF操作都將使用已授權的引擎。

如何遵循授權金鑰的最佳實踐?

將授權金鑰直接硬編碼在源程式碼中會產生安全風險,特別是在公共倉庫中。 推薦的做法是將金鑰儲存在環境變數中,並在運行時讀取。

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-2.js
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Read the license key from an environment variable
// Set IRONPDF_LICENSE_KEY in your .env file or deployment environment
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;
JAVASCRIPT

使用此模式時,將.env文件中以進行本地開發,並在生產環境中配置主機平台的密碼管理系統中的變數。 將.gitignore以防止意外提交。

另外兩個實踐可降低運營風險:

  • 在啟動時只應用金鑰一次。 在每次請求中重複分配它無害但浪費週期。 在您的應用程式入口模組中初始化它。
  • 將金鑰排除在客戶端捆綁包之外。 授權金鑰初始化必須在伺服器上發生。 IronPDF for Node.js在伺服器端環境中運行,因此這是自然的放置——但請仔細檢查您的構建管道不會將IronPdfGlobalConfig捆綁到面向瀏覽器的程式碼中。

如何驗證您的授權金鑰是否有效?

應用金鑰後,在運行生產工作流之前確認其已被接受。 使用全域配置物件上的isLicensed標誌。

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-3.js
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Apply the license key
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

// Verify the key was accepted
const config = IronPdfGlobalConfig.getConfig();
if (config.isLicensed) {
    console.log("IronPDF: license key accepted — production mode active.");
} else {
    console.warn("IronPDF: running in trial mode — PDFs will contain a watermark.");
}
JAVASCRIPT

true結果確認金鑰有效且引擎在授權模式下運行。 false結果意味著金鑰未被認識——仔細檢查是否有額外的空格,截斷,或試用金鑰已過期。 如果問題持續存在,與IronPDF支援聯繫,並提供您的金鑰和Node.js版本。

下一步是什麼?

有了一個有效的授權金鑰,IronPDF引擎已為生產工作負載準備就緒。 從最常見的任務開始:

要升級您的授權等級或新增開發者座位,請存取IronPDF授權頁面開始免費試用以在購買前評估更高的等級。

常見問題

如何為Node.js專案獲取IronPDF授權金鑰?

在IronPDF授權頁面購買授權或註冊免費30天試用。註冊或購買確認後會透過電子郵件發送金鑰。

在Node.js應用程式中應該在哪裡套用授權金鑰?

在應用程式入口點(通常是index.jsapp.js的前幾行)套用金鑰,以便在調用任何IronPDF函式之前金鑰已經生效。

如果執行IronPDF時沒有授權金鑰會發生什麼事?

IronPDF會在試用模式下運行,並在每個生成的PDF上加上水印。套用有效的授權金鑰可以去除水印並解除所有輸出限制。

如何在Node.js中套用IronPDF授權金鑰?

@ironsoftware/ironpdf套件中匯入 IronPdfGlobalConfig,然後分配您的金鑰:IronPdfGlobalConfig.getConfig().licenseKey = 'YOUR-KEY';

如何避免在源程式碼中硬編碼授權金鑰?

將金鑰儲存在環境變數如IRONPDF_LICENSE_KEY中,然後使用process.env.IRONPDF_LICENSE_KEY在運行時讀取。將變數新增到您的託管平台的秘密管理器中以進行生產部署。

如何驗證IronPDF授權金鑰是否被接受?

讀取IronPdfGlobalConfig.getConfig().isLicensed。返回值true確認金鑰有效且引擎在授權模式下運行。

如果isLicensed返回false,您應該檢查什麼?

確認金鑰沒有被額外空格或截斷複製,確認試用未過期,並確保金鑰在執行任何IronPDF操作之前已設置。如問題持續,請聯繫IronPDF支援。

相同的授權金鑰可以在多個Node.js伺服器上使用嗎?

授權條款取決於您購買的級別。單一開發者授權涵蓋一名開發者;團隊和免版稅授權涵蓋更廣泛的部署情境。請檢查IronPDF授權頁面以找到符合您部署需求的級別。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

準備好開始了嗎?
版本: 2026.6 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想要快速的證據嗎?
運行範例觀看您的HTML變為PDF。