[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}
快速启动内部部署
本页上的说明介绍了如何在自托管基础架构上安装Adobe Commerce。 有关升级现有安装的指导，请参阅 升级指南。
Adobe使用Composer管理Adobe Commerce组件及其依赖项。 使用Composer获取Adobe Commercemetapackage具有以下优势：
- 重用第三方库，而无需将它们与源代码捆绑在一起
- 通过使用基于组件的架构和强大的依赖关系管理，减少扩展冲突和兼容性问题
- 遵守PHP-Framework Interoperability Group (FIG)标准
- 将Magento Open Source与其他组件重新打包
- 在生产环境中使用Adobe Commerce软件
先决条件
在继续之前，必须执行以下操作：
以文件系统所有者的身份登录
在所有权和权限概述主题中了解所有权、权限和文件系统所有者。
切换到文件系统所有者：
-
以具有写入文件系统权限的用户身份登录或切换到应用程序服务器。
如果使用bash shell，则可以使用以下语法切换到文件系统所有者并同时输入命令：
code language-bash su <file system owner> -s /bin/bash -c <command>如果文件系统所有者不允许登录，您可以执行以下操作：
code language-bash sudo -u <file system owner> <command> -
若要从任何目录运行CLI命令，请将
<app_root>/bin添加到您的系统PATH。由于shell具有不同的语法，请查阅unix.stackexchange.com之类的引用。
CentOS的bash shell示例：
code language-bash export PATH=$PATH:/var/www/html/magento2/bin或者，也可以通过以下方式运行命令：
cd <app_root>/bin并作为./magento <command name>运行app_root>/bin/magento <command name><app_root>是Web服务器docroot的子目录
获取隐喻
要获取Adobe Commerce的比喻，请执行以下操作：
-
以文件系统所有者的身份登录或切换到您的应用程序服务器。
-
转到Web服务器docroot目录或您已配置为虚拟主机docroot的目录。
-
使用Commerce隐喻创建编辑器项目。
Magento Open Source
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>Adobe Commerce
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>出现提示时，输入您的身份验证密钥。 从Commerce Marketplace — 访问密钥创建和配置公钥和私钥。 对于
username，复制并粘贴公钥值。 对于password，复制并粘贴私钥值。note note NOTE 如果使用使用Commerce身份验证密钥配置的编辑器 [auth.json](https://experienceleague.adobe.com/zh-hans/docs/commerce-cloud-service/user-guide/develop/authentication-keys)文件或环境变量，则不会提示您输入身份验证密钥。如果遇到错误（如
Could not find package...或...no matching package found），请确保命令中没有拼写错误。 如果仍遇到错误，则可能无权下载Adobe Commerce。 请联系Adobe Commerce支持以获取帮助。请参阅疑难解答以获取更多错误的帮助。
示例 — 次要版本
次发行版本包含新功能、质量修复和安全修复。 使用编辑器指定次要版本。 例如，要指定Adobe Commerce 2.4.6metapackage，请执行以下操作：
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
示例 — 质量修补程序
质量修补程序主要包含功能性 和 安全修补程序。 但是，它们有时也可以包含向后兼容的新功能。 使用Composer下载质量修补程序。 例如，要指定Adobe Commerce 2.4.6metapackage，请执行以下操作：
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
示例 — 安全修补程序
安全修补程序仅包含安全修补程序。 它们旨在使升级过程更快、更轻松。
安全修补程序使用Composer命名约定2.4.6-px。 使用Composer指定修补程序。 例如，要下载Adobe Commerce 2.4.6-p1中继包，请执行以下操作：
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
设置文件权限
在安装Adobe Commerce之前，必须设置Web服务器组的读写权限。 这是必要的，以便命令行可以将文件写入文件系统。
cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento
安装应用程序
您必须使用命令行安装Adobe Commerce。
此示例假定安装目录名为magento2ee，db-host在同一计算机(localhost)上，db-name、db-user和db-password均为magento：
bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname选项自定义管理员URI。 但是，Adobe建议忽略此选项，并允许安装命令自动生成随机URI。 黑客或恶意软件更难利用随机URI。 安装完成后，控制台中会显示URI。命令摘要
要显示完整的命令列表，请输入：
bin/magento list
要获取特定命令的帮助，请输入：
bin/magento help <command>
例如：
bin/magento help setup:install
bin/magento help cache:enable
下表总结了可用的命令。 命令仅以摘要形式显示。 有关命令的详细信息，请单击“命令”列中的链接。
magento setup:installmagento setup:uninstallmagento setup:upgrademagento maintenance:{enable/disable}magento setup:config:setmagento module:{enable/disable}magento setup:store-config:setmagento setup:db-schema:upgrademagento setup:db-data:upgrademagento setup:db:statusmagento admin:user:create部署配置
至少启用
Magento_User和Magento_Authorization个模块数据库（最简单的方法是使用
bin/magento setup:upgrade）magento listmagento help常用参数
以下参数对所有命令都是通用的。 这些命令可以在安装应用程序之前或之后运行：
--help-h./magento help setup:install或./magento help setup:config:set。--quiet-q--no-interaction-n--verbose=1,2,3-v, -vv, -vvv--verbose=3或-vvv显示调试详细程度，这是最详细的输出。 默认值为--verbose=1或-v。--version-V--ansi--no-ansi