部署能產生或處理 PDF 的 Python 應用程式,需具備有效的 IronPDF 授權金鑰。 若未購買授權,所有輸出文件均會帶有 IronPDF 水印,且該函式庫將以試用模式運作。 套用您的金鑰只需不到五行程式碼,且必須在執行任何 PDF 操作之前完成。

快速入門:在 Python 中套用 IronPDF 授權金鑰

三步驟完成 IronPDF 授權金鑰的套用:

  1. 透過 pip 安裝 IronPDF:

    //:path=install.sh
    :ProductInstall
    //:path=install.sh
    :ProductInstall
    SHELL
  2. 請在腳本頂端、任何 PDF 操作之前設定 LicenseKey 屬性:

    //:path=apply_license.py
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    //:path=apply_license.py
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    PYTHON
  3. 確認金鑰已獲接受:

    //:path=verify_license.py
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    //:path=verify_license.py
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    PYTHON

開發過程中無需重新啟動或重新發佈。 若用於正式部署,請在加入金鑰後執行清理並重新發佈。

如何安裝 IronPDF for Python?

在套用授權金鑰之前,Python 環境中必須已安裝 IronPDF。 請使用 pip 安裝:

//:path=install.sh
:ProductInstall
//:path=install.sh
:ProductInstall
SHELL

請注意IronPDF for Python 基於 IronPDF .NET 函式庫建構,並需在主機上安裝 .NET 6.0 SDK。請先從 Microsoft 下載該套件,再執行 pip install

一旦 pip 完成,ironpdf 套件即可在當前環境中的任何腳本中導入。 除了 .NET 執行階段依賴項外,無需任何額外配置。

如何在 Python 中套用 IronPDF 授權金鑰?

請在腳本最開頭 —— 在呼叫任何 IronPDF API 之前 —— 為 License 類別設定 LicenseKey 屬性。 將關鍵指派置於 PDF 操作之後,對這些呼叫不會產生任何影響。

//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
PYTHON

提示在每個腳本入口點執行首次 IronPDF 操作之前,必須先指派授權金鑰。 若您的專案包含多個入口點(例如 Web 處理程序和背景工作程序),請將此任務分別新增至每個入口點。

若您希望在購買前評估完整功能集,可申請免費 30 天試用金鑰。 試用金鑰採用相同的指派語法。 如需取得完整授權,請造訪 IronPDF for Python 授權頁面

如何驗證 IronPDF 授權金鑰?

License 類別中的兩個成員分別用於不同的驗證目的:IsLicensed 用於檢查執行階段中是否存在有效的金鑰,而 IsValidLicense() 則用於檢查特定金鑰字串是否結構上有效,並能被 IronPDF 的授權伺服器識別。

檢查執行環境是否已取得授權

License.IsLicensed 是一個布林屬性,當在當前執行階段中已套用有效的授權金鑰時,會返回 True。 在試用模式下運作時(無金鑰、金鑰已過期,或在 PDF 操作執行後才套用金鑰),會返回 False

//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")
//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")
PYTHON

請在應用程式啟動邏輯或狀態檢查中使用 IsLicensed 來確認執行時狀態。

驗證特定金鑰字串

License.IsValidLicense(key) 接受一個金鑰字串,若該特定金鑰有效且已啟用,則返回 True;若金鑰格式錯誤、已過期或無法識別,則返回 False。 這在從設定檔或環境變數接收授權金鑰時非常有用。

//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")
//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")
PYTHON

重要事項關鍵差異:IsLicensed 反映當前的執行時狀態,無論應用了哪個鍵。 IsValidLicense() 會評估一個特定的關鍵字串。 在套用金鑰前,請使用 IsValidLicense() 驗證來自外部來源的輸入。)}]

在已部署的應用程式中套用授權後會發生什麼情況?

在開發與本地測試階段,授權金鑰將在執行中的程序中立即生效。 無需重新建置或重新發佈。 針對生產環境部署及實際運作中的應用程式,建議在更新授權金鑰後,先清理並重新發佈應用程式,以避免過時的環境狀態導致系統出現意外行為。

請將授權金鑰儲存於環境變數或機密管理工具中,而非直接硬編碼於原始碼中。 請在應用程式啟動時讀取金鑰,並在執行首次 PDF 操作前進行指派:

//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")
//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")
PYTHON

此模式可將敏感憑證排除在版本控制之外,並能在開發、預備和生產環境中運作,無需修改程式碼。

請注意IronPDF 在試用模式下運作時,會在每個 PDF 頁面上產生浮水印。 若要從所有輸出中移除浮水印,必須在進行任何渲染或處理操作之前,先套用有效的授權金鑰。)}]

接下來該怎麼做?

只要套用有效的授權金鑰,IronPDF for Python 即可投入全面生產使用。 請參考以下資源以利後續進行:

常見問題

在 Python 腳本中,該將 IronPDF 授權金鑰的設定放在何處?

請在腳本最頂端(任何其他 IronPDF 呼叫之前)使用 License.LicenseKey = 'YOUR-KEY' 設定金鑰。若在 PDF 操作執行完畢後才套用金鑰,將無法移除該次操作產生的浮水印。

在 IronPDF for Python 中,IsLicensed 與 IsValidLicense() 之間有何差異?

License.IsLicensed 是一個布林屬性,用於反映當前執行階段中是否存在有效的金鑰。License.IsValidLicense(key) 是一個方法,用於檢查特定金鑰字串是否有效且被識別——這對於在使用前驗證從環境變數或設定檔讀取的金鑰非常有用。

如何取得 Python 版 IronPDF 的免費試用授權金鑰?

請造訪 IronPDF 試用授權頁面,註冊獲取免費 30 天試用授權金鑰。使用方式與正式授權金鑰相同,請透過 License.LicenseKey = '您的試用金鑰' 進行設定

IronPDF for Python 是否需要安裝 .NET SDK?

是的。IronPDF for Python 基於 IronPDF .NET 函式庫建構,並要求主機上已安裝 .NET 6.0 SDK。請先從 Microsoft .NET 下載頁面取得該套件,再執行 pip install ironpdf

若未使用授權金鑰而直接使用 IronPDF 會發生什麼情況?

若未輸入有效的授權金鑰,IronPDF 將以試用模式運作,並在每個生成或處理的 PDF 文件每一頁上加蓋浮水印。若要移除浮水印,請在執行首次 PDF 操作前,輸入有效的完整版或試用授權金鑰。

我該如何在生產環境的應用程式中安全地儲存 IronPDF 授權金鑰?

請將授權金鑰儲存於環境變數中(例如 IRONPDF_LICENSE_KEY),並在應用程式啟動時透過 os.environ.get 讀取該金鑰。在執行任何 PDF 操作之前,請將其指派給 License.LicenseKey。此舉可避免金鑰被納入版本控制。

套用新的授權金鑰後,是否需要重新啟動或重新發佈應用程式?

在開發過程中,金鑰會在執行中的程序中立即生效。針對生產環境部署,請在更新授權金鑰後清理並重新發佈應用程式,以避免環境狀態過時。

IronPDF 授權金鑰是否可以設定一次,然後在多個腳本中重複使用?

License.LicenseKey 的指派僅適用於當前程序。每個腳本或程序的入口點在呼叫 IronPDF API 之前,都必須先指派該金鑰。若您的專案有多個入口點,請在每個入口點中加入此指派。

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

準備開始了嗎?
版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎?
執行範例 觀看您的 HTML 轉為 PDF。