본문으로 건너뛰기
오픈소스 전체 목록

Umami

프라이버시 중심 웹·제품 분석 플랫폼. 쿠키 없이 유입·행동·전환을 보고, 직접 호스팅하거나 클라우드로 써요(MIT)

원본:umami-software/umami

요약

프라이버시 중심 웹·제품 분석 플랫폼. 쿠키 없이 유입·행동·전환을 보고, 직접 호스팅하거나 클라우드로 써요(MIT)

설명

Umami 로고

Umami

Umami는 오픈소스 웹·제품 분석 플랫폼입니다. 쿠키 없는 프라이버시 중심 분석으로 유입, 행동, 전환, 재방문을 파악하세요. 직접 호스팅하거나 클라우드로 쓸 수 있습니다.

GitHub 릴리스 MIT 라이선스 빌드 상태 데모 보기


🚀 시작하기

자세한 시작 안내는 umami.is/docs에서 볼 수 있습니다.


🛠 소스에서 설치

요구 사항

  • Node.js 20.19 이상(22 LTS 권장)이 설치된 서버
  • PostgreSQL 데이터베이스 v12.14 이상

소스 코드 받고 패키지 설치

git clone https://github.com/umami-software/umami.git
cd umami
pnpm install

Umami 설정

아래 내용으로 .env 파일을 만듭니다.

DATABASE_URL=connection-url
APP_SECRET=random-string  # generate with: openssl rand -hex 32

연결 URL 형식은 다음과 같습니다.

postgresql://username:mypassword@localhost:5432/mydb

애플리케이션 빌드

pnpm run build

처음 설치하면 빌드 단계에서 데이터베이스에 테이블을 만들고, 사용자 이름 admin, 비밀번호 umami인 로그인 계정도 만듭니다. 로그인한 뒤에는 이 비밀번호를 꼭 바꿔야 합니다.

애플리케이션 시작

pnpm run start

기본적으로 http://localhost:3000에서 애플리케이션이 실행됩니다. 웹 서버에서 프록시로 요청을 넘기거나, 애플리케이션을 직접 서비스하려면 포트를 바꿔야 합니다.

.env 파일에 정한 HOSTNAME과 PORT로 띄우려면 pnpm run start:env로 시작하세요.


🐳 Docker로 설치

Umami는 간편한 배포를 위해 Docker 이미지와 Docker compose 파일을 제공합니다.

Docker 이미지:

docker pull docker.umami.is/umami-software/umami:latest

Docker compose(PostgreSQL 데이터베이스와 함께 Umami 실행):

docker compose up -d

🔄 업데이트하기

최신 기능을 쓰려면 소스를 받고, 새 의존성을 설치한 뒤 다시 빌드하면 됩니다.

git pull
pnpm install
pnpm build

Docker 이미지를 업데이트하려면 새 이미지를 받고 다시 만듭니다.

docker compose pull
docker compose up --force-recreate -d

🛟 지원

GitHub Twitter LinkedIn Discord


저장소: umami-software/umami · 라이선스: MIT

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0