如何取得 IronPDF 授權金鑰？

當您購買商業授權或註冊免費試用授權時，系統將發放授權金鑰。 這兩條路徑皆會導向相同的 IronPDF 授權頁面，該頁面提供單一開發者、團隊以及免版稅再分發等不同授權方案。

若要在決定購買前評估 IronPDF，請註冊免費的 30 天試用授權。 此試用金鑰可啟用所有正式版功能——包括 HTML 轉 PDF 渲染、PDF 合併、加蓋水印及加密——讓您能依據實際需求測試完整的 API 功能。

若貴組織需要批量定價或 Enterprise 協議，請聯繫 IronPDF 銷售團隊以獲取客製化報價。

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

在呼叫任何 IronPdf 函式之前，請先設定全域設定物件的 licenseKey 屬性。 請將此初始化程式碼置於應用程式的入口點 —— 通常是 index.js 或 app.js 檔案的前幾行 —— 以便在後續所有 PDF 操作中皆能啟用此金鑰。

//:path=apply-license-key.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";

//:path=apply-license-key.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=apply-license-key-env.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;

//:path=apply-license-key-env.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;

使用此模式時，請在 IRONPDF_LICENSE_KEY=your-key 檔案中加入 .env 供本地開發使用，並在生產環境中於託管平台的祕密管理系統中設定該變數。 請在 .env 至 .gitignore 之間加入 .env，以防止意外提交。

另有兩項實務做法可降低營運風險：

• 請在啟動時僅套用一次金鑰。雖然在每次請求時重複套用金鑰並無大礙，但會浪費處理資源。 請在應用程式的入口模組中初始化它。
• 請勿將金鑰包含在客戶端套件中。授權金鑰的初始化必須在伺服器端進行。 IronPDF for Node.js 運行於伺服器端環境，因此此處是其自然的位置——但請務必確認您的建置流程不會將 IronPdfGlobalConfig 封裝至面向瀏覽器的程式碼中。

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

套用金鑰後，請確認金鑰已獲接受，再執行您的生產工作流程。 請在全域設定物件上使用 isLicensed 標記。

//:path=verify-license-key.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.");
}

//:path=verify-license-key.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.");
}

true 的結果確認金鑰有效，且引擎正在授權模式下運行。 false 的結果表示無法識別金鑰 — 請仔細檢查是否有多餘的空白、金鑰被截斷，或是試用金鑰已過期。 若問題持續存在，請聯絡 IronPDF 支援團隊，並提供您的金鑰及 Node.js 版本。

接下來該怎麼做？

只要具備有效的授權金鑰，IronPDF 引擎即可投入生產環境使用。 請從最常見的任務開始：

• 從 HTML 生成 PDF — 將 HTML 字串、檔案或 URL 轉換為像素級精準的 PDF 文件。
• 合併、分割及處理現有 PDF 檔案 — 結合多個檔案或擷取特定頁碼範圍。
• 添加頁首、頁尾和浮水印 — 透過一致的頁面元素為輸出內容建立品牌識別。
• 請參閱完整的 IronPDF for Node.js 文件，以獲取 API 參考、教學指南及程式碼範例。

若要升級授權等級或增加開發者席次，請造訪 IronPDF 授權頁面，或開始免費試用以評估更高階的授權方案，再決定是否購買。