설치 및 초기화
이 가이드는 NetFUNNEL Cloudflare 에이전트의 설치 및 초기화 과정을 설명합니다.
1단계: Worker 환경 설정
Cloudflare의 공식 문서를 참고하여 Cloudflare Worker의 환경을 설정하는 것이 가장 우선입니다.
Cloudflare의 공식 문서 상 Worker 프로젝트를 설정하는 내용을 확인 후 안내에 따라 Worker 환경을 설정합니다.
2단계: Client ID 가져오기
- NetFUNNEL 콘솔로 이동
- 우측 상단의 프로필 아이콘 클릭
통합 자격 증명(Integration Credentials) 메뉴 선택Client ID복사
Client ID 확인 위치
콘솔 화면 우측 상단의 프로필 아이콘을 클릭한 후, 통합 자격 증명 메뉴에서 확인할 수 있습니다.
3단계: Worker 생성
- Cloudflare 콘솔 → [Workers 및 Pages] 메뉴 클릭
- Workers [생성] 클릭
- [Hello world] 클릭
- 배포하여 추가
4단계: Worker에 에이전트 적용
- 우측 상단의 [코드 편집] 클릭
- https://agent-lib.stclab.com/agents/cdn/cloudflare/netfunnel-cloudflare-agent-latest.js 에서
netfunnel-cloudflare-agent.js파일 다운로드 - 코드 편집기의 왼쪽 탭에서 [Explore] 클릭하여 파일 목록이 보이도록 설정
netfunnel-cloudflare-agent.js파일 업로드worker.js파일 열고 아래 코드 작성:
import handleEvent from './netfunnel-cloudflare-agent.js'
export default {
async fetch(request, env, ctx) {
return await handleEvent(request, env, ctx);
},
};
- 우측 상단의 [배포] 버튼 클릭하여 Worker 배포
5단계: Worker 설정
도메인 및 경로 설정
- 생성한 Worker 선택
- [설정] 메뉴 클릭
- 도메인 및 경로에서 [+추가] 클릭
- [경로] 클릭
- [영역]에서 도메인 선택
- [경로]에 Worker가 실행될 경로 입력 (끝에
/*추가하여 하위 페이지에서도 Worker 동작) - [실패 시 열림(진행)] 선택
- [경로 추가] 클릭
환경 변수 설정
아래 표를 참고하여 변수 및 암호에 환경 변수를 추가합니다.
| 유형 | 이름 | 값 |
|---|---|---|
| 텍스트 | CLIENT_ID | {{CLIENT_ID}} |
CLIENT_ID는 NetFUNNEL 콘솔에서 확인하세요.
변수를 추가한 후 [배포]를 클릭합니다.
6단계: 도메인 설정
- Cloudflare DNS 설정으로 이동
- 5단계에서 설정한 도메인을 CNAME으로 설정
- 반드시 Proxy 타입으로 설정해야 합니다 (주황색 구름 아이콘)
이 설정을 통해 해당 경로로 요청이 들어왔을 때 Worker가 실행될 수 있도록 합니다.