도입 문의

Web Proxy

위커프 API를 이용하기 위해 WEB Proxy 방법을 안내합니다.

 

위커프 API를 이용하기 위해 WEB Proxy 방법을 안내합니다. Web에 업로드된 이미지를 위커프 CDN과 연결합니다.

 

연결에 필요한 정보

위커프가 이미지에 접근할 수 있도록 하기 위해 원본 이미지에 접근가능한 URL를 입력해야 합니다:

 

1. 웹 프록시의 이해

사용자는 위커프 CDN 주소로 이미지를 요청합니다.

  1. 위커프는 {alias}에 연결된 Target URL(원본 서버) 로 이미지를 요청합니다.

    예: https://raw.githubusercontent.com/weekerp/test-assets/main + /dog.jpg

  2. 원본 서버는 이미지 파일을 응답합니다.

    예: https://raw.githubusercontent.com/weekerp/test-assets/main/dog.jpg

  3. 위커프는 그 응답을 가공하여 사용자에게 전달하고 동시에 1년간 캐시합니다.

  4. 이후 동일한 요청은 캐시 응답으로 원본 요청없이 사용자에게 빠르게 전달됩니다.

<div class="callout callout-info">

WEB PROXY는 버킷/키 같은 클라우드 자격증명 없이 “이미 공개된 URL”만 있으면 연결됩니다.

</div>

원본 서버 접근에 자격 증명이 필요한 경우, Custom Headers로 인증 헤더(예: Authorization)를 추가해 요청할 수 있습니다.

Custom Headers는 현재 위커프 콘솔에서 직접 설정할 수는 없습니다. 다만 내부적으로는 기능이 준비되어 있으니, 필요하시면 (문의링크)로 문의해 주세요.

2. 연결 예시 (타겟 서버 : Github Repo)

  • Github Repository 에 이미지와 영상을 업로드 함
  • Github는 Url을 통해 해당 리소스에 접근할 수 있음

3. 저장소 정보

깃허브를 사용한 이미지 저장소는 다음과 같습니다.

https://raw.githubusercontent.com/weekerp/test-assets/main

GitHub - weekerp/test-assets: Sample images and assets for testing Weekerp Image Engine's Web Proxy and transformation logicSample images and assets for testing Weekerp Image Engine's Web Proxy and transformation logic - weekerp/test-assetshttps://github.com/weekerp/test-assets

4. 저장 파일 예시

하위에는 4개의 파일이 있습니다.

<figure><img src="/files/MoD4x1s5efLeJM1q6Vj7" alt=""><figcaption></figcaption></figure>

5. 공개된 이미지 정보

이미지는 다음과 같이 접속 가능한 상태여야 합니다.

raw.githubusercontent.comhttps://raw.githubusercontent.com/weekerp/test-assets/main/dog.jpg

6. 다음과 같은 정보가 준비되어 있어야 합니다.

  1. Target Url (Step #5)

7. 위커프 접속 후 우측 상단 Add Source 클릭

  1. 위커프 접속
  2. Source 탭 클릭 후
  3. Add Source 클릭

<figure><img src="/files/Z38M0CUr8nS7F6dDzMCc" alt=""><figcaption></figcaption></figure>

8. Static via WEB Proxy 선택

<figure><img src="/files/QoBJA9CEf4J3xOrnQ19I" alt=""><figcaption></figcaption></figure>

9. 연결 정보 입력

  1. Target Url 입력
  2. (필요시) Base Path 설정

<figure><img src="/files/V8Mo6D5zfG5d2eA7XcBp" alt=""><figcaption></figcaption></figure>

<div class="callout callout-info">

BasePath는 원본 요청의 루트 디렉터리를 설정합니다.

</div>

파일을 아래와 같이 보관하고 있는 경우 basePath는 / 혹은 /assets 으로 설정할 수 있습니다.

  • /dog.jpg
  • /assets/cat.png

요청 예시

  • cdn.weekerp.com/image/{alias}/dog.jpg

원본 요청

자세한 사안은 BasePath 설정을 참고해주세요.

10. 소스 별칭(alias) 입력

  1. 사용할 별칭 입력
  2. 별칭을 생성

<figure><img src="/files/vsxrSnONp3iud9PlVibp" alt=""><figcaption></figcaption></figure>

11. 생성된 데이터 소스 확인

<figure><img src="/files/LbCHGW83xSwFQG8OOQDd" alt=""><figcaption></figcaption></figure>

다음과 같이 사용하세요.

cdn.weekerp.com/<mark style="color:red;">image</mark>/weekerp-assets/dog.jpg

cdn.weekerp.com/<mark style="color:red;">image</mark>/weekerp-assets/dog.jpg?ai=Rotate the image to the right

cdn.weekerp.com/<mark style="color:red;">video</mark>/weekerp-assets/test-video.mp4

모든 설정을 완료했습니다.

일반적으로 모든 글로벌 환경에 연결을 전파하는데 까지는 5~10 분 소요됩니다.