快速入門內部部署安裝
此頁面上的指示說明如何在自行託管基礎結構上安裝Adobe Commerce。 如需升級現有安裝的指南，請參閱 升級指南。
Adobe使用撰寫器來管理Adobe Commerce元件及其相依性。 使用Composer來取得Adobe Commerce中繼資料具備下列優點：
- 重複使用協力廠商程式庫，無需搭配原始程式碼使用
- 使用元件式架構搭配強大的相依性管理，減少擴充功能衝突及相容性問題
- 遵守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。因為殼層有不同的語法，請查閱參考資料，例如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>是網頁伺服器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中建立並設定公開和私密金鑰。
note note NOTE 使用Composer auth.json檔案或環境變數時，系統不會提示您輸入驗證金鑰。如果您遇到錯誤（例如
Could not find package...或...no matching package found），請確定您的命令中沒有拼寫錯誤。 如果您仍然遇到錯誤，您可能無權下載Adobe Commerce。 請連絡Adobe Commerce支援尋求協助。如需更多錯誤的說明，請參閱疑難排解。
範例 — 次要版本
次要發行包含新功能、品質修正和安全性修正。 使用Composer指定次要版本。 例如，若要指定Adobe Commerce 2.4.6中繼資料：
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
範例 — 品質修補程式
品質修補程式主要包含功能性 和 安全性修正。 不過，它們有時也可能包含向後相容的新功能。 使用Composer下載品質修補程式。 例如，若要指定Adobe Commerce 2.4.6中繼資料：
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。 這是必要的，以便命令列可以將檔案寫入檔案系統。
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