시작하기
전체 VPS 앱
분석

Umami: 내 서버에서 운영하는 웹사이트 분석

방문자 수, 페이지, 유입 경로, 국가를 한눈에 보이는 대시보드에서 확인합니다. 데이터는 쿠키 없이 수집되어 내 서버에 저장됩니다.

Umami 서버 주문 VPS 요금제 보기

Umami 소개

Umami는 MIT 라이선스로 배포되는 오픈소스 웹 분석 도구입니다. 방문자 수, 많이 읽힌 페이지, 유입 경로, 사용 기기처럼 사이트 운영자가 실제로 궁금해하는 내용을 수십 개의 보고서가 아닌 한 페이지에서 보여 줍니다.

추적 스크립트는 가볍고 쿠키를 설정하거나 개인정보를 수집하지 않습니다. 그래서 많은 사이트가 쿠키 동의 배너 없이 Umami를 사용하지만, 이것이 적용되는지는 해당 지역의 법률에 따라 다릅니다. 사용자 지정 이벤트, UTM 캠페인, 공유 가능한 공개 대시보드, 설치 하나로 여러 웹사이트 관리도 지원합니다.

Umami는 작은 서버에서도 돌아갈 만큼 가볍고, 방문 데이터가 광고 회사가 아닌 자체 데이터베이스에 남기 때문에 직접 호스팅하는 경우가 많습니다. 개발자들은 본격적인 마케팅 도구가 과한 개인 프로젝트나 고객 사이트에 즐겨 사용합니다.

주요 활용 사례

여러 소규모 사이트 분석

모든 프로젝트와 고객 사이트를 하나의 Umami에 추가하고 대시보드에서 전환하며 확인하세요.

버튼 클릭과 회원가입 추적

페이지에서 사용자 지정 이벤트를 보내 핵심 행동을 완료한 방문자 수를 확인하세요.

공개 통계 페이지

계정을 만들어 주지 않고도 고객이나 커뮤니티에 읽기 전용 대시보드 링크를 공유하세요.

주문 후

서버를 처음 시작하면 Umami가 설치되어 http://서버-주소:3000/에서 열립니다(방화벽에서 3000번 포트가 허용됩니다). Rivervo 패널에 표시된 사용자 이름과 비밀번호로 로그인하고, 웹사이트를 추가한 뒤 제공되는 추적 코드를 사이트 페이지에 넣으세요.

Umami에 내 도메인과 HTTPS 연결하기

기본 상태의 Umami는 서버 IP 주소에서 일반 HTTP로 응답합니다. stats.example.com 같은 이름과 인증서를 사용하려면 DNS에서 해당 이름의 A 레코드를 서버의 IPv4 주소로 지정한 다음, 앞단에 Caddy를 두세요. Caddy는 무료 Let's Encrypt 인증서를 자동으로 발급하고 갱신합니다. 아래 명령은 애플리케이션 서버에서 사용하는 Ubuntu 24.04 기준입니다.

패널에서 서버 방화벽의 TCP 80, 443 포트를 여세요. Caddy가 Let's Encrypt 인증서를 발급받고 사이트를 제공하는 데 필요합니다.

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
stats.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddy

이 설정은 다른 앱보다 Umami에서 특히 중요합니다. 추적 스크립트는 웹사이트에서 불러오는데, HTTPS 사이트는 일반 HTTP 주소의 스크립트를 불러오지 않습니다. 도메인이 작동하면 Umami의 웹사이트 설정에서 추적 코드를 다시 가져오세요. 이때 코드는 https://stats.example.com/script.js를 가리키며, 이 코드로 사이트의 기존 코드를 교체하세요.

도메인이 작동하면 3000번 포트를 직접 열어 둘 필요가 없습니다. /opt/umami/compose.yml에서 "3000:…"을 "127.0.0.1:3000:…"으로 바꾸고 docker compose up -d를 실행한 뒤 방화벽에서 3000번 포트를 제거하세요. 이후 Umami는 HTTPS로만 접속할 수 있습니다.

Umami 업데이트

/opt/umami/compose.yml의 이미지는 정확한 버전으로 고정되어 있어 docker compose pull만 실행하면 같은 버전을 다시 받습니다. 업데이트하려면 image: 줄의 버전을 원하는 버전으로 바꾸고(먼저 릴리스 노트를 확인하세요) 이미지를 받은 뒤 컨테이너를 다시 만드세요. 데이터는 Docker 볼륨에 있으므로 그대로 유지됩니다.

cd /opt/umami
nano compose.yml        # the new version in the image: line
docker compose pull
docker compose up -d

Umami 백업

패널에서 서버 전체의 매일 백업을 켤 수 있으며(요금제 가격의 +20%, 최근 7개 사본 보관), 그중 어느 사본에서든 서버를 복원할 수 있습니다. 그래도 앱 데이터를 파일로 따로 복사해 두는 것이 좋습니다. 다른 서버로 옮기거나 나머지를 모두 되돌리지 않고 복원할 수 있기 때문입니다.

웹사이트, 사용자, 기록된 모든 방문 등 Umami의 모든 데이터는 PostgreSQL 데이터베이스에 있으므로 데이터베이스 덤프만으로 완전한 백업이 됩니다.

cd /opt/umami
docker compose exec -T db pg_dump -U umami umami > /root/umami-$(date +%F).sql

진행 방식

  1. 서버 주문 페이지에서 Umami을(를) 고르고, 메모리가 충분한 요금제를 선택하세요.
  2. 앱은 서버의 첫 시작 때 설치되며, 보통 몇 분이면 끝납니다.
  3. 패널에서 서버를 열면 주소와 로그인 정보가 있습니다.

Umami 관련 질문

네. Umami는 카탈로그에서 가장 가벼운 앱 중 하나입니다. 최소 사양은 메모리 1GB, 디스크 20GB이며, 트래픽이 일반적인 사이트 여러 개를 운영하기에 충분합니다.
브라우저는 HTTPS 페이지에서 HTTP 스크립트를 차단하므로, 운영 중인 사이트라면 Umami에 인증서가 있는 별도 도메인이나 서브도메인을 연결하세요. 이 도메인과 3000번 포트 앞단의 리버스 프록시는 직접 설정합니다.
네. Umami는 Node.js 애플리케이션이며 x86뿐 아니라 ARM 요금제에서도 실행됩니다.
Umami 문서에 따르면 Umami는 쿠키를 설정하지 않고 개인정보를 수집하지 않으므로 많은 사이트가 동의 배너 없이 사용합니다. 배너가 필요한지는 사이트에 적용되는 개인정보 보호법에 따라 결정됩니다.
네. Umami 설정에서 사이트를 각각 추가하고 사이트마다 해당 추적 코드를 넣으세요. 하나의 서버에 모든 사이트의 통계가 저장됩니다.