설명서

AEM as a Cloud Service에서 클라이언트 도메인 라우팅 문제 해결

Last update: Sat Sep 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Dispatcher 팜이 잘못 구성되면 Adobe Experience Manager as a Cloud Service(AEMaaCS)의 클라이언트 도메인 라우팅이 실패하여 잘못된 팜으로 기본 설정됩니다. 이 문제를 해결하려면 Dispatcher 설정을 확인하고 가상 호스트 별칭을 업데이트하고, 팜 파일의 이름을 변경하여 순서를 수정하고, 클라이언트 헤더를 검토하고, 올바른 도메인 매핑에 대한 CDN 설정을 확인하십시오.

설명 description

환경

Adobe Experience Manager as a Cloud Service(AEMaaCS) - 도메인 인증서 및 여러 사용자 정의 도메인과 함께 Akamai CDN을 사용하는 사이트, 프로덕션 환경.

문제/증상

  • Dispatcher 로그에 다음과 같은 경고가 표시됩니다. 팜 일치 항목 없음 호스트 'localhost', 마지막 팜 'publishfarm'.
  • Dispatcher 구성은 활성화된 팜의 우선순위를 알파벳 역순으로 표시합니다.
  • enabled_vhosts 및 enabled_farms 디렉터리에 있는 파일에 대한 심볼릭 링크가 없습니다.
  • 가상 호스트 구성에 localhost, 127.0.0.1과(와) 같은 특정 필수 서버 별칭이 없습니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. Dispatcher 구성 유효성 검사:

    • Dispatcher 유효성 검사 도구를 로컬에서 사용하여 현재 구성에 있는 모든 오류 또는 경고를 식별합니다.
    • enabled_vhosts 및 enabled_farms 디렉터리에 있는 모든 파일이 심볼릭 링크인지 확인하십시오.

  2. 가상 호스트 구성 업데이트: 가상 호스트 항목에 필요한 모든 서버 별칭이 포함되어 있는지 확인합니다. ServerAlias "*example.com" "*.local" "localhost" "127.0.0.1" "*.adobeaemcloud.net" "*.adobeaemcloud.com"

  3. 활성화된 팜 이름 바꾸기: 활성화된 팜 파일 이름에서 숫자 접두사(예: 00_, 01_)를 제거합니다. 이렇게 하면 팜을 선택하는 동안 알파벳 역순 순서 문제가 발생할 수 있습니다.

  4. 디버그 로깅 사용: 추가 분석을 위해 Dispatcher 로그를 디버그 모드로 설정하고 팜 선택 또는 오류 발생과 관련된 로그 조각을 캡처합니다.

  5. 클라이언트 헤더 규칙 검토: 클라이언트 헤더 규칙 검사(예: clientheaders.any 및 default_clientheaders.any)에서 'localhost'과(와) 같이 하드코딩된 자리 표시자 값을 확인합니다. 받는 요청에 적절한 매핑으로 바꿉니다.

  6. 로컬에서 변경 내용 테스트: 프로덕션에 변경 내용을 적용하기 전에 로컬 Dispatcher 인스턴스에 업데이트된 구성을 배포하고 기능을 확인합니다.

  7. 업데이트된 구성 배포: 유효성이 확인되면 파이프라인 도구를 사용하여 업데이트된 Dispatcher 구성을 배포합니다.

  8. CDN 설정 확인:

    • CDN이 고객 도메인 이름을 사용하도록 올바르게 구성되어 있는지 확인합니다.
    • X-Forwarded-Host 헤더가 적절하게 설정되어 있고 'localhost'과(와) 같은 자리 표시자 값을 포함하지 않는지 확인하십시오.

  9. 도메인 라우팅 다시 테스트: 배포 후 각 사용자 지정 도메인을 테스트하여 요청이 해당 팜에 올바르게 라우팅되는지 확인하십시오.

  10. 배포 후 로그 모니터링: 배포 후 Dispatcher 로그를 계속 모니터링하여 이상 현상이나 되풀이되는 문제를 식별합니다.

관련 레독스

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f