본문으로 건너뛰기
버전: 4.6.1-saas

초기화 설정

이 문서는 NetFUNNEL Cloudflare Agent에서 사용할 수 있는 환경 변수 설정 및 부가 기능을 설명합니다.

환경 변수​

환경 변수는 Cloudflare Worker 설정에서 설정하는 변수로, NetFUNNEL 에이전트의 동작을 제어합니다.

필수 설정​

CLIENT_ID​

NetFUNNEL 콘솔에서 발급받은 클라이언트 ID를 입력합니다.

유형이름값설명
텍스트CLIENT_ID{{CLIENT_ID}}NetFUNNEL 콘솔에서 확인한 Client ID

설정 방법:

  1. [Workers 및 Pages]에서 Worker 선택
  2. [설정] 탭 클릭
  3. 변수 및 암호에서 [+추가] 클릭
  4. 유형: 텍스트 선택
  5. 이름: CLIENT_ID
  6. 값: NetFUNNEL 콘솔의 Client ID 입력
  7. [배포] 클릭

부가 기능​

Good Bot 예외 처리​

Worker 설정을 통해 특정 User-Agent 값이 포함되어 있을 경우 에이전트 동작으로부터 예외 처리할 수 있습니다.

환경 변수 설정​

유형이름값설명
텍스트GOOD_BOTSGooglebot, Bingbot, Slurp, Applebot, facebookexternalhit예외 처리할 봇의 User-Agent 목록 (쉼표로 구분)

예시: Google, Microsoft, Yahoo, Apple, Facebook 봇을 예외 처리한 예시입니다.

설정 방법:

  1. [Workers 및 Pages]에서 에이전트가 적용된 Worker 선택
  2. [설정] 탭 클릭
  3. 변수 및 암호에서 [+추가] 클릭
  4. 유형: 텍스트 선택
  5. 이름: GOOD_BOTS
  6. 값: 예외하고 싶은 굿 봇의 User-Agent를 쉼표로 구분하여 입력
  7. [배포] 클릭

진입 키 자동 반납 처리​

NetFUNNEL Cloudflare 에이전트는 진입 후 넷퍼넬 키를 자동으로 반납하여 다음 대기자가 진입할 수 있도록 처리하고 있습니다. 만약, 넷퍼넬 키를 바로 반납하지 않고 세그먼트에서 설정한 타임아웃 시간에 넷퍼넬 키를 반납하고 싶은 경우에 사용할 수 있는 기능입니다.

환경 변수 설정​

유형이름값설명
텍스트RETURN_KEYtrue 또는 false진입 키 자동 반납 여부
  • true (기본값): 대기 완료 후 진입 시 에이전트에서 넷퍼넬 키를 자동으로 반납합니다.
  • false: 세그먼트에서 설정한 타임아웃 시간에 키가 반납 처리됩니다.

설정 방법:

  1. [Workers 및 Pages]에서 에이전트가 적용된 Worker 선택
  2. [설정] 탭 클릭
  3. 변수 및 암호에서 [+추가] 클릭
  4. 유형: 텍스트 선택
  5. 이름: RETURN_KEY
  6. 값: true 또는 false 입력
  7. [배포] 클릭

대기실 도메인 변경​

NetFUNNEL 대기실 페이지의 도메인은 agent-lib.stclab.com입니다. 해당 도메인을 서비스 중인 도메인에 맞게 변경하려면 NetFUNNEL 서비스팀을 통해 원하는 도메인을 알려주시고, Worker 설정을 변경해야 합니다.

환경 변수 설정​

유형이름값설명
텍스트VWR_PAGE_DOMAINhttp(s)://{CNAME_DOMAIN}대기실 도메인 URL

예시: https://wait.stclab.com

설정 방법:

  1. [Workers 및 Pages]에서 에이전트가 적용된 Worker 선택
  2. [설정] 탭 클릭
  3. 변수 및 암호에서 [+추가] 클릭
  4. 유형: 텍스트 선택
  5. 이름: VWR_PAGE_DOMAIN
  6. 값: 변경하고자 하는 대기실 도메인 URL 입력 (예: https://wait.stclab.com)
  7. [배포] 클릭

쿠키 도메인 설정​

NetFUNNEL 서버에서 발급한 키를 쿠키에 저장할 때 현재 페이지의 도메인을 기준으로 저장합니다. 만약 서로 다른 서브도메인 간에 키를 공유해야할 경우 메인 도메인이 쿠키에 저장되도록 설정합니다.

예: develop.stclab.com과 staging.stclab.com과 같이 서브도메인이 서로 다른 페이지에서 쿠키를 공유하도록 .stclab.com으로 설정합니다.

환경 변수 설정​

유형이름값설명
텍스트COOKIE_DOMAIN.{MAIN_DOMAIN}쿠키 도메인

예시: .stclab.com

설정 방법:

  1. [Workers 및 Pages]에서 에이전트가 적용된 Worker 선택
  2. [설정] 탭 클릭
  3. 변수 및 암호에서 [+추가] 클릭
  4. 유형: 텍스트 선택
  5. 이름: COOKIE_DOMAIN
  6. 값: 메인 도메인 형식으로 입력 (예: .stclab.com)
  7. [배포] 클릭

Worker 배포​

환경 변수를 변경한 후에는 반드시 Worker를 배포해야 변경 사항이 적용됩니다.

  1. 환경 변수 설정 완료 후 [배포] 버튼 클릭
  2. 배포 완료 후 변경 사항 적용

관련 문서​