Repolode
ChuckerTeam

ChuckerTeam/chucker

앱 내부에서 실행되며 OkHttp 요청과 응답을 기록하는 Android용 온디바이스 HTTP 검사 도구로, Charles와 비슷합니다.

대체할 수 있는 제품:Charles Proxy

스타
4,587
포크
468
열린 이슈
83
마지막 커밋
15일 전

어떤 프로젝트인가요?

Chucker는 Android 앱에서 보내는 HTTP(S) 트래픽을 검사하는 라이브러리입니다. OkHttp 인터셉터로 연결되어 앱 내부에 각 요청과 응답을 저장하고, 내용을 탐색·검색·공유할 수 있는 앱 내 UI를 제공합니다. 기기에서 실행되므로 데스크톱 프록시를 설정할 필요가 없습니다.

기록이 활성화되면 앱에 진행 중인 HTTP 활동을 요약한 알림이 표시되고, 이를 탭하면 Chucker UI가 열립니다. 앱에서 알림을 숨기고 자체 화면에서 UI를 열 수도 있습니다. 보존 기간, 최대 본문 길이, 민감한 헤더 마스킹, alwaysReadResponseBody, Protobuf나 Thrift 같은 바이너리 형식용 커스텀 본문 디코더를 설정할 수 있습니다.

release variant는 no-op artifact로 제공되므로 프로덕션 빌드에 Chucker 코드가 포함되지 않습니다. 이 프로젝트는 Chuck의 포크이며, 저장된 데이터에 자격 증명과 본문이 포함될 수 있으므로 개발용으로 사용하는 것을 목적으로 합니다.

핵심 기능

  • 01OkHttp 요청과 응답을 가로채 앱 내부에 저장합니다.
  • 02본문 텍스트 검색과 하이라이트를 지원하는 앱 내 UI를 제공합니다.
  • 03HTTP 응답의 이미지를 표시합니다.
  • 04바이너리 형식용 커스텀 본문 디코더를 지원합니다.
  • 05민감한 헤더를 마스킹하고 저장되는 본문 길이를 제한합니다.
  • 06no-op release artifact를 제공해 릴리스 빌드에 Chucker 코드가 포함되지 않도록 합니다.

활용 사례

  • 개발 중 Android 앱이 보내는 API 호출을 디버깅합니다.
  • 프록시 없이 실제 기기에서 Retrofit 또는 OkHttp 트래픽을 검사합니다.
  • 버그 리포트를 위해 캡처한 요청과 응답 데이터를 팀원과 공유합니다.

빠른 시작

  1. 1

    Android 앱 모듈의 build.gradle에 debug 라이브러리 종속성을 추가하세요

    debugImplementation "com.github.chuckerteam.chucker:library:4.2.0"
  2. 2

    release 빌드용 no-op 라이브러리 종속성을 추가하세요

    releaseImplementation "com.github.chuckerteam.chucker:library-no-op:4.2.0"
  3. 3

    OkHttp 클라이언트 빌더에 ChuckerInterceptor를 추가하세요

사용 전 알아둘 점

  • 개발용으로만 사용하세요. 저장된 데이터에는 민감한 헤더와 본문이 포함될 수 있습니다.
  • OkHttp가 필요하며 Android API 21 이상이 필요합니다. 21 미만 버전은 지원되지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

chucker은(는) 무엇인가요?
앱 내부에서 실행되며 OkHttp 요청과 응답을 기록하는 Android용 온디바이스 HTTP 검사 도구로, Charles와 비슷합니다. Chucker는 Android 앱에서 보내는 HTTP(S) 트래픽을 검사하는 라이브러리입니다. OkHttp 인터셉터로 연결되어 앱 내부에 각 요청과 응답을 저장하고, 내용을 탐색·검색·공유할 수 있는 앱 내 UI를 제공합니다. 기기에서 실행되므로 데스크톱 프록시를 설정할 필요가 없습니다.
chucker은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
chucker은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
chucker은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. chucker의 마지막 커밋은 2026년 10월 22일입니다.
chucker은(는) 어디에 사용할 수 있나요?
개발 중 Android 앱이 보내는 API 호출을 디버깅합니다. 프록시 없이 실제 기기에서 Retrofit 또는 OkHttp 트래픽을 검사합니다. 버그 리포트를 위해 캡처한 요청과 응답 데이터를 팀원과 공유합니다.
chucker는 어떻게 설치하나요?
Android 앱 모듈의 build.gradle에 debug 라이브러리 종속성을 추가하세요: debugImplementation "com.github.chuckerteam.chucker:library:4.2.0" release 빌드용 no-op 라이브러리 종속성을 추가하세요: releaseImplementation "com.github.chuckerteam.chucker:library-no-op:4.2.0" OkHttp 클라이언트 빌더에 ChuckerInterceptor를 추가하세요
chucker은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ChuckerTeam/chucker

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트