文档Commerce云上 Commerce 指南

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

管理员变量

Last update: Wed Mar 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 开发人员

对云基础架构项目上的Adobe Commerce具有管理访问权限的用户可以使用以下项目环境变量覆盖管理用户帐户的配置设置以访问管理UI。

管理员凭据

您可以在安装Commerce期间使用下表中的管理员变量覆盖管理员用户凭据。

如果要在安装后更改值，请使用SSH连接到您的环境，并使用Adobe Commerce CLI admin:user命令创建或编辑Admin用户凭据。

变量
默认
描述
ADMIN_USERNAME
许可证所有者电子邮件地址
能够创建其他用户（包括管理用户）的管理用户的用户名。
ADMIN_EMAIL
管理用户的电子邮件地址。 此地址用于发送密码重置通知。
ADMIN_PASSWORD
管理用户的密码。 创建项目后，将生成随机密码并向许可证所有者发送电子邮件。 在项目创建期间，许可证所有者应该已经更改了密码。 请与许可证所有者联系以获取更新的密码。
ADMIN_LOCALE
en_US
管理员使用的默认区域设置。

管理员URL

使用以下环境变量保护对管理员UI的访问。 如果指定，此值将在安装期间覆盖默认URL。 在云基础架构的Adobe Commerce中，您必须使用（Cloud Console或Cloud CLI）中的ADMIN_URL变量设置或更改管理员URL。 从Admin修改设置仅适用于内部部署。

ADMIN_URL — 用于访问管理员UI的相对URL。 默认URL为/admin。

更改管理员URL

默认情况下，Commerce管理员 URL设置为​<域名>/管理员。 出于安全原因，Adobe建议将其更改为不容易猜测的唯一自定义管理员URL。

在云基础架构的Adobe Commerce中，您必须使用（Cloud Console或Cloud CLI）中的ADMIN_URL环境变量更改管理员URL。 从Admin修改设置仅适用于内部部署。 对于内部部署，请遵循使用自定义管理员URL。

Adobe建议在安装后更改管理员URL的环境级变量。 在从克隆的master环境进行分支之前，出于安全原因配置此设置。 从master分支创建的所有分支都会继承环境级变量及其值，除非您将继承设置为false。

使用Cloud Console或Cloud CLI设置或更新ADMIN_URL。

选项A：使用Cloud Console更改管理员URL

集成环境

从Cloud Console，添加新的变量，其包含：

  • 名称： ADMIN_URL

  • 值：​您的新管理员URL（例如，magento_A8v10）

  • 有关详细步骤，请参阅我们的开发人员文档中的添加环境变量或环境变量。

在Cloud Console中设置管理员URL

  1. 登录到云控制台。

  2. 从​ All projects ​列表中选择一个项目。

  3. 在项目概述中，选择环境并单击配置图标。

  4. 选择​ Variables ​选项卡。

  5. 单击​Create Variable(或编辑现有的ADMIN_URL变量（如果存在）。

  6. 输入以下内容：

    • 变量名称： ADMIN_URL
    • 值：​您的新管理员路径（例如，magento_A8v10）。

    默认情况下，已选择​ Available during runtime ​和​Make inheritable。 要防止子环境继承此值，请清除此变量的​Make inheritable。

  7. 单击​Create variable（或​Save）并等待部署完成。 仅当必填字段包含值时，按钮才可见。

当暂存和生产在Cloud Console中不可用时

提交支持票证，请求为暂存或生产环境添加ADMIN_URL变量。 如果可从Cloud Console访问暂存和生产环境，请按照集成环境中的说明添加变量。

选项B：使用Cloud CLI更改管理员URL

使用magento-cloud variable:update命令更新变量。 （variable:set命令已弃用，不可用。）

以下示例将master环境ADMIN_URL更新为newAdmin_A8v10并阻止子环境继承该值：

magento-cloud variable:update ADMIN_URL --value newAdmin_A8v10 -e master --inheritable false
  • 重新部署：​更改Cloud CLI中的ADMIN_URL变量会触发环境的重新部署。
  • 继承：​变量默认可继承。 要防止子环境继承该值，请使用所示的--inheritable false选项。 有关详细信息，请参阅变量级别可见性。
NOTE
ADMIN_URL值接受字母(a-z、A-Z)、数字(0-9)和下划线字符(_)。 不接受空格或其他字符。
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938