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

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

在應用程式入口點（通常是 index.js 或 app.js 的前幾行）套用金鑰，以便在調用任何IronPDF函式之前金鑰已經生效。

Q: 如何在Node.js中套用IronPDF授權金鑰？

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

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

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

Q: 如何驗證IronPDF授權金鑰是否被接受？

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

Curtis Chau

Updated: 2026年9月17日

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

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

在三個步驟中應用您的IronPDF授權金鑰：

獲取授權金鑰 - 購買授權或從IronPDF授權頁面申請免費的30天試用。
在任何PDF操作之前設置金鑰 - 在應用程式啟動時將其分配給IronPdfGlobalConfig.getConfig().licenseKey。
驗證金鑰是否有效 - 呼叫true回傳值。

您如何獲得IronPDF授權金鑰？

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

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

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

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

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

// 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";

// 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操作都將使用已授權的引擎。

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

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

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;

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標誌。

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.");
}

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引擎已為生產工作負載準備就緒。從最常見的任務開始：

從HTML生成PDF - 將HTML字串、檔案或URL轉換為像素準確度的PDF文件。
合併、分割和操作現有的PDF - 組合多個文件或提取特定頁面範圍。
新增頁眉、頁腳和浮水印 - 以一致的頁元素來標記您的輸出。
**探索完整的IronPDF for Node.js文件**以獲取API參考、教程和程式碼範例。

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

常見問題

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

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

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

在應用程式入口點（通常是index.js或app.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授權頁面以找到符合您部署需求的級別。

What are the next steps after applying the IronPDF license key?

After applying the license key, you can start generating, merging, and manipulating PDFs, and explore IronPDF's full documentation for more features and capabilities.