imgproxy
이미지를 실시간으로 조정, 처리 및 변환하기 위한 빠르고 안전한 독립형 서버입니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
빠르고 안전한 이미지 처리 프록시 서버, Docker 원클릭 배포.
주요 기능
- 실시간 크기 조정, 자르기, 회전, 워터마크 추가, 필터 적용
- JPEG / PNG / WebP / AVIF / JPEG XL 등 다양한 형식 지원
- libvips 기반 초고속 처리, 극히 낮은 메모리 사용량
- URL 서명, 타입 검사, 크기 제한 등의 보안 보호
- Docker로 몇 초 만에 실행 가능, 매우 간단한 설정
할 수 없는 것
- •imgproxy 자체는 HTTPS를 처리하지 않으므로 프로덕션 환경에서는 Nginx, CDN 또는 로드 밸런서 뒤에 배치하는 것이 좋습니다. 대량의 동시 요청을 처리할 때는 메모리와 연결 수를 적절히 구성해야 하며, 기본 구성은 고동시성 시나리오에 충분하지 않을 수 있습니다. Pro 버전의 많은 고급 기능(비디오 미리보기, 객체 감지 등)은 유료 구독이 필요합니다. 서명 키는 안전하게 보관하세요. 유출되면 다른 사람이 당신의 처리 서버를 악용할 수 있습니다.
사용 사례
- 이커머스 웹사이트의 상품 이미지 실시간 크롭 및 최적화
- 소셜 플랫폼에서 다양한 크기의 아바타 및 썸네일 자동 생성
- CMS에서 클라이언트에 맞게 이미지 품질과 형식을 동적으로 조정
- ImageMagick / GraphicsMagick 등의 커맨드라인 도구 대체
상세 설명
imgproxy는 고성능 이미지 처리 서버로, 이미지의 크기 조정, 자르기, 회전, 필터 적용 및 형식 변환을 실시간으로 수행할 수 있습니다. 애플리케이션과 이미지 소스 사이에서 프록시 역할을 하며, 모든 이미지 처리 작업을 이 전용 서비스에서 처리합니다. libvips 라이브러리를 기반으로 하여 처리 속도가 매우 빠르고 메모리 사용량이 적습니다. JPEG, PNG, WebP, AVIF, JPEG XL 등 다양한 입출력 형식을 지원합니다. URL 서명, 이미지 유형 검증, 크기 검사 및 소스 제한을 포함한 강력한 보안 메커니즘이 내장되어 있어 오용을 방지합니다. Docker를 통해 수십 초 만에 시작하고 실행할 수 있으며, 웹 애플리케이션의 복잡한 이미지 처리 코드를 대체하는 이상적인 선택입니다. 프로젝트는 또한 비디오 미리보기, 객체 감지, SSIM 기반 자동 품질 등의 고급 기능을 포함한 Pro 버전을 제공합니다.
문제 해결 & FAQ (2)
문제 해결최신 버전으로 업그레이드한 후 imgproxy Docker 컨테이너에서 메모리 누수를 해결하는 방법?
최신 imgproxy Docker 이미지(sha256:77069360a... 포함)에 메모리 누수가 존재하여 메모리 사용량이 16GB를 초과하여 급증합니다. 해결 방안으로 버전 3.30.1(예: 이미지 태그 imgproxy/imgproxy:3.30.1)로 되돌리십시오. 영구적인 수정 사항이 나올 때까지 이 이슈를 모니터링하십시오.
문제 해결왜 phixiv가 Pixiv ugoira 링크에서 'Broken or unsupported video' 오류를 표시하나요?
이것은 phixiv의 ugoira(Pixiv 애니메이션 아트워크) MP4 변환 처리에서 발생한 알려진 서버 측 버그였으며, phixiv issue #23에서 추적된 수정을 통해 메인테이너에 의해 해결되었습니다. 클라이언트 측 조치는 필요하지 않습니다: URL을 다시 요청하거나 링크를 다시 게시하여(예: Discord에서) 임베드를 다시 생성하세요. 오류가 지속되면 프록시된 비디오가 캐시되어 있을 수 있습니다—캐시가 만료될 때까지 기다렸다가 다시 시도하거나, 아트워크 ID(예: /i/ugoira/<id>.mp4)와 함께 phixiv GitHub repo에 새 이슈를 여세요.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
1단계: Docker가 설치되어 있는지 확인
2단계: docker run -p 8080:8080 -it ghcr.io/imgproxy/imgproxy:latest 실행
3단계: http://localhost:8080에 접속하면 이미지 처리를 시작할 수 있습니다
- 1단계: Docker가 설치되어 있는지 확인
- 2단계: docker run -p 8080:8080 -it ghcr.io/imgproxy/imgproxy:latest 실행
- 3단계: http://localhost:8080에 접속하면 이미지 처리를 시작할 수 있습니다
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Docker를 통해 실행하는 경우 컨테이너를 중지하고 이미지를 삭제하기만 하면 됩니다: docker stop <컨테이너 이름> && docker rm <컨테이너 이름> && docker rmi ghcr.io/imgproxy/imgproxy:latest. 소스 코드에서 컴파일한 경우 컴파일 디렉터리 및 관련 서비스 파일을 삭제하세요.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs
유사한 프로젝트
Visual Studio Code (Code - OSS)
Microsoft가 만든 무료 오픈 소스 코드 편집기로, 지능형 자동 완성, 디버깅, Git 및 확장 기능을 지원하는 전 세계에서 가장 인기 있는 편집기입니다.
opencode
오픈소스 AI 코딩 에이전트로, 코드 작성, 리팩토링 및 분석을 지원하며, '빌드(Build)'와 '플랜(Plan)' 이중 에이전트 모드가 내장되어 있습니다.
scrcpy
USB 또는 무선 TCP/IP를 통해 컴퓨터에서 Android 기기로 화면 미러링 및 제어를 지원하며, 루팅 불필요, 고성능 저지연, 오디오 전달 지원.