Umami – 개인정보 보호를 우선하는 오픈 소스 웹사이트 분석 도구
Umami란 무엇인가요?
Umami는 간단하고 빠르며, 개인정보 보호에 중점을 둔 웹사이트 분석 도구입니다. Google Analytics의 경량화된 오픈 소스 대안으로, 웹사이트 소유자가 데이터를 완전히 통제할 수 있게 하며, 방문자의 개인 정보를 수집하지 않아 GDPR/CCPA와 같은 개인정보 보호 규정을 준수합니다.
왜 Umami를 선택해야 하나요?
- 개인정보 보호 우선: 쿠키를 사용하지 않으며, 개별 사용자를 추적하지 않습니다; 데이터는 전적으로 여러분의 손에 있습니다.
- 오픈 소스 및 자체 호스팅: 무료로 사용할 수 있으며, 폐쇄된 소스의 블랙박스가 없습니다. 커뮤니티에 의해 지속적으로 최적화되며, 직접 배포하거나 공식 클라우드 서비스를 사용할 수 있습니다.
- 간결한 인터페이스: 실시간 통계, 페이지 트래픽, 장치/언어/지역 데이터를 제공하며, 직관적이고 사용하기 쉽습니다.
- 빠른 배포: Docker 및 수동 설치를 지원하며, PostgreSQL/MySQL/MariaDB와 같은 일반적인 데이터베이스와 호환됩니다.
Umami의 핵심 기능
- 실시간 페이지 방문 통계: 페이지 뷰, 고유 방문자, 출처, 장치 유형 등을 포함합니다.
- 맞춤 이벤트 추적: 버튼 클릭, 폼 제출 등의 상호 작용 이벤트를 추적합니다.
- 방문자 행동 분석: 세션, 유지율, 전환 경로 등의 추세 비교 분석을 제공합니다.
- UTM 및 채널 통계: UTM 매개변수 추적을 지원하며, 광고 캠페인 성능을 그룹별로 모니터링할 수 있습니다.
- 다중 사용자 및 다중 사이트 관리: 팀 권한 설정, 여러 사이트 관리, CSV 내보내기를 지원합니다.
Umami 설치 및 시작 방법
1. 빠른 배포 (Docker 권장)
Docker와 Docker Compose가 설치되어 있는지 확인한 후, docker-compose.yml 파일을 생성합니다:
version: '3'
services:
umami:
image: ghcr.io/umami-software/umami:postgresql-latest
ports:
- '3000:3000'
environment:
DATABASE_URL: postgresql://umami:password@db:5432/umami
DATABASE_TYPE: postgresql
APP_SECRET: 랜덤 문자열
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: umami
POSTGRES_USER: umami
POSTGRES_PASSWORD: password
volumes:
- umami-db-data:/var/lib/postgresql/data
volumes:
umami-db-data:
실행:
docker compose up -d
http://localhost:3000에 접속하여 기본 admin 계정으로 로그인합니다.
2. 로컬 설치 (Node.js 방식)
-
코드 클론:
git clone https://github.com/umami-software/umami.git cd umami npm install -
환경 변수 설정:
.env파일에서DATABASE_URL=postgresql://...또는mysql://...을 설정합니다. -
애플리케이션 빌드 및 실행:
npm run build npm run start
로그인 주소는 일반적으로 http://localhost:3000입니다.
사용 팁
- 클라우드에 배포: 공식 클라우드 및 Render, Elestio와 같은 제3자 플랫폼에서 원클릭 배포를 지원합니다.
- 추적 코드 추가:
<head>에<script defer src="…/script.js" data-website-id="…">를 삽입하면 페이지 데이터 수집을 시작할 수 있습니다 ([dev.to][5]). - 이벤트 상호 작용 추적: JS 호출
umami.track('button_click')을 사용하여 특정 상호 작용 이벤트를 추적할 수 있습니다. - 다중 사이트 관리: 대시보드에서 여러 사이트를 추가할 수 있으며, 여러 프로젝트를 관리하는 데 적합합니다.
