설명서Commerce설치 안내서

[온-프레미스]{class="badge informative" title="Adobe Commerce 온-프레미스 프로젝트에만 적용됩니다."}

온-프레미스 배포용 Nginx 설치 nginx

Last update: Wed Apr 01 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 경험
  • 관리자
  • 개발자

이 안내서에서는 Adobe Commerce 온-프레미스 배포용 Ngix를 설치하고 Commerce에 필요한 Ngix 설정을 구성하는 방법을 안내합니다. 여기에는 PHP-FPM 구성을 위한 지침과 함께 Ubuntu 및 CentOS에 대한 운영 체제별 절차가 포함되어 있습니다. Adobe은 이 안내서에 제공된 구성 지침을 따라 Commerce 애플리케이션의 기능과 보안을 모두 유지하는 것을 권장합니다.

Adobe은 Adobe Commerce 릴리스의 시스템 요구 사항에 나열된 Nginx 버전을 지원합니다. 지원되는 버전은 릴리스에 따라 다릅니다. Nginx에도 지원되는 PHP-FPM 구성이 필요합니다. 관련 PHP 요구 사항은 PHP을 참조하십시오.

Ubuntu에 설치

이 섹션을 사용하여 Nginx, PHP 및 MySQL이 있는 Ubuntu에 Adobe Commerce을 설치합니다.

Nginx 설치

sudo apt -y install nginx

소스에서 Nginx를 빌드할 수도 있습니다.

다음 섹션을 완료하고 응용 프로그램을 설치한 후 샘플 구성 파일을 사용하여 Nginx를 구성합니다. 이 권장 구성은 Commerce 애플리케이션의 기능과 보안을 모두 유지합니다.

PHP-FPM 설치 및 구성

Adobe Commerce이 제대로 작동하려면 여러 PHP 확장이 필요합니다. Nginx를 사용하는 경우 이러한 확장 외에도 php-fpm 확장 프로그램을 설치하고 구성해야 합니다.

php-fpm을(를) 설치하고 구성하려면:

  1. Adobe Commerce 릴리스에서 지원하는 PHP 버전용 php-fpm 및 php-cli 패키지를 설치하십시오. Ubuntu에서 패키지 이름은 일반적으로 다음 패턴을 따릅니다.

    code language-bash 
    apt-get -y install php<php-version>-fpm php<php-version>-cli
    note note
    NOTE
    <php-version>을(를) 설치 중인 Adobe Commerce 릴리스의 시스템 요구 사항에 나열된 지원되는 PHP 부 버전으로 바꾸십시오. 다음 단계에서 파일 경로, 서비스 이름 및 소켓 경로에 동일한 값을 사용합니다.

  2. 편집기에서 php.ini 파일을 엽니다.

    code language-bash 
    vim /etc/php/<php-version>/fpm/php.ini
    code language-bash 
    vim /etc/php/<php-version>/cli/php.ini

  3. 다음 라인과 일치하도록 두 파일을 편집합니다.

    code language-conf 
    memory_limit = 2G
max_execution_time = 1800
zlib.output_compression = On
    note note
    NOTE
    Adobe은 Adobe Commerce을 테스트할 때 메모리 제한을 2GB로 설정하는 것이 좋습니다. 자세한 내용은 필수 PHP 설정을 참조하세요.

  4. 저장하고 편집기를 종료합니다.

  5. php-fpm 서비스 다시 시작:

    code language-bash 
    systemctl restart php<php-version>-fpm

MySQL 설치 및 구성

자세한 내용은 MySQL을 참조하세요.

Adobe Commerce 설치

다음과 같은 여러 가지 방법으로 Adobe Commerce을 다운로드할 수 있습니다.

이 예에서는 명령줄을 사용한 작성기 기반 설치를 보여 줍니다.

  1. 파일 시스템 소유자(으)로 응용 프로그램 서버에 로그인합니다.

  2. 웹 서버 docroot 디렉토리 또는 가상 호스트 docroot로 구성한 디렉토리로 변경합니다. 이 예제에서는 Ubuntu 기본 /var/www/html을(를) 사용합니다.

    code language-bash 
    cd /var/www/html

  3. Composer를 전체적으로 설치합니다. Composer는 Adobe Commerce을 설치하기 전에 종속성을 업데이트해야 합니다.

    code language-bash 
    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer

  4. Adobe Commerce 메타패키지를 사용하여 작성기 프로젝트를 만듭니다.

    Magento Open Source

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

    Adobe Commerce

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

    메시지가 표시되면 인증 키를 입력하십시오. 공개 키​은(는) 사용자 이름이고 개인 키​은(는) 암호입니다.

  5. 응용 프로그램을 설치하기 전에 웹 서버 그룹에 대한 읽기/쓰기 권한을 설정합니다. 명령줄이 파일 시스템에 파일을 쓸 수 있도록 해야 합니다.

    code language-bash 
    cd /var/www/html/<magento install directory>
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
    code language-bash 
    chown -R :www-data . # Ubuntu
    code language-bash 
    chmod u+x bin/magento

  6. 명령줄에서 설치합니다. 이 예제에서는 설치 디렉터리 이름이 magento2ee이고 데이터베이스 호스트가 동일한 컴퓨터(localhost)에 있다고 가정합니다.

    code language-bash 
    bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=<db-name> \
--db-user=<db-user> \
--db-password=<db-password> \
--backend-frontname=<backend-uri> \
--admin-firstname=<admin-first-name> \
--admin-lastname=<admin-last-name> \
--admin-email=<admin-email> \
--admin-user=<admin-user> \
--admin-password=<admin-password> \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=<search-engine-value> \
--<search-engine-host-parameter>=search-host.example.com \
--<search-engine-port-parameter>=9200
    note note
    NOTE
    설치 중인 Adobe Commerce 릴리스에 필요한 --search-engine 값과 일치하는 호스트/포트 옵션을 사용하십시오. 2.4.6 이전 버전의 경우 Elasticsearch 7 또는 OpenSearch용 elasticsearch7 옵션과 함께 --elasticsearch-*을(를) 사용합니다. 버전 2.4.6 이상의 경우 해당 릴리스에서 지원하는 검색 엔진 값 및 해당 CLI 옵션을 사용하십시오.

  7. 개발자 모드로 전환:

    code language-bash 
    cd /var/www/html/magento2/bin
    code language-bash 
    ./magento deploy:mode:set developer

Nginx 구성

Adobe에서는 Commerce 응용 프로그램의 기능과 보안을 모두 유지하기 위해 설치 디렉터리와 Nginx 가상 호스트 구성에 제공된 nginx.conf.sample 구성 파일을 사용하여 Nginx를 구성할 것을 권장합니다.

IMPORTANT
nginx.conf.sample 파일은 필요한 응용 프로그램 라우팅과 보안 강화 규칙을 제공합니다. 예를 들어 서버에 업로드된 유해 스크립트의 실행을 제한합니다. 이 파일을 사용하지 않거나 해당 규칙을 수정하지 않는 경우 사용자 지정 nginx 구성에서 동일한 보안 컨트롤을 구현해야 합니다.

이 지침에서는 Nginx 가상 호스트(예: /etc/nginx/sites-available)에 대해 Ubuntu 기본 위치를 사용하고 Ubuntu 기본 docroot(예: /var/www/html)를 사용하고 있다고 가정합니다. 이러한 위치를 환경에 맞게 변경할 수 있습니다.

  1. 사이트에 대한 새 가상 호스트를 만듭니다.

    code language-bash 
    vim /etc/nginx/sites-available/magento

  2. 다음 구성을 추가합니다.

    code language-conf 
    upstream fastcgi_backend {
  server  unix:/run/php/php<php-version>-fpm.sock;
}

server {

  listen 80;
  server_name www.magento-dev.com;
  set $MAGE_ROOT /var/www/html/magento2;
  include /var/www/html/magento2/nginx.conf.sample;
}
    note note
    NOTE
    include 지시문은 설치 디렉터리의 샘플 nginx 구성 파일을 가리켜야 합니다.

  3. www.magento-dev.com을(를) 도메인 이름으로 바꾸십시오. 이 URL은 Adobe Commerce 설치 시 지정한 기본 URL과 일치해야 합니다.

  4. 저장하고 편집기를 종료합니다.

  5. /etc/nginx/sites-enabled 디렉터리에 symlink를 만들어 새로 만든 가상 호스트를 활성화합니다.

    code language-bash 
    ln -s /etc/nginx/sites-available/magento /etc/nginx/sites-enabled

  6. 구문이 올바른지 확인합니다.

    code language-bash 
    nginx -t

  7. Nginx 다시 시작:

    code language-bash 
    systemctl restart nginx

설치 확인

설치를 확인하려면 웹 브라우저를 열고 사이트의 기본 URL로 이동합니다. 자세한 내용은 설치 확인을 참조하세요.

CentOS 7에 설치

이 섹션을 사용하여 Nginx, PHP 및 MySQL이 있는 CentOS 7에 Adobe Commerce을 설치합니다.

Nginx 설치

yum -y install epel-release

yum -y install nginx

설치가 완료되면 ngix를 시작하고 부팅 시 시작되도록 구성합니다.

systemctl start nginx

systemctl enable nginx

다음 섹션을 완료하고 응용 프로그램을 설치한 후 샘플 구성 파일을 사용하여 Nginx를 구성합니다.

PHP-FPM 설치 및 구성

Adobe Commerce이 제대로 작동하려면 여러 PHP 확장이 필요합니다. Nginx를 사용하는 경우 이러한 확장 외에도 php-fpm 확장 프로그램을 설치하고 구성해야 합니다.

  1. php-fpm 설치:

    code language-bash 
    yum -y install <php-fpm-package>

  2. 편집기에서 /etc/php.ini 파일을 엽니다.

    note note
    NOTE
    설치 중인 Adobe Commerce 릴리스에서 지원하는 PHP 버전에 대해 php-fpm을(를) 제공하는 패키지를 설치하십시오. 패키지 이름은 저장소 및 운영 체제에 따라 다릅니다. 시스템 요구 사항을 참조하세요.

  3. cgi.fix_pathinfo 줄의 주석 처리를 제거하고 값을 0(으)로 변경합니다.

  4. 다음 행과 일치하도록 파일을 편집합니다.

    code language-conf 
    memory_limit = 2G
max_execution_time = 1800
zlib.output_compression = On
    note note
    NOTE
    Adobe은 Adobe Commerce을 테스트할 때 메모리 제한을 2GB로 설정하는 것이 좋습니다. 자세한 내용은 필수 PHP 설정을 참조하세요.

  5. 세션 경로 디렉토리의 주석 처리를 제거하고 경로를 설정합니다.

    code language-conf 
    session.save_path = "/var/lib/php/session"

  6. 저장하고 편집기를 종료합니다.

  7. 편집기에서 /etc/php-fpm.d/www.conf 열기

  8. 다음 행과 일치하도록 파일을 편집합니다.

    code language-conf 
    user = nginx
group = nginx
listen = /run/php-fpm/php-fpm.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660

  9. 환경 라인의 주석 처리를 제거합니다.

    code language-conf 
    env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

  10. 저장하고 편집기를 종료합니다.

  11. PHP 세션 경로에 대한 디렉터리를 만들고 소유자를 nginx 사용자 및 그룹으로 변경합니다.

    code language-bash 
    mkdir -p /var/lib/php/session/
    code language-bash 
    chown -R nginx:nginx /var/lib/php/

  12. PHP-FPM 소켓에 대한 디렉터리를 만들고 소유자를 nginx 사용자 및 그룹으로 변경합니다.

    code language-bash 
    mkdir -p /run/php-fpm/
    code language-bash 
    chown -R nginx:nginx /run/php-fpm/

  13. php-fpm 서비스를 시작하고 부팅 시 시작되도록 구성하십시오.

    code language-bash 
    systemctl start php-fpm
    code language-bash 
    systemctl enable php-fpm

  14. php-fpm 서비스가 실행 중인지 확인합니다.

    code language-bash 
    netstat -pl | grep php-fpm.sock

MySQL 설치 및 구성

자세한 내용은 MySQL을 참조하세요.

Adobe Commerce 설치

다음과 같은 여러 가지 방법으로 Adobe Commerce을 다운로드할 수 있습니다.

이 예에서는 명령줄을 사용한 작성기 기반 설치를 보여 줍니다.

  1. 파일 시스템 소유자(으)로 응용 프로그램 서버에 로그인합니다.

  2. 웹 서버 docroot 디렉토리 또는 가상 호스트 docroot로 구성한 디렉토리로 변경합니다. 이 예제에서는 CentOS 기본값 /usr/share/nginx/html을(를) 사용합니다.

    code language-bash 
    cd /usr/share/nginx/html

  3. Composer를 전체적으로 설치합니다. Composer는 Adobe Commerce을 설치하기 전에 종속성을 업데이트해야 합니다.

    code language-bash 
    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer

  4. Adobe Commerce 메타패키지를 사용하여 작성기 프로젝트를 만듭니다.

    Magento Open Source

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

    Adobe Commerce

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

    메시지가 표시되면 인증 키를 입력하십시오. 공개 키​은(는) 사용자 이름이고 개인 키​은(는) 암호입니다.

  5. 응용 프로그램을 설치하기 전에 웹 서버 그룹에 대한 읽기/쓰기 권한을 설정합니다. 명령줄이 파일 시스템에 파일을 쓸 수 있도록 해야 합니다.

    code language-bash 
    cd /usr/share/nginx/html/<magento install directory>
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
    code language-bash 
    chown -R :nginx . # CentOS
    code language-bash 
    chmod u+x bin/magento

  6. 명령줄에서 설치합니다. 이 예제에서는 설치 디렉터리 이름이 magento2ee이고 데이터베이스 호스트가 동일한 컴퓨터(localhost)에 있다고 가정합니다.

    code language-bash 
    bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=<db-name> \
--db-user=<db-user> \
--db-password=<db-password> \
--backend-frontname=<backend-uri> \
--admin-firstname=<admin-first-name> \
--admin-lastname=<admin-last-name> \
--admin-email=<admin-email> \
--admin-user=<admin-user> \
--admin-password=<admin-password> \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1

  7. 개발자 모드로 전환:

    code language-bash 
    cd /usr/share/nginx/html/magento2/bin
    code language-bash 
    ./magento deploy:mode:set developer

Nginx 구성

설치 디렉터리의 nginx.conf.sample 파일과 Nginx 가상 호스트 구성을 사용하여 Nginx를 구성하는 것이 좋습니다.

IMPORTANT
nginx.conf.sample 파일은 필요한 응용 프로그램 라우팅과 보안 강화 규칙을 제공합니다. 예를 들어 서버에 업로드된 유해 스크립트의 실행을 제한합니다. 이 파일을 사용하지 않거나 해당 규칙을 수정하지 않는 경우 사용자 지정 nginx 구성에서 동일한 보안 컨트롤을 구현해야 합니다.

이러한 지침은 Nginx 가상 호스트(예: /etc/nginx/conf.d)에 대해 CentOS 기본 위치를 사용하고 있으며 기본 docroot(예: /usr/share/nginx/html)를 사용하고 있다고 가정합니다. 이러한 위치를 환경에 맞게 변경할 수 있습니다.

  1. 사이트에 대한 새 가상 호스트를 만듭니다.

    code language-bash 
    vim /etc/nginx/conf.d/magento.conf

  2. 다음 구성을 추가합니다.

    code language-conf 
    upstream fastcgi_backend {
  server  unix:/run/php-fpm/php-fpm.sock;
}

server {

  listen 80;
  server_name www.magento-dev.com;
  set $MAGE_ROOT /usr/share/nginx/html/magento2;
  include /usr/share/nginx/html/magento2/nginx.conf.sample;
}
    note note
    NOTE
    include 지시문은 설치 디렉터리의 샘플 nginx 구성 파일을 가리켜야 합니다.

  3. www.magento-dev.com을(를) 도메인 이름으로 바꾸십시오.

  4. 저장하고 편집기를 종료합니다.

  5. 구문이 올바른지 확인합니다.

    code language-bash 
    nginx -t

  6. Nginx 다시 시작:

    code language-bash 
    systemctl restart nginx

SELinux 및 firewalld 구성

SELinux는 CentOS 7에서 기본적으로 활성화됩니다. 다음 명령을 사용하여 실행 중인지 확인하십시오.

sestatus

SELinux 및 firewall을 구성하려면 다음을 수행합니다.

  1. SELinux 관리 도구를 설치합니다.

    code language-bash 
    yum -y install policycoreutils-python

  2. 다음 명령을 실행하여 설치 디렉토리의 보안 컨텍스트를 변경합니다.

    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/app/etc(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/var(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/pub/media(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/pub/static(/.*)?'
    code language-bash 
    restorecon -Rv '/usr/share/nginx/html/magento2/'

  3. Firewalld 패키지를 설치합니다.

    code language-bash 
    yum -y install firewalld

  4. 방화벽 서비스를 시작하고 부팅 시 시작되도록 구성합니다.

    code language-bash 
    systemctl start firewalld
    code language-bash 
    systemctl enable firewalld

  5. 웹 브라우저에서 기본 URL에 액세스할 수 있도록 다음 명령을 실행하여 HTTP 및 HTTPS용 포트를 엽니다.

    code language-bash 
    firewall-cmd --permanent --add-service=http
    code language-bash 
    firewall-cmd --permanent --add-service=https
    code language-bash 
    firewall-cmd --reload

설치 확인

설치를 확인하려면 웹 브라우저를 열고 사이트의 기본 URL로 이동합니다. 자세한 내용은 설치 확인을 참조하세요.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995