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";
該分配立即生效——不需要重新啟動或重新導入。 此行之後的任何PDF操作都將使用已授權的引擎。
如何遵循授權金鑰的最佳實踐?
將授權金鑰直接硬編碼在源程式碼中會產生安全風險,特別是在公共倉庫中。 推薦的做法是將金鑰儲存在環境變數中,並在運行時讀取。
:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-2.jsimport { 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;
使用此模式時,將.env文件中以進行本地開發,並在生產環境中配置主機平台的密碼管理系統中的變數。 將.gitignore以防止意外提交。
另外兩個實踐可降低運營風險:
- 在啟動時只應用金鑰一次。 在每次請求中重複分配它無害但浪費週期。 在您的應用程式入口模組中初始化它。
- 將金鑰排除在客戶端捆綁包之外。 授權金鑰初始化必須在伺服器上發生。 IronPDF for Node.js在伺服器端環境中運行,因此這是自然的放置——但請仔細檢查您的構建管道不會將
IronPdfGlobalConfig捆綁到面向瀏覽器的程式碼中。
如何驗證您的授權金鑰是否有效?
應用金鑰後,在運行生產工作流之前確認其已被接受。 使用全域配置物件上的isLicensed標誌。
:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-3.jsimport { 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.");
}
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授權頁面以找到符合您部署需求的級別。





