이미지 프록시 & 변환기

외부 이미지 URL을 프록시하고 실시간으로 변환하세요

변환 옵션
리사이즈 모드에서
원본 비율 유지
이미지 URL 입력
외부 이미지 URL을 입력하세요 (HTTP/HTTPS만 지원)

프록시 URL 사용 방법

생성된 프록시 URL은 어디서든 사용할 수 있습니다:

1. HTML에서 직접 사용
<img src="프록시_URL" alt="이미지">
2. 사용 가능한 파라미터
파라미터 설명 필수 예시
url 원본 이미지 URL (HTTP/HTTPS만 지원) 필수 url=https://example.com/image.jpg
width 이미지 너비 (px, 1-10000) 선택 width=500
height 이미지 높이 (px, 1-10000) 선택 height=300
mode 변환 모드: resize, square, crop, pad 선택 mode=square
bg 배경색 (패딩 모드용, HEX 색상) 선택 bg=%23FFFFFF (URL 인코딩된 #FFFFFF)
maintainAspectRatio 비율 유지 여부 (리사이즈 모드용, true/false) 선택 maintainAspectRatio=false
3. 변환 모드별 사용 예시
리사이즈 (resize) 모드
  • ?url=원본URL&width=500&mode=resize - 너비 500px로 리사이즈 (비율 유지)
  • ?url=원본URL&width=500&height=300&mode=resize - 500x300 내에 맞춰 리사이즈 (비율 유지)
  • ?url=원본URL&width=500&height=300&mode=resize&maintainAspectRatio=false - 정확히 500x300으로 리사이즈 (비율 무시)
  • ?url=원본URL&width=250&mode=resize - 넓이만 입력 시 250x250 정사각형으로 변환
정사각형 (square) 모드
  • ?url=원본URL&width=300&mode=square - 300x300 정사각형으로 변환 (중앙 크롭)
  • ?url=원본URL&width=500&height=300&mode=square - 넓이와 높이 모두 입력 시 큰 값(500)으로 정사각형 생성
  • ?url=원본URL&mode=square - 넓이/높이 없으면 원본 크기 기준으로 정사각형 생성
크롭 (crop) 모드
  • ?url=원본URL&width=800&height=600&mode=crop - 800x600으로 중앙 크롭
  • ?url=원본URL&width=250&mode=crop - 넓이만 입력 시 250x250 정사각형으로 크롭
  • ?url=원본URL&mode=crop - 넓이/높이 없으면 원본 크기로 크롭
패딩 (pad) 모드
  • ?url=원본URL&width=500&height=500&mode=pad - 500x500 패딩 (기본 배경색: 흰색)
  • ?url=원본URL&width=500&height=500&mode=pad&bg=%23FF0000 - 500x500 패딩 (빨간 배경, #FF0000)
  • ?url=원본URL&width=250&mode=pad - 넓이만 입력 시 250x250 정사각형으로 패딩
4. 변환 모드 상세 설명
  • 리사이즈 (resize): 비율을 유지하면서 크기 조정
    • 넓이/높이 중 하나만 입력: 해당 값으로 정사각형 생성 (비율 무시)
    • 넓이/높이 모두 입력 + 비율 유지: 지정 크기 내에 맞춰 비율 유지
    • 넓이/높이 모두 입력 + 비율 무시: 정확히 지정 크기로 변환 (왜곡 가능)
  • 정사각형 (square): 이미지를 정사각형으로 변환 (중앙 크롭)
    • 넓이만 입력: 해당 값으로 정사각형 생성
    • 넓이/높이 모두 입력: 큰 값으로 정사각형 생성
    • 입력 없음: 원본 크기 기준으로 정사각형 생성
  • 크롭 (crop): 지정한 크기로 중앙 부분만 자르기
    • 넓이/높이 모두 입력: 지정 크기로 중앙 크롭
    • 넓이만 입력: 해당 값으로 정사각형 크롭
    • 입력 없음: 원본 크기로 크롭
  • 패딩 (pad): 지정한 크기로 패딩 추가 (배경색 지정 가능)
    • 넓이/높이 모두 입력: 지정 크기로 패딩 추가
    • 넓이만 입력: 해당 값으로 정사각형 패딩
    • 입력 없음: 원본 크기로 패딩
    • 배경색: bg 파라미터로 HEX 색상 지정 (URL 인코딩 필요)
5. URL 인코딩 주의사항
중요: URL에 특수문자가 포함된 경우 반드시 인코딩해야 합니다.
  • 원본 URL 인코딩: https://example.com/image.jpg → https%3A%2F%2Fexample.com%2Fimage.jpg
  • 색상 코드 인코딩: #FF0000 → %23FF0000 (# 기호는 %23으로 인코딩)
  • 예시: 
    ?url=https%3A%2F%2Fexample.com%2Fimage.jpg&width=500&mode=pad&bg=%23FF0000
캐싱 동작 방식:
  • 프록시 URL은 원본 URL + 옵션 조합으로 캐시됩니다.
  • 옵션(너비, 높이, 모드, 배경색)이 달라지면 별도의 캐시가 생성됩니다.
  • 동일한 URL과 옵션 조합은 캐시된 이미지를 즉시 반환합니다.
  • 예: width=500과 width=800은 서로 다른 캐시로 저장됩니다.