aurora

Aurora는 방문자의 기기에 아무것도 저장하지 않고 웹사이트 트래픽을 측정하도록 설계된 오픈 소스 자체 호스팅 웹 분석 애플리케이션입니다. 쿠키, localStorage, 핑거프린팅을 사용하지 않으며, 이벤트 데이터는 운영자가 제어하는 PostgreSQL 데이터베이스에 저장됩니다. 브라우저 추적 스크립트의 전송 크기는 2.4 KB입니다. 방문자는 IP 주소, 사용자 에이전트 및 서버 측 솔트(salt)에서 파생된 회전식 HMAC을 통해 식별됩니다. 해시 입력값이 매일 변경되므로 방문자 ID를 여러 날짜에 걸쳐 연결할 수 없으며, 브라우저를 떠나는 어떤 정보도 개인을 추적할 수 없도록 설계되었습니다. 이러한 접근 방식은 localStorage와 같은 단말 장비에 정보를 저장하는 것이 쿠키와 유사하게 취급된다는 ePrivacy Art. 5(3)와 관련이 있는 것으로 제시됩니다. 대시보드는 선택한 범위와 시간대에 대해 방문 횟수, 고유 방문자 수, 세션, 이탈률 및 평균 세션 지속 시간을 표시합니다. 여기에는 Recharts 시계열 차트와 페이지, 추천인, 유입 채널, 국가, 브라우저, 운영 체제, 기기, 언어 및 UTM 파라미터별 분석이 포함됩니다. 사용자 정의 이벤트는 스칼라 속성과 ISO-4217 통화 기준의 수익 값을 가질 수 있습니다. 사이트를 공개로 설정하면 로그인 없이 읽기 전용 분석 대시보드를 노출할 수 있습니다. 배포는 linux/amd64 및 linux/arm64용으로 게시된 Docker 이미지를 통해 가능합니다. 필수 설정에는 DATABASE_URL 및 SESSION_SECRET이 포함되며, 운영 환경에서는 AURORA_SALT가 필요합니다. 신뢰할 수 있는 프록시 홉이 클라이언트 IP 데이터를 결정할 수 있도록 AURORA_IP_HEADER 설정을 강력히 권장합니다. 설정하지 않은 경우 애플리케이션은 경고를 표시하고 클라이언트가 설정할 수 있는 헤더로 대체합니다. AURORA_COUNTRY_HEADER는 엣지에서 국가 코드를 가져오기 위한 선택 사항입니다. 사이트를 추적하려면 대시보드에서 사이트 ID가 포함된 스크립트 태그를 제공합니다. 페이지 뷰와 클라이언트 측 경로 변경은 자동으로 추적됩니다. 사용자 정의 이벤트는 전역 aurora 함수를 호출하며, 이 함수는 스크립트가 로드되기 전에 이루어진 호출을 큐에 저장합니다. 속성은 스칼라 값만 허용하며 최대 24개의 키까지 가능합니다. 개발에는 Node 20+ 및 pnpm 10이 필요합니다. 이 프로젝트는 React Router 웹 애플리케이션과 제공되는 스크립트로 번들링된 트래커 패키지가 포함된 pnpm 워크스페이스입니다. PostgreSQL 기반의 Drizzle, Tailwind CSS와 shadcn/ui, Recharts, Vitest, oxlint/oxfmt를 사용합니다. 커밋은 Conventional Commits를 따르고, 릴리스는 release-please로 자동화되며, 버전 관리는 SemVer를 따릅니다. Aurora 4는 처음부터 다시 작성된 버전으로, 1.x 또는 2.x 버전에서의 마이그레이션 경로는 제공되지 않습니다. 이 프로젝트는 MIT 라이선스입니다.