benvinegar/counterscale

어떤 프로젝트인가요?

핵심 기능

• 01스크립트 태그, 브라우저용 npm 모듈 또는 서버 측 모듈로 페이지뷰를 추적합니다.
• 02Cloudflare Workers에서 실행되며, 배포용 CLI 설치 프로그램을 제공합니다.
• 03분석 대시보드에 선택적으로 비밀번호를 설정할 수 있습니다.
• 0490일 보관 기간이 지난 뒤에도 장기 데이터를 R2에 Apache Arrow 파일로 저장합니다.
• 05서버 모듈에서 수동 페이지뷰 추적과 UTM 매개변수를 지원합니다.
• 06기존 데이터를 잃지 않고 설치 프로그램을 다시 실행해 업그레이드할 수 있습니다.

활용 사례

• 개인 블로그나 프로젝트 사이트에 개인정보 보호에 중점을 둔 셀프 호스팅 트래픽 통계를 추가할 때.
• 브라우저 스크립트를 사용하지 않는 백엔드 애플리케이션에서 페이지뷰를 추적할 때.
• Cloudflare 계정에서 여러 웹사이트의 저비용 분석을 운영할 때.

빠른 시작

1. 1

   Cloudflare에 로그인하고 Wrangler를 인증합니다

   npx wrangler login
2. 2

   Counterscale 설치 프로그램을 실행하고 안내에 따릅니다

   npx @counterscale/cli@latest install
3. 3

   추적 스크립트 스니펫을 웹사이트 HTML에 추가합니다

사용 전 알아둘 점

• !README 요구 사항에 따라 Cloudflare 계정이 필요하며 macOS 또는 Linux에서만 실행됩니다.
• !Workers Analytics Engine은 데이터를 최대 90일 동안 보관하므로 대시보드에는 최근 90일 데이터만 표시됩니다(장기 R2 저장소를 사용할 수 있습니다).
• !로컬 개발용 테스트 데이터베이스가 없습니다. 쓰기는 아무 작업도 수행하지 않으며, 읽기에는 프로덕션 데이터가 표시됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

counterscale은(는) 무엇인가요?

Cloudflare Workers와 Workers Analytics Engine에서 실행하는 셀프 호스팅 웹 분석 트래커 및 대시보드입니다. Counterscale은 Cloudflare에서 직접 호스팅하는 간단한 웹 분석 트래커이자 대시보드입니다. Cloudflare Workers와 Workers Analytics Engine을 기반으로 하며, 트래픽이 많아도 운영 비용을 거의 들이지 않는 것을 목표로 합니다.

counterscale은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

counterscale은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

counterscale은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. counterscale의 마지막 커밋은 2026년 10월 4일입니다.

counterscale은(는) 어디에 사용할 수 있나요?

개인 블로그나 프로젝트 사이트에 개인정보 보호에 중점을 둔 셀프 호스팅 트래픽 통계를 추가할 때. 브라우저 스크립트를 사용하지 않는 백엔드 애플리케이션에서 페이지뷰를 추적할 때. Cloudflare 계정에서 여러 웹사이트의 저비용 분석을 운영할 때.

counterscale는 어떻게 설치하나요?

Cloudflare에 로그인하고 Wrangler를 인증합니다: npx wrangler login Counterscale 설치 프로그램을 실행하고 안내에 따릅니다: npx @counterscale/cli@latest install 추적 스크립트 스니펫을 웹사이트 HTML에 추가합니다

counterscale은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/benvinegar/counterscale