Repolode
Swetrix

Swetrix/selfhosting

개인정보 보호 중심의 쿠키 없는 웹 분석 플랫폼 Swetrix Community Edition을 셀프 호스팅하기 위한 Docker Compose 설정입니다.

대체할 수 있는 제품:Google Analytics

스타
76
포크
27
열린 이슈
2
마지막 커밋
그저께

어떤 프로젝트인가요?

Swetrix는 개인정보를 수집하지 않고 트래픽, 사이트 속도, 사용자 세션, 페이지 이동 흐름을 추적하는 것을 목표로 하는 오픈 소스 기반의 쿠키 없는 Google Analytics 대안입니다. 추적 스크립트 크기는 5KB 미만입니다. 이 저장소에는 셀프 호스팅 Swetrix Community Edition 인스턴스를 실행하는 데 필요한 환경 파일을 생성하는 Docker Compose 파일과 configure.sh 스크립트가 포함되어 있습니다.

저장소를 클론하고 configure.sh를 실행해 BASE_URL 등의 값을 설정한 다음, docker compose up -d로 서비스를 시작하면 됩니다. 그러면 설정한 URL에서 웹 포털을 이용할 수 있습니다.

Community Edition은 세션 리플레이도 지원합니다. 세션을 녹화하고 재생하거나 MP4로 내보낼 수 있으며, 결과물은 AWS S3, MinIO, Cloudflare R2, Hetzner 등의 비공개 S3 호환 버킷에 저장됩니다. 리플레이 보관 기간, 내보내기 동시 실행 수, 내보낸 파일의 보존 기간은 환경 변수로 설정할 수 있습니다.

핵심 기능

  • 01대화형 configure.sh 스크립트로 .env 파일을 생성합니다.
  • 02docker compose 명령 하나로 Swetrix 전체 스택을 실행합니다.
  • 03쿠키를 사용하지 않고 트래픽, 사이트 속도, 세션, 페이지 이동 흐름을 추적합니다.
  • 04S3 호환 버킷에 세션 리플레이를 저장할 수 있습니다.
  • 05리플레이 보관 기간을 30일부터 최대 5년까지 설정할 수 있습니다.

활용 사례

  • Google Analytics 대신 자체 서버에서 개인정보 보호 친화적인 분석 서비스를 운영합니다.
  • 엄격한 데이터 보호 규정이 적용되는 사이트의 방문자 데이터를 직접 관리합니다.
  • 사용자 세션과 리플레이를 검토해 방문자가 웹사이트를 이용하는 방식을 파악합니다.

빠른 시작

  1. 1

    이 리포지토리를 클론합니다

    git clone https://github.com/swetrix/selfhosting
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd selfhosting
  3. 3

    configure 스크립트로 환경 설정을 생성합니다

    ./configure.sh
  4. 4

    Docker Compose로 Swetrix 서비스를 시작합니다

    docker compose up -d

사용 전 알아둘 점

  • 실행하려면 Docker와 여러 서비스로 구성된 Docker Compose 스택이 필요합니다.
  • 세션 리플레이를 저장하려면 별도의 S3 호환 버킷이 필요하지만, 이는 선택 사항입니다.
  • 리포지토리에 라이선스가 명시되어 있지 않아 사용 권한이 불분명합니다.

포함된 컬렉션

토픽

자주 묻는 질문

selfhosting은(는) 무엇인가요?
개인정보 보호 중심의 쿠키 없는 웹 분석 플랫폼 Swetrix Community Edition을 셀프 호스팅하기 위한 Docker Compose 설정입니다. Swetrix는 개인정보를 수집하지 않고 트래픽, 사이트 속도, 사용자 세션, 페이지 이동 흐름을 추적하는 것을 목표로 하는 오픈 소스 기반의 쿠키 없는 Google Analytics 대안입니다. 추적 스크립트 크기는 5KB 미만입니다. 이 저장소에는 셀프 호스팅 Swetrix Community Edition 인스턴스를 실행하는 데 필요한 환경 파일을 생성하는 Docker Compose 파일과 configure.sh 스크립트가 포함되어 있습니다.
selfhosting은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
selfhosting에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
selfhosting은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. selfhosting의 마지막 커밋은 2026년 11월 6일입니다.
selfhosting은(는) 어디에 사용할 수 있나요?
Google Analytics 대신 자체 서버에서 개인정보 보호 친화적인 분석 서비스를 운영합니다. 엄격한 데이터 보호 규정이 적용되는 사이트의 방문자 데이터를 직접 관리합니다. 사용자 세션과 리플레이를 검토해 방문자가 웹사이트를 이용하는 방식을 파악합니다.
selfhosting는 어떻게 설치하나요?
이 리포지토리를 클론합니다: git clone https://github.com/swetrix/selfhosting 프로젝트 디렉터리로 이동합니다: cd selfhosting configure 스크립트로 환경 설정을 생성합니다: ./configure.sh Docker Compose로 Swetrix 서비스를 시작합니다: docker compose up -d
selfhosting은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Swetrix/selfhosting

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

관련 프로젝트