shivamanupadi/traks

어떤 프로젝트인가요?

핵심 기능

• 01매일 교체되는 해시로 쿠키 없이 방문자를 집계하며, 원본 IP는 저장하지 않습니다.
• 02WebSocket을 통해 실시간 방문자, 페이지, 리퍼러와 도시 단위 위치를 확인합니다.
• 03R2의 Apache Iceberg 테이블을 R2 SQL로 쿼리하고 엣지 캐싱을 적용해 과거 데이터를 조회합니다.
• 04설치 마법사를 통해 사용자의 Cloudflare 계정에 원클릭으로 배포합니다.
• 05D1 기반 Better Auth를 통한 이메일 및 비밀번호 인증을 지원합니다.
• 06MCP/WebMCP 도구로 AI 에이전트에 분석 데이터를 제공하고, 봇 트래픽을 분류합니다.

활용 사례

• 쿠키 없이 개인 블로그나 소규모 웹사이트에서 개인정보 보호에 중점을 둔 분석을 운영합니다.
• 방문자 데이터를 자체 Cloudflare 계정에 보관하면서 호스팅 분석 서비스 구독을 대체합니다.
• 제품 출시나 메인 페이지 노출 이벤트에서 실시간 트래픽 급증을 모니터링합니다.
• MCP 도구를 통해 AI 에이전트에 사이트 분석 데이터 읽기 권한을 제공합니다.

빠른 시작

1. 1

   traks.dev/deploy를 열고 Cloudflare로 로그인하세요. 마법사가 모든 항목을 계정에 프로비저닝합니다

2. 2

   저장소 작업에 필요한 종속성을 설치하세요(Node 20 이상 필요)

   yarn install
3. 3

   API용 개발 D1 데이터베이스를 마이그레이션하세요

   yarn workspace @traks/platform-api db:migrate:dev
4. 4

   로컬 개발 서버를 시작하세요

   yarn dev

사용 전 알아둘 점

• !Cloudflare에서만 실행되며, 월 약 5달러의 Workers Paid 플랜을 사용하는 Cloudflare 계정이 필요합니다.
• !플랫폼을 로컬에서 실행하려면 시크릿이 포함된 자체 Doppler 프로젝트와 프로비저닝된 Cloudflare 데이터 플랫폼도 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

traks은(는) 무엇인가요?

데이터 처리 경로에 서드파티 서비스를 거치지 않고, 모든 구성 요소를 자체 Cloudflare 계정에 배포하는 셀프 호스팅 쿠키 없는 웹 분석 도구입니다. Traks는 Workers, Durable Objects, D1, Pipelines, R2 Data Catalog(Apache Iceberg), R2 SQL을 사용해 Cloudflare 데이터 플랫폼에서 처음부터 끝까지 실행되는 웹 분석 플랫폼입니다. 쿠키 대신 매일 교체되는 HMAC 해시로 방문자를 집계하며, 원본 IP 주소는 저장하지 않습니다. 트래커는 단일 script 태그로 삽입하고, 대시보드도 같은 배포 환경에서 제공합니다.

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

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

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

활발히 유지보수 중. traks의 마지막 커밋은 2026년 11월 4일입니다.

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

쿠키 없이 개인 블로그나 소규모 웹사이트에서 개인정보 보호에 중점을 둔 분석을 운영합니다. 방문자 데이터를 자체 Cloudflare 계정에 보관하면서 호스팅 분석 서비스 구독을 대체합니다. 제품 출시나 메인 페이지 노출 이벤트에서 실시간 트래픽 급증을 모니터링합니다. MCP 도구를 통해 AI 에이전트에 사이트 분석 데이터 읽기 권한을 제공합니다.

traks는 어떻게 설치하나요?

traks.dev/deploy를 열고 Cloudflare로 로그인하세요. 마법사가 모든 항목을 계정에 프로비저닝합니다 저장소 작업에 필요한 종속성을 설치하세요(Node 20 이상 필요): yarn install API용 개발 D1 데이터베이스를 마이그레이션하세요: yarn workspace @traks/platform-api db:migrate:dev 로컬 개발 서버를 시작하세요: yarn dev

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

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