部署生成或处理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

在开发过程中不需要重启或重新发布。 对于生产部署,添加密钥后需清理并重新发布。

如何安装Python上的IronPDF?

在应用许可证密钥之前,IronPDF必须存在于Python环境中。 使用 pip 安装:

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

请注意IronPDF for Python 基于 IronPDF .NET 库构建,需要在主机上安装 .NET 6.0 SDK。在运行 pip install 之前,请从 Microsoft 下载该 SDK。

一旦 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操作之前必须指定许可证密钥。 如果您的项目有多个入口点,例如网络处理程序和后台工作程序—请在每个入口点添加分配。)]}

免费下载30天试用密钥以评估完整功能集,然后再购买。 试用密钥遵循相同的分配语法。 要获得完整许可证,请访问IronPDF 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许可证密钥分配到哪里?

在脚本的最顶部使用License.LicenseKey = 'YOUR-KEY'分配密钥,在所有其他IronPDF调用之前。如果在已经运行一个PDF操作之后才应用密钥,将不会从该操作中移除水印。

IronPDF for Python中的IsLicensed和IsValidLicense()有什么不同?

License.IsLicensed是一个布尔属性,反映当前运行时会话中是否有有效密钥激活。License.IsValidLicense(key)是一个方法,用于检查某个特定密钥字符串是否有效并被识别—在应用之前验证从环境变量或配置文件读取的密钥非常有用。

如何在Python中获得IronPDF的免费试用许可证密钥?

访问IronPDF试用许可证页面并注册获取免费30天试用密钥。与完整许可证密钥使用License.LicenseKey = 'YOUR-TRIAL-KEY'相同方式应用。

IronPDF for Python需要安装.NET SDK吗?

是的。IronPDF for Python基于IronPDF .NET库并需要在主机计算机上安装.NET 6.0 SDK。请在运行pip install ironpdf之前从Microsoft .NET下载页面下载。

如果使用IronPDF但没有许可证密钥会发生什么?

没有有效的许可证密钥,IronPDF将以试用模式运行,并在每个生成或处理的PDF文档的每一页上加盖水印。要去除水印,请在首次PDF操作之前应用有效的完整或试用许可证密钥。

我应该如何在生产应用程序中安全存储IronPDF许可证密钥?

将许可证密钥存储在诸如IRONPDF_LICENSE_KEY的环境变量中并使用os.environ.get在应用程序启动时读取。在任何PDF操作运行之前将其分配给License.LicenseKey。这可以将密钥排除在源代码管理之外。

在应用新许可证密钥后,是否需要重启或重新发布应用程序?

在开发过程中,密钥会立即在运行中的进程中生效。对于生产部署,在更新许可证密钥后清理并重新发布应用程序以防止过时的环境状态。

我可以将IronPDF许可证密钥应用一次并在多个脚本中重复使用吗?

License.LicenseKey分配仅适用于当前进程。每个脚本或进程入口点必须在调用IronPDF API之前赋予密钥。如果您的项目有多个入口点,请将分配添加到每个入口点。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

准备开始了吗?
版本: 2026.5 just released
Still Scrolling Icon

还在滚动吗?

想快速获得证据?
运行示例看着你的HTML代码变成PDF文件。