Apache HTTP 서버

마지막 업데이트: 2026년 8월 7일

주제:
{"id":"d1956731-2adb-4bb7-8301-2b239254ac72"}

이 구성은 Apache HTTP 서버가 원본(AEM Dispatcher 없이 자체 호스팅 설정) 앞에서 역방향 프록시 역할을 하는 경우에 적용됩니다. 이 구성은 에이전틱 트래픽(AI 봇 및 LLM 사용자 에이전트의 요청)을 Edge Optimize 백엔드 서비스(live.edgeoptimize.net)로 라우팅합니다. 사람 방문자와 SEO 봇은 기존과 동일하게 사용자의 원본 서버에서 계속 제공됩니다. 구성을 테스트하려면 설정이 완료된 후 응답에서 헤더 x-edgeoptimize-request-id를 찾습니다.

통합은 기본 Apache Include 파일 세트로, 배포할 코드나 작업자가 없습니다. 3개의 파일을 다운로드하고 API 키를 설정한 다음 가상 호스트에 2의 Include 줄을 추가합니다.

사전 요구 사항

Apache 라우팅 규칙을 설정하기 전에 다음을 확인하십시오.

proxy, proxy_http, ssl, rewrite, headers, env 및 setenvif 모듈이 활성화된 Apache HTTP 서버 2.4 이상
Apache 구성(사이트의 <VirtualHost>)에 액세스하고 Apache를 다시 로드하는 기능입니다.
Adobe Brand Visibility UI에서 검색한 Edge Optimize API 키. 단계는 API 키 검색을 참조하십시오.
(선택 사항) 스테이징 라우팅을 테스트하려면 스테이징 API 키를 참조하십시오.

구성

1. 구성 파일 다운로드

3개의 Edge Optimize 포함 파일을 Optimize at Edge 코드 샘플 저장소에서 다운로드하고 Apache 서버의 디렉터리(예: conf/oae/)에 배치합니다.

파일

목적

oae-routing.conf

AI 봇을 감지하고, Edge Optimize 헤더를 삽입하고, HTML 페이지 요청을 백엔드로 라우팅하며, 캐시 격리 및 장애 조치를 설정합니다.

oae-failover.conf

Edge Optimize가 오류를 반환하는 경우 사용자 원본에 대한 원래 요청을 재생합니다.

domains.conf

도메인마다 Optimize at Edge를 활성화하고 API 키를 보유합니다.

oae-routing.conf 또는 oae-failover.conf를 수정할 필요가 없습니다. 그대로 사용하십시오.

2. 도메인 활성화 및 API 키(domains.conf) 설정

domains.conf를 편집하고 사용 설정 중인 도메인마다 한 줄을 추가합니다. 호스트를 도메인으로 바꾸고 YOUR_API_KEY을(를) Adobe Brand Visibility UI의 키로 바꿉니다. 목록에 없는 도메인은 변경 없이 원본으로 라우팅되므로 한 번에 하나의 도메인을 활성화할 수 있습니다.

SetEnvIfExpr "%{HTTP_HOST} =~ m#(?i)^(www\.)?example\.com(:\d+)?$#" OAE_DOMAIN_ENABLED=1 OAE_API_KEY=YOUR_API_KEY

3. 가상 호스트에 파일 포함

기존 <VirtualHost *:443>에 두 개의 Include 줄을 추가합니다. 라우팅 파일은 재작성 및 ProxyPass 규칙 앞에 있으며, 장애 조치 파일은 뒤에 있습니다. 아래 예제에서 #NEWLINE이라고 표시된 줄은 Optimize at Edge에 추가하는 유일한 줄입니다. 그 외 모든 항목(ServerName, ProxyPass, 나머지)은 변경되지 않은 기존 구성입니다.

Define OAE_CONF_DIR conf/oae                       #NEWLINE  directory holding the OAE include files

<VirtualHost *:443>
    ServerName www.example.com

    Include "${OAE_CONF_DIR}/oae-routing.conf"     #NEWLINE  OAE routing — BEFORE your Rewrite & ProxyPass rules

    # --- your existing rewrite rules and ProxyPass to origin ---
    ProxyPass        "/" "https://www.example.com/"
    ProxyPassReverse "/" "https://www.example.com/"

    Include "${OAE_CONF_DIR}/oae-failover.conf"    #NEWLINE  OAE failover — AFTER your ProxyPass rules
</VirtualHost>

4. Apache 다시 로드

구성을 확인하고 Apache를 다시 로드하여 변경 사항을 적용합니다.

NOTE

봇에 최적화된 응답과 사람의 응답은 자동으로 별도의 캐시 항목에 보관됩니다(라우팅 파일은 Vary: x-edgeoptimize-config를 설정합니다). Apache에서 이미 mod_cache를 사용하는 경우, Edge Optimize 헤더가 설정된 후에 캐시 조회가 실행되도록 CacheQuickHandler Off가 있는지 확인하십시오.

방화벽 규칙을 통해 Optimize at Edge 허용(선택 사항)

CDN에서 WAF 또는 보트 관리자를 사용하는 경우:

Edge 서비스에서 최적화 서비스를 통해 원본 콘텐츠를 가져올 수 있도록 WAF 또는 봇 관리자에서 *AdobeEdgeOptimize/1.0* 사용자 에이전트를 최적화합니다.
방화벽에 사용자 에이전트 이외의 추가 확인이 필요한 경우 암호를 생성하고(예: openssl rand -hex 32):
- 다른 x-edgeoptimize-* 헤더와 함께 라우팅 규칙에 암호가 포함된 x-edgeoptimize-fetcher-key을(를) 추가합니다.
- x-edgeoptimize-fetcher-key이(가) 같은 암호와 일치하는 요청을 허용하도록 WAF 또는 보트 관리자 규칙을 추가합니다.
Edge에서 최적화 는 이 헤더를 있는 그대로 전달합니다. — 전체 키 라이프사이클을 소유합니다.

설정 확인

설정을 완료한 후 봇 트래픽이 Edge Optimize로 라우팅되고 있으며 사람 트래픽이 영향을 받지 않는지 확인합니다.

1. 봇 트래픽 테스트(최적화해야 함)

에이전틱 사용자 에이전트를 사용하여 AI 봇 요청을 시뮬레이션합니다.

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

성공적인 응답에는 요청이 Edge Optimize를 통해 라우팅되었음을 확인하는 x-edgeoptimize-request-id 헤더가 포함됩니다.

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. 사람 트래픽 테스트(영향을 받지 않아야 함)

일반 사람 브라우저 요청을 시뮬레이션합니다.

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

응답에는 x-edgeoptimize-request-id 헤더가 없어야 합니다. 페이지 콘텐츠와 응답 시간은 Optimize at Edge를 활성화하기 전과 동일하게 유지되어야 합니다.

3. 두 시나리오를 구분하는 방법

헤더

봇 트래픽(최적화됨)

사람 트래픽(영향을 받지 않음)

x-edgeoptimize-request-id

있음 - 고유한 요청 ID가 포함되어 있습니다.

없음

x-edgeoptimize-fo

장애 조치가 발생한 경우에만 표시됩니다(값: 1).

없음

Adobe Brand Visibility UI에서 트래픽 라우팅 상태를 확인할 수도 있습니다. 고객 구성(으)로 이동하고 CDN 구성 탭을 선택합니다.

AI 에이전트에 최적화 배포 — 완료됨

사용 가능한 기회, 자동 최적화 워크플로 및 FAQ를 포함하여 Edge에서 최적화에 대해 자세히 알아보려면 Edge에서 최적화 개요로 돌아가십시오.

recommendation-more-help

brand-visibility-help-main-toc