部署能產生或處理 PDF 的 Python 應用程式,需具備有效的 IronPDF 授權金鑰。 若未購買授權,所有輸出文件均會帶有 IronPDF 水印,且該函式庫將以試用模式運作。 套用您的金鑰只需不到五行程式碼,且必須在執行任何 PDF 操作之前完成。
快速入門:在 Python 中套用 IronPDF 授權金鑰
三步驟完成 IronPDF 授權金鑰的套用:
透過 pip 安裝 IronPDF:
//:path=install.sh :ProductInstall//:path=install.sh :ProductInstallSHELL請在腳本頂端、任何 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確認金鑰已獲接受:
//: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 activePYTHON
開發過程中無需重新啟動或重新發佈。 若用於正式部署,請在加入金鑰後執行清理並重新發佈。
如何安裝 IronPDF for Python?
在套用授權金鑰之前,Python 環境中必須已安裝 IronPDF。 請使用 pip 安裝:
//:path=install.sh
:ProductInstall//:path=install.sh
:ProductInstallpip 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"若您希望在購買前評估完整功能集,可申請免費 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}")請在應用程式啟動邏輯或狀態檢查中使用 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.")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.")此模式可將敏感憑證排除在版本控制之外,並能在開發、預備和生產環境中運作,無需修改程式碼。
接下來該怎麼做?
只要套用有效的授權金鑰,IronPDF for Python 即可投入全面生產使用。 請參考以下資源以利後續進行:
- 開始使用 IronPDF for Python — 官方入門教學將從零開始,逐步引導您完成 HTML 轉 PDF、PDF 處理以及常見的文件工作流程。
- IronPDF for Python 程式碼範例 — 一個包含可直接執行的 Python 範例庫,涵蓋 PDF 生成、合併、加蓋水印、表單處理等功能。
- 購買完整授權或開始免費試用 — 取得 30 天試用評估用的試用授權金鑰,或購買正式授權以無限制地部署。
常見問題
在 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 之前,都必須先指派該金鑰。若您的專案有多個入口點,請在每個入口點中加入此指派。







